NamespaceContext (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

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

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
관련 항목:: 공통 XML 치의 선언용의 javax.xml.XMLConstants , 「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
예외:: IllegalArgumentException - prefix 가 null 의 경우

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 에 바인드 된 접두사
예외:: IllegalArgumentException - namespaceURI 가 null 의 경우

getPrefixes

Iterator  getPrefixes(String  namespaceURI)

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

String 요소의 Iterator 가 임의의구현 의존순서로 돌려주어집니다.

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