org.xml.sax.ext
인터페이스 Locator2

모든 슈퍼 인터페이스:

Locator

알려진 구현 클래스 목록:

Locator2Impl

public interface Locator2
extends Locator 

SAX2 확장은 Locator를 통해 제공되는 엔티티 정보를 늘립니다. 구현이 이 확장을 지원 하고 있는 경우, ContentHandler.setDocumentLocator() 로 제공되는 locator는 이 인터페이스를 구현해, 「http://xml.org/sax/features/use-locator2」기능 플래그는 값 「true」를 가집니다.

이 모듈은 원시 코드, 문서 모두 공개 도메인에 놓여져 있습니다. 따라서, 내용에 관한보증은 일절 제공되지 않습니다.

XMLReader 구현은 이 정보의 지원에 필요 없습니다. 이것은 SAX2 코어 디스트리뷰션인 만큼 포함되는 것이 아닙니다.

도입된 버전 :

SAX 2.0 (extensions 1.1 alpha)

메서드 개요

String	getEncoding () 엔티티의 문자 인코딩의 이름을 리턴합니다.
String	getXMLVersion () 엔티티에 사용되는 XML 버전을 리턴합니다.

인터페이스 org.xml.sax. Locator 로부터 상속된 메서드

getColumnNumber, getLineNumber, getPublicId, getSystemId

메서드의 상세

getXMLVersion

String  getXMLVersion()

엔티티에 사용되는 XML 버전을 리턴합니다. 보통, 이것은 현재의 엔티티의 「<? xml version='...' ...?>」선언으로부터의 식별자가 되는지, 파서에 의해 디폴트로 설정됩니다.

반환값:

엔티티의 텍스트 해석에 사용되고 있는 XML 버전의 식별자. 그 정보가 현재의 구문 분석 상태에서는 아직 사용할 수 없는 경우는 null

getEncoding

String  getEncoding()

엔티티의 문자 인코딩의 이름을 리턴합니다. 인코딩이 외부 (예를 들어 MIME Content-Type 헤더)에서 선언되었을 경우는 리턴된 이름이 됩니다. 혹은 문서의 개시 위치에서 「<? xml ...encoding='...'? >」선언이 있었을 경우, 그 인코딩명이 리턴됩니다 . 그렇지 않은 경우는 인코딩은 추정되는지 (일반적으로 UTF-8 또는 일부가 UTF-16 변형이 된다), 추정된 이름이 리턴됩니다 .

InputSource를 사용해 엔티티의 문자 스트림을 제공하는 경우, 이 메서드는 그 입력 스트림로 제공된 인코딩을 리턴합니다.

최근의 W3C 사양에서는 「Unicode Normalization Form C」를 사용해, 일부 인코딩을 하고 있는 텍스트를 처리하기 전에 정규화할 필요가 있습니다. 이러한 정규화는 어플리케이션으로 실행하지 않으면 안되어, 일반적으로 이 메서드에 의해 리턴된 값에 근거해 트리거 됩니다.

인코딩명은 배후의 JVM 로 사용되고 있어서, 비교하려면 대문자와 소문자를 구별할 필요가 있습니다.

반환값:

* 엔티티의 텍스트 해석에 사용되고 있는 문자 인코딩의 이름. InputSource를 통해 건네받은 * 문자 스트림에 제공되지 않았던 경우, 혹은 현재의 해석 상태에서는 아직 사용할 수 없는 경우는 null