org.xml.sax.helpers
클래스 NamespaceSupport

java.lang.Object 
  org.xml.sax.helpers.NamespaceSupport

public class NamespaceSupport
extends Object 

SAX를 사용하는 어플리케이션에 하고, 또 내부적으로는 SAX 드라이버에 의해 사용하는 이름 공간 논리를 캡슐화합니다.

이 모듈은 원시 코드, 문서 모두 공개 도메인에 놓여져 있습니다. 따라서, 내용에 관한보증은 일절 제공되지 않습니다. 자세한 것은, http://www.saxproject.org 를 참조하십시오.

이 클래스는 이름 공간 처리의 논리를 캡슐화합니다. 이 클래스를 사용해, 각 컨텍스트 으로 현재 유효한 선언을 추적해, XML 수식명으로부터 자동적으로 이름 공간 부분을 생성할 수 있습니다. 이름 공간을 생성원의 XML qname에 되돌릴 수도 있습니다.

이름 공간 지원 객체는 재이용 가능하지만, 다음의 세션까지의 사이에 reset 메서드를 호출할 필요가 있습니다.

다음에 단순한 세션의 예를 나타냅니다.

String parts[] = new String[3];
NamespaceSupport support = new NamespaceSupport();

support.pushContext();
support.declarePrefix("", "http://www.w3.org/1999/xhtml");
support.declarePrefix("dc", "http://www.purl.org/dc#");

parts = support.processName("p", parts, false);
System.out.println("Namespace URI: " + parts[0]);
System.out.println("Local name: " + parts[1]);
System.out.println("Raw name: " + parts[2]);

parts = support.processName("dc:title", parts, false);
System.out.println("Namespace URI: " + parts[0]);
System.out.println("Local name: " + parts[1]);
System.out.println("Raw name: " + parts[2]);

support.popContext();
 

이 클래스는 이름 공간 선언을 포함한 요소가 거의 없는 것을 상정해 최적화되고 있습니다. 따라서, 모든 컨텍스트 으로 동일한 접두사와 URI 매핑이 반복해지는 것 같은 경우는 효율이 낮아질 가능성이 있습니다.

SAX 드라이버 (파서)는 이 클래스를 선택해 이름 공간 처리를 구현하는 경우가 있습니다만, 이것은 요구되지 않습니다. 어플리케이션이 이름 공간 정보를 사용하는 경우는 어플리케이션 자체가 이름 공간 정보를 추적할 필요가 있습니다.

도입된 버전 :

SAX 2.0

필드 개요

static String	NSDECL 정수로서의 이름 공간 선언 URI를 나타냅니다.
static String	XMLNS 정수로 XML 이름 공간 URI를 나타냅니다.

생성자 개요

NamespaceSupport ()
새로운 이름 공간 지원 객체를 작성합니다.

메서드 개요

boolean	declarePrefix (String prefix, String uri) 이름 공간 접두사를 선언합니다.
Enumeration	getDeclaredPrefixes () 이 컨텍스트 내에 선언 떠날 수 있어 모든 접두사의 열거를 리턴합니다.
String	getPrefix (String uri) 이름 공간 URI에 매핑 되고 있는 접두사를 1개 리턴합니다.
Enumeration	getPrefixes () 현재의 컨텍스트 내에서 선언이 활성화된, 모든 접두사의 열거를 리턴합니다.
Enumeration	getPrefixes (String uri) 현재의 컨텍스트 내에서 선언이 활성화 되어 있는 지정된 URI 모든 접두사의 열거를 리턴합니다.
String	getURI (String prefix) 접두사를 검색해, 현재 매핑 되고 있는 이름 공간 URI를 취득합니다.
boolean	isNamespaceDeclUris () 이름 공간 선언의 속성이 이름 공간에 배치되었을 경우는 true를 리턴합니다.
void	popContext () 이전의 이름 공간 컨텍스트에 되돌립니다.
String []	processName (String qName, String [] parts, boolean isAttribute) 현재의 컨텍스트 내의 모든 선언이 declarePrefix() 에 의해 처리된뒤 raw XML 수식명을 처리합니다.
void	pushContext () 새로운 이름 공간 컨텍스트를 개시합니다.
void	reset () 이 이름 공간 지원 객체를 재이용하기 위해, 리셋 합니다.
void	setNamespaceDeclUris (boolean value) 이름 공간 선언의 속성이 processName() 에 의해 NSDECL 이름 공간에 배치될지 어떨지를 제어합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

XMLNS

public static final String  XMLNS

정수로 XML 이름 공간 URI를 나타냅니다. 「Namespaces in XML*」권고로 정의되고 있는 값은 http://www.w3.org/XML/1998/namespace 입니다.

이것은 「xml」접두사에 자동적으로 매핑 되는 이름 공간 URI 입니다.

관련 항목:

정수 필드값

NSDECL

public static final String  NSDECL

정수로서의 이름 공간 선언 URI를 나타냅니다. 「Namespaces in XML」권고에 대해서 하위 호환성이 없는 정오표로 정의되고 있는 값은 http://www.w3.org/xmlns/2000/ 입니다. 이 정오표는 SAX2 이후의 것이므로 SAX2는 원의 권고에는 디폴트로 설정해, 일반적으로 이 URI는 사용하지 않습니다.

이것은 「xmlns」속성과 「xmlns:*」속성에 옵션으로 적용되는 이름 공간 URI 입니다. 이름 공간 선언에 사용합니다.

도입된 버전 :

SAX 2.1alpha

관련 항목:

setNamespaceDeclUris(boolean), isNamespaceDeclUris(), 정수 필드값

생성자 상세

NamespaceSupport

public NamespaceSupport()

새로운 이름 공간 지원 객체를 작성합니다.

메서드의 상세

reset

public void reset()

이 이름 공간 지원 객체를 재이용하기 위해, 리셋 합니다.

이름 공간 지원 객체를 새로운 세션으로 재이용하기 전에 이 메서드를 호출할 필요가 있습니다. 이름 공간 선언 URI를 지원하는인 경우는 그 플래그도 디폴트 이외의 값으로 설정할 필요가 있습니다.

관련 항목:

setNamespaceDeclUris(boolean)

pushContext

public void pushContext()

새로운 이름 공간 컨텍스트를 개시합니다. 새로운 컨텍스트은 친컨텍스트 의 선언을 자동적으로 상속합니다만, 이 컨텍스트 내에서 작성된 선언도 계속해 추적합니다.

이벤트 콜백 코드는 요소 마다 한 번만 새로운 컨텍스트를 개시할 필요가 있습니다. 즉, 2개 소중 어느 쪽인지로 이것을 호출할 준비를 합니다. 이름 공간 선언을 포함하지 않는 요소의 경우, 「ContentHandler.startElement()」콜백이 올바른 장소입니다. 이러한 선언을 가지는 요소의 경우, 최초의 「ContentHandler.startPrefixMapping()」콜백으로 행해집니다. 컨텍스트이 이미 개시되었는지 어떠했는지는 boolean 플래그를 사용해 추적할 수 있습니다. 메서드의 어느 쪽인지가 불려 갔을 경우, 플래그를 체크해, 새로운 컨텍스트를 개시할 필요가 있을지 어떨지를 봅니다. 개시할 필요가 있는 경우는 컨텍스트를 개시해 플래그를 설정합니다. 「ContentHandler.startElement()」는 이것을 실시한 뒤 반드시 플래그를 클리어 합니다.

보통, SAX 드라이버는 새로운 컨텍스트를 각 XML 요소의 선두에 푸쉬 합니다. 그리고, 최초로 속성의 패스를 실행해 모든 이름 공간 선언을 처리해, 「ContentHandler.startPrefixMapping()」콜백을 실시합니다. 다음에 2번째의 패스로 모든 속성 및 요소명의 이름 공간 수식명을 결정합니다. 이것에 의해 「ContentHandler.startElement()」콜백의 모든 정보를 사용할 수 있어 실행 가능하게 됩니다.

이름 공간 지원 객체는 이미 유효하게 되어 있는 베이스 컨텍스트 으로 개시합니다. 이 컨텍스트에 선언되고 있는 것은 「xml」접두사 뿐입니다.

관련 항목:

ContentHandler, popContext()

popContext

public void popContext()

이전의 이름 공간 컨텍스트에 되돌립니다.

일반적으로 각 XML 요소의 끝나에 컨텍스트를 팝 할 필요가 있습니다. 컨텍스트를 팝 하면, 이전에 유효했던 모든 이름 공간 접두사 매핑이 복원됩니다.

컨텍스트를 팝 한뒤 새롭게 이름 공간 접두사를 선언할 필요가 있는 경우는 그 전에 반드시 다른 컨텍스트를 푸쉬의해 주세요.

관련 항목:

pushContext()

declarePrefix

public boolean declarePrefix(String  prefix,
                             String  uri)

이름 공간 접두사를 선언합니다. 모든 접두사는 참조되기 전에 선언될 필요가 있습니다. 예를 들어 SAX 드라이버 (파서)는 2 살의 패스의 요소의 속성을 스캔 합니다. 최초의 패스는 이름 공간 선언의 패스로 이제(이미 ) 1개는 processName()를 사용해, 재정의될 가능성이 있는 접두사에 대해서 접두사를 해석하는 패스입니다.

이 메서드는 현재의 이름 공간 컨텍스트 내에 접두사를 선언합니다. 이 접두사는 하위 컨텍스트 으로 그림자화 되지 않는 한, 현재의 컨텍스트이 팝 될 때까지 유효합니다.

디폴트에 한 요소의 이름 공간을 선언하려면, 공문자열을 접두사로서 사용합니다.

다른 이름 공간 컨텍스트를 푸쉬의해 팝 한 뒤나, 수식명을 처리해 선언의 단계를 종료했다고 간주라고 접두사를 선언할 수 없습니다.

이 라이브러리에는 비대칭성이 있습니다. 디폴트에 한 요소의 이름 공간을 선언해도, getPrefix 는 접두사 ""를 돌려주지 않습니다. 디폴트의 이름 공간을 확인할 필요가 있는 경우는 getURI를 사용해 명시적으로 검색을 실시해 주세요. 이 비대칭성에의해 디폴트의 접두사를 사용할 수 없는 환경에서도, 속성명으로부터 접두사를 검색하기 쉬워지고 있습니다.

파라미터:

prefix - 선언하는 접두사, 또는 디폴트에 한 요소의 이름 공간을 나타내는 공문자열. 값 「xml」또는 「xmlns」를 가지지 않는 경우가 있는

uri - 접두사에 관련짓는 이름 공간 URI

반환값:

접두사가 정당한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

processName(java.lang.String, java.lang.String[], boolean), getURI(java.lang.String), getPrefix(java.lang.String)

processName

public String [] processName(String  qName,
                            String [] parts,
                            boolean isAttribute)

현재의 컨텍스트 내의 모든 선언이 declarePrefix() 에 의해 처리된뒤 raw XML 수식명을 처리합니다.

이 메서드는 접두사를 삭제해, 그것을 현재 선언되고 있는 접두사내에서 검색하는 것에 의해 현재의 컨텍스트 내에서 raw XML 수식명을 처리합니다. 반환값은 호출해 옆으로부터 제공된 배열이 되어, 다음과 같이 할당할 수 있습니다.

배열내의 모든 캐릭터 라인이 내부화 됩니다. raw 명에 아직 선언되어 있지 않은 접두사가 포함되어 있는 경우, 반환값은 null이 됩니다.

속성명의 처리 방법은 요소명의 처리 방법과는 다릅니다. 접두사를 가지지 않는 요소명이 디폴트의 이름 공간 (존재하는 경우)을 받는데 대해, 접두사를 가지지 않는 속성명은 이것을 받지 않습니다.

파라미터:

qName - 처리되는 XML 수식명

parts - 호출원이 지정한 배열 (3 개 이상의 멤버를 포함할 수 있다)

isAttribute - 속성명 (true)일까 요소명 (false)인지를 나타내는 플래그

반환값:

이름 공간 URI 또는 공문자열, 로컬명 및 XML 수식명을 나타내는 3개의 내부화 된 캐릭터 라인이 포함된 소정의 배열. 미선언의 접두사가 있는 경우는 null

관련 항목:

declarePrefix(java.lang.String, java.lang.String),

getURI

public String  getURI(String  prefix)

접두사를 검색해, 현재 매핑 되고 있는 이름 공간 URI를 취득합니다.

이 메서드는 현재의 컨텍스트 내에서 접두사를 검색합니다. 디폴트의 이름 공간을 검색하는 경우는 공문자열 ("")을 사용합니다.

파라미터:

prefix - 검색하는 접두사

반환값:

관련 이름 공간 URI. 접두사가 이 컨텍스트 내에서 선언되어 있지 않은 경우는 null

관련 항목:

getPrefix(java.lang.String), getPrefixes()

getPrefixes

public Enumeration  getPrefixes()

현재의 컨텍스트 내에서 선언이 활성화된, 모든 접두사의 열거를 리턴합니다. 여기에는 오버라이드(override)되어 있지 않은 친컨텍스트 의 선언도 포함됩니다.

주: 디폴트의 접두사는 반환값의 열거에 돌려주고지지 않습니다. 디폴트의 접두사를 확인하는 경우는 인수 ""를 지정해 getURI를 사용해 주세요.

반환값:

접두사의 열거 (공백 이외)

관련 항목:

getDeclaredPrefixes(), getURI(java.lang.String)

getPrefix

public String  getPrefix(String  uri)

이름 공간 URI에 매핑 되고 있는 접두사를 1개 리턴합니다.

같은 URI에 복수의 접두사가 매핑 되고 있는 경우, 이 메서드는 그 중에서 무작위로 1개를 리턴합니다. 모든 접두사를 확인하는 경우는 이 메서드가 아니고 getPrefixes() 메서드를 사용해 주세요.

주: 이 메서드는 공백 (디폴트)의 접두사를 돌려주지 않습니다. 디폴트의 접두사를 확인하는 경우는 인수 ""를 지정해 getURI를 사용해 주세요.

파라미터:

uri - 이름 공간 URI

반환값:

지정의 URI에 현재 매핑 되고 있는 접두사 가운데 1개. 현재 매핑 되고 있는 접두사가 없는 경우, 또는 URI가 디폴트의 이름 공간에 할당할 수 있는인 경우는 null

관련 항목:

getPrefixes(java.lang.String), getURI(java.lang.String)

getPrefixes

public Enumeration  getPrefixes(String  uri)

현재의 컨텍스트 내에서 선언이 활성화 되어 있는 지정된 URI 모든 접두사의 열거를 리턴합니다. 여기에는 오버라이드(override)되어 있지 않은 친컨텍스트 의 선언도 포함됩니다.

이 메서드는 특정의 이름 공간 URI에 매핑 되고 있는 접두사를 리턴합니다. 반환값에는 접두사 xml:가 포함됩니다. 이름 공간 URI에 매핑 되고 있는 접두사를 무작위로 1개 만 얻는인 경우는 이 메서드가 아니고 getPrefix 메서드를 사용합니다.

주: 공 (디폴트)의 접두사는 반환값의 열거에 포함되지 않습니다. 디폴트의 이름 공간의 존재를 확인하는 경우는 인수 ""를 지정해 getURI를 사용해 주세요.

파라미터:

uri - 이름 공간 URI

반환값:

접두사의 열거 (공백 이외)

관련 항목:

getPrefix(java.lang.String), getDeclaredPrefixes(), getURI(java.lang.String)

getDeclaredPrefixes

public Enumeration  getDeclaredPrefixes()

이 컨텍스트 내에 선언 떠날 수 있어 모든 접두사의 열거를 리턴합니다.

getPrefix(java.lang.String) 나 getPrefixes()를 사용하는 경우와는 달라, 반환값의 열거에는 공백 (디폴트)의 접두사도 포함됩니다.

반환값:

이 컨텍스트 내에 선언 떠날 수 있어 모든 접두사의 열거

관련 항목:

getPrefixes(), getURI(java.lang.String)

setNamespaceDeclUris

public void setNamespaceDeclUris(boolean value)

이름 공간 선언의 속성이 processName() 에 의해 NSDECL 이름 공간에 배치될지 어떨지를 제어합니다. 이 변경은 모든 컨텍스트이 푸쉬 되기 전에게만 실시할 수 있습니다 .

예외:

IllegalStateException - 컨텍스트이 푸쉬 된 뒤로 설정하려고 했을 경우

도입된 버전 :

SAX 2.1alpha

isNamespaceDeclUris

public boolean isNamespaceDeclUris()

이름 공간 선언의 속성이 이름 공간에 배치되었을 경우는 true를 리턴합니다. 이 동작은 디폴트에 하는 것이 아닙니다.

도입된 버전 :

SAX 2.1alpha