Locator
Locator (SAX 이벤트와 문서 위치 연결)
SAX 이벤트를 문서 위치와 연결하기 위한 인터페이스예요.
본문
SAX 파서가 SAX 애플리케이션에 위치 정보를 제공하면, 이 인터페이스를 구현하고 콘텐츠 핸들러의 setDocumentLocator 메서드를 사용해 인스턴스를 애플리케이션에 전달해요. 애플리케이션은 이 객체를 사용해 XML 원본 문서에서 다른 SAX 이벤트의 위치를 얻을 수 있어요.
객체가 반환하는 결과는 각 콜백 메서드의 범위 안에서만 유효해요. 애플리케이션이 다른 시점이나 파싱 완료 후에 로케이터를 사용하려 하면 예측할 수 없는 결과를 받게 돼요.
SAX 파서가 로케이터를 제공할 필요는 없지만, 파서가 문서 위치 정보를 제공할 수 있다면 로케이터를 제공하는 것이 좋아요. 응용 프로그램이 위치 정보를 사용해 오류의 줄 번호/열 번호를 보고하는 데 유용해요.
getPublicId()는 공개 식별자를, getSystemId()는 시스템 식별자를, getLineNumber()는 현재 이벤트의 줄 번호를, getColumnNumber()는 현재 이벤트의 열 번호를 반환해요.