NamespaceContext (Java Platform SE 7)

```
public interface NamespaceContext
```
読み込み専用 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.xml.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` がスローされる

パラメータ:: 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` がスローされる

パラメータ:: namespaceURI - 検索する名前空間の URI
戻り値:: 現在のコンテキスト内の名前空間 URI にバインドされた接頭辞
例外:: IllegalArgumentException - namespaceURI が null の場合

getPrefixes

Iterator getPrefixes(String namespaceURI)

現在のスコープ内の名前空間 URI にバインドされているすべての接頭辞を取得します。

String 要素の Iterator が任意の実装依存順で返されます。

Iterator は変更不可能です。たとえば remove() メソッドは UnsupportedOperationException をスローします。