org.xml.sax
인터페이스 Locator

기존의 구현 클래스의 일람:

LocatorImpl

public interface Locator

SAX 이벤트와 문서의 위치를 관련짓기 위한 인터페이스입니다.

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

SAX 파서는 이 인터페이스를 구현해, 컨텐츠 핸들러의 setDocumentLocator 메소드를 사용해 인스턴스를 건네주는 것으로, SAX 어플리케이션에 위치 정보를 제공합니다. SAX 어플리케이션은 이 오브젝트를 사용해 XML 소스 문서내의 그 외의 컨텐츠 핸들러 이벤트의 위치를 밝혀낼 수가 있습니다.

오브젝트에 의해 돌려주어지는 결과는 각 컨텐츠 핸들러 메소드의 스코프내에서만 유효합니다. 이 스코프외에서 locator를 사용하려고 하면(자), 어플리케이션에 예상외의 영향이 미칩니다.

SAX 파서에 locator를 제공시키는 것은 필수 조건이 아닙니다만, 그래 하는 것을 강하게 추천합니다. 이 경우, SAX 파서는 그 외의 문서 이벤트를 보고하기 전에 locator를 제공할 필요가 있습니다. 어플리케이션이 startDocument 이벤트를 받기 전에 locator를 설정해 두지 않으면 어플리케이션은 locator를 이용할 수 없다고 판단합니다.

@since SAX 1.0

관련 항목:

ContentHandler.setDocumentLocator(org.xml.sax.Locator)

메소드의 개요

int	getColumnNumber () 현재의 문서 이벤트가 종료하는 열번호를 돌려줍니다.
int	getLineNumber () 현재의 문서 이벤트가 종료하는 행 번호를 돌려줍니다.
String	getPublicId () 현재의 문서 이벤트의 공개 식별자를 돌려줍니다.
String	getSystemId () 현재의 문서 이벤트의 시스템 식별자를 돌려줍니다.

메소드의 상세

getPublicId

public String  getPublicId()

현재의 문서 이벤트의 공개 식별자를 돌려줍니다.

반환값은 문서 엔티티의 공개 식별자인가, 이벤트를 방아쇠 하는 마크 업을 포함한 외부의 구문 분석이 끝난 엔티티의 공개 식별자입니다.

반환값:

공개 식별자를 포함한 캐릭터 라인. 사용할 수 없는 경우는 null

관련 항목:

getSystemId()

getSystemId

public String  getSystemId()

현재의 문서 이벤트의 시스템 식별자를 돌려줍니다.

반환값은 문서 엔티티의 시스템 식별자인가, 이벤트를 방아쇠 하는 마크 업을 포함한 외부의 구문 분석이 끝난 엔티티의 시스템 식별자입니다.

시스템 식별자가 URL 의 경우, 파서는 이것을 어플리케이션에 건네주기 전에 완전하게 해결할 필요가 있습니다.

반환값:

시스템 식별자를 포함한 캐릭터 라인. 사용할 수 없는 경우는 null

관련 항목:

getPublicId()

getLineNumber

public int getLineNumber()

현재의 문서 이벤트가 종료하는 행 번호를 돌려줍니다.

경고: 이 메소드의 반환값은 에러 보고로 사용되는 근사치에 지나지 않습니다. 이 정보는 원의 XML 문서의 캐릭터 컨텐츠를 편집하기에는 불충분합니다.

반환값은 문서 엔티티의 행 번호의 근사치인가, 이벤트를 방아쇠 하는 마크 업을 포함한 외부의 구문 분석이 끝난 엔티티의 행 번호의 근사치입니다.

SAX 드라이버는 문서 이벤트에 관련지을 수 있었던 텍스트의 직후에 있는 최초의 캐릭터를 포함한 행의 위치를 돌려주려고 합니다. 덧붙여 1 행 째는 문서의 선두행입니다.

반환값:

행 번호. 사용할 수 없는 경우는 -1

관련 항목:

getColumnNumber()

getColumnNumber

public int getColumnNumber()

현재의 문서 이벤트가 종료하는 열번호를 돌려줍니다.

경고: 이 메소드의 반환값은 에러 보고로 사용되는 근사치에 지나지 않습니다. 이 정보는 원의 XML 문서의 캐릭터 컨텐츠를 편집하기에는 불충분합니다.

반환값은 문서 엔티티의 열번호의 근사치인가, 이벤트를 방아쇠 하는 마크 업을 포함한 외부의 구문 분석이 끝난 엔티티의 열번호의 근사치입니다.

SAX 드라이버는 문서 이벤트에 관련지을 수 있었던 텍스트의 직후에 있는 최초의 캐릭터를 포함한 행의 위치를 돌려주려고 합니다. 덧붙여 각 행의 최초의 열이 1 번째가 됩니다.

반환값:

열번호. 사용할 수 없는 경우는 -1

관련 항목:

getLineNumber()