org.w3c.dom.ls
인터페이스 LSResourceResolver

public interface LSResourceResolver

LSResourceResolver를 사용하면, 어플리케이션은 외부 자원에 대한 참조를 리다이렉트 할 수 있습니다.

외부 자원의 커스텀 처리를 구현할 필요가 있는 어플리케이션은 이 인터페이스를 구현해, LSParser와 LSSerializer에 접속된 DOMConfiguration 객체의 「resource-resolver」파라미터를 설정하는 것에 의해 구현을 등록할 수 있습니다. 또, 「LS」기능이 지원 되고 있는 경우는 Document에 접속된 DOMConfiguration 객체에의 등록도 가능합니다.

그 후, LSParser에 의해 어플리케이션은 외부 엔티티 (외부 DTD 부분집합, 외부 파라메이타엔티티를 포함한다)를 수중에 넣기 전에 차단할 수 있습니다. 톱 레벨의 문서 엔티티는 resolveResource 메서드에는 건네받지 않습니다.

이 인터페이스를 구현할 필요가 있는 DOM 어플리케이션은 그다지 없습니다만, 이 인터페이스는 데이타베이스나 그 외의 특수한 입력 소스로부터 XML 문서를 구축하는 것 같은 어플리케이션, 혹은 URN를 사용하는 어플리케이션에서는 매우 유효합니다.

주: LSResourceResolver는 SAX2「SAX」 EntityResolver인터페이스에 근거하고 있습니다.

「Document Object Model (DOM) Level 3 Load and Save Specification」도 참조하십시오.

메서드 개요

LSInput

resolveResource (String type, String namespaceURI, String publicId, String systemId, String baseURI) 어플리케이션이 외부 자원을 해결할 수 있도록 합니다.

메서드의 상세

resolveResource

LSInput  resolveResource(String  type,
                        String  namespaceURI,
                        String  publicId,
                        String  systemId,
                        String  baseURI)

어플리케이션이 외부 자원을 해결할 수 있도록 합니다.
LSParser는 외부 자원 (외부 DTD 부분집합, DTD 내에서 참조되는 외부 엔티티 및 문서 요소내에서 참조되는 외부 엔티티등)을 열기 전에 이 메서드를 호출합니다. 다만, 톱 레벨의 문서 엔티티는 이 메서드에는 건네받지 않습니다. 그 후, 어플리케이션은, LSParser가 외부 자원 자체를 해결하는 것이나, 대체 URI를 사용하는 것, 또는 완전히 다른 입력 소스를 사용하는 것을 요구합니다.
어플리케이션 작자는 이 메서드를 사용해 외부 시스템 식별자를 안전한 로컬 URI에 리다이렉트 하거나 카탈로그내의 공개 식별자를 검색하거나 데이타베이스나 그 외의 입력 소스 (예를 들어 다이알로그 박스등)로부터 엔티티를 읽어내거나 할 수 있습니다.

파라미터:

type - 해결되는 자원의 형태. XML「XML 1.0」자원 (엔티티등)의 경우, 어플리케이션은, 「http://www.w3.org/TR/REC-xml」치를 사용할 필요가 있어, XML schema「XML Schema Part 1」의 경우는 「http://www.w3.org/2001/XMLSchema」의 값을 사용할 필요가 있다. 다른 자원의 형태는 이 사양의 범위외. 따라서, 이 메서드를 사용하려면, 절대 URI를 추천 하는

namespaceURI - 해결되는 자원의 이름 공간. XML schema 자원을 해결하고 있을 때는 XML schema「XML Schema Part 1」의 타겟 이름 공간

publicId - 참조되는 외부 엔티티의 공개 식별자. 공개 식별자가 제공되지 않았던 경우나 자원이 엔티티가 아닌 경우는 null

systemId - 참조되는 외부 자원의 시스템 식별자 (URI 참조「IETF RFC 2396」). 시스템 식별자가 제공되지 않았던 경우는 null

baseURI - 해석되는 자원의 절대 베이스 URI. 베이스 URI가 없는 경우는 null

반환값:

새로운 입력 소스를 기술하는 LSInput 객체. 파서에 자원에의 정규 URI 접속을 요구하는 경우는 null