NamespaceContext (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

전의 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | 생성자 | 메서드

상세: 필드 | 생성자 | 메서드

javax.xml.namespace
인터페이스 NamespaceContext

public interface NamespaceContext

read 전용 XML 이름 공간 컨텍스트 처리의 인터페이스입니다.

XML 이름 공간에는 아래의 프로퍼티가 있습니다.

이름 공간 URI: URI 로서 나타내져 접두사가 바인드 되는 이름 공간명
접두사: 구문상, 이것은 이름 공간 선언으로XMLConstants.XMLNS_ATTRIBUTE ("xmlns")에 계속되는 속성명의 일부

예: <element xmlns:prefix="http://Namespace-name-URI">

모든 get*(*) 메서드는 이름 공간 URI 및 접두사의 해결의 현재의 스코프로 동작합니다.

이름 공간 URI는 현재의 스코프내의 복수의 접두사에 바인드 할 수 있습니다. 이 상황은 복수의 XMLConstants.XMLNS_ATTRIBUTE ("xmlns") 이름 공간 선언이 같은 개시 태그내에 있어, 같은 이름 공간 URI를 참조하고 있는 경우에 일어날 가능성이 있습니다. 다음에 예를 나타냅니다.


 <element xmlns:prefix1="http://Namespace-name-URI"
          xmlns:prefix2="http://Namespace-name-URI">

게다가 이 상황은 논리친요소 계층의 복수의 XMLConstants.XMLNS_ATTRIBUTE ("xmlns") 이름 공간 선언으로 같은 이름 공간 URI를 사용하고 있는 경우에도 일어날 가능성이 있습니다. 다음에 예를 나타냅니다.


 <parent xmlns:prefix1="http://Namespace-name-URI">
   <child xmlns:prefix2="http://Namespace-name-URI">
     ...
   </child>
 </parent>

접두사는 현재의 스코프내의 단일의 이름 공간 URI 에게만 바인드 할 수 있습니다.

도입된 버전 :: 1.5
관련 항목:: javax.XMLConstants for declarations of common XML values, XML Schema Part2: Datatypes, Namespaces in XML, Namespaces in XML Errata

메서드 개요
`String`	`getNamespaceURI (String prefix)` 현재의 스코프내의 접두사에 바인드 되고 있는 이름 공간 URI를 취득합니다.
`String`	`getPrefix (String namespaceURI)` 현재의 스코프내의 이름 공간 URI에 바인드 되고 있는 접두사를 취득합니다.
`Iterator`	`getPrefixes (String namespaceURI)` 현재의 스코프내의 이름 공간 URI에 바인드 떠날 수 있어 모든 접두사를 취득합니다.

메서드의 상세

getNamespaceURI

String  getNamespaceURI(String  prefix)

현재의 스코프내의 접두사에 바인드 되고 있는 이름 공간 URI를 취득합니다.

접두사에 의해 이름 공간 URI를 요구하는 경우에 아래의 겉(표)에 가능성이 있는 모든 접두사의 값에 대해서 리턴된 이름 공간 URI 치를 나타냅니다.

지정된 접두사에 대한 `getNamespaceURI(prefix)` 반환값
접두사 파라미터	이름 공간 URI 반환값
`DEFAULT_NS_PREFIX` ("")	현재의 스코프내의 디폴트의 이름 공간 URI 또는 현재의 스코프내에 디폴트의 이름 공간 URI가 없는 경우에 `XMLConstants.NULL_NS_URI("")`
바인드 된 접두사	현재의 스코프내의 접두사에 바인드 된 이름 공간 URI
바인드되어 있지 않은 접두사	`XMLConstants.NULL_NS_URI("")`
`XMLConstants.XML_NS_PREFIX` ("xml")	`XMLConstants.XML_NS_URI` ("http://www.w3.org/XML/1998/namespace")
`XMLConstants.XMLNS_ATTRIBUTE` ("xmlns")	`XMLConstants.XMLNS_ATTRIBUTE_NS_URI` ("http://www.w3.org/2000/xmlns/")
`null`	`IllegalArgumentException`가 Throw 된다

파라미터:: prefix - 검색하는 접두사
반환값:: 현재의 스코프내의 접두사에 바인드 된 이름 공간 URI

getPrefix

String  getPrefix(String  namespaceURI)

현재의 스코프내의 이름 공간 URI에 바인드 되고 있는 접두사를 취득합니다.

현재의 스코프내의 이름 공간 URI에 바인드 떠날 수 있어 모든 접두사를 취득하려면, getPrefixes(String namespaceURI)를 사용합니다.

이름 공간 URI에 의해 접두사를 요구하는 경우에 아래의 겉(표)에 모든 이름 공간 URI 치에 대해서 리턴된 접두사의 값을 나타냅니다.

지정한 이름 공간 URI에 대한 `getPrefix(namespaceURI)` 반환값
이름 공간 URI 파라미터	리턴된 접두사의 값
<디폴트의 이름 공간 URI>	`XMLConstants.DEFAULT_NS_PREFIX` ("")
바인드 된 이름 공간 URI	현재의 스코프내의 이름 공간 URI에 바인드 된 접두사. 현재의 스코프내의 이름 공간 URI에 바인드 된 접두사가 다수 있는 경우는 단일의 임의의 접두사 (이 선택은 구현 존)가 리턴된다.
바인드되어 있지 않은 이름 공간 URI	`null`
`XMLConstants.XML_NS_URI` ("http://www.w3.org/XML/1998/namespace")	`XMLConstants.XML_NS_PREFIX` ("xml")
`XMLConstants.XMLNS_ATTRIBUTE_NS_URI` ("http://www.w3.org/2000/xmlns/")	`XMLConstants.XMLNS_ATTRIBUTE` ("xmlns")
`null`	`IllegalArgumentException` 이 Throw 된다

파라미터:: namespaceURI - 검색하는 이름 공간의 URI
반환값:: 현재의 컨텍스트 내의 이름 공간 URI에 바인드 된 접두사

getPrefixes

Iterator  getPrefixes(String  namespaceURI)

현재의 스코프내의 이름 공간 URI에 바인드 떠날 수 있어 모든 접두사를 취득합니다.

String 요소의 Iterator가 임의의 구현 존순서로 리턴됩니다 .

Iterator는 「변경 불가능」입니다. 예를 들어 remove() 메서드는 UnsupportedOperationException을 Throw 합니다.