Интерфейс NamespaceContext
public interface NamespaceContext
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">
Это также может произойти, когда один и тот же URI пространства имён используется в нескольких XMLConstants.XMLNS_ATTRIBUTE ("xmlns") объявлениях пространств имён в иерархии логических родительских элементов. Например:
<parent xmlns:prefix1="http://Namespace-name-URI">
<child xmlns:prefix2="http://Namespace-name-URI">
...
</child>
</parent>
Префикс может быть привязан только к одному URI пространства имён в текущей области видимости.
- С:
- 1.5
- См. также:
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
String |
getNamespaceURI |
Получение URI пространства имён, привязанного к префиксу в текущей области видимости. |
String |
getPrefix |
Получение префикса, привязанного к URI пространства имён в текущей области видимости. |
Iterator |
getPrefixes |
Получение всех префиксов, привязанных к URI пространства имён в текущей области видимости. |
Подробное описание методов
getNamespaceURI
String getNamespaceURI(String prefix)
При запросе URI пространства имён по префиксу, следующая таблица описывает возвращаемое значение URI пространства имён для всех возможных значений префикса:
| Параметр префикса | Возвращаемое значение URI пространства имён |
|---|---|
DEFAULT_NS_PREFIX ("") | URI по умолчанию в текущей области видимости или если URI по умолчанию в текущей области видимости отсутствует |
| привязанный префикс | 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 пространства имён в текущей области видимости, используйте getPrefixes(String namespaceURI).
При запросе префикса по URI пространства имён, следующая таблица описывает возвращаемое значение префикса для всех значений URI пространства имён:
| Параметр URI пространства имён | Возвращаемое значение префикса |
|---|---|
<default Namespace 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<String> getPrefixes(String namespaceURI)
Возвращается итератор над строковыми элементами в произвольном, зависимом от реализации порядке.
Итератор не изменяем. Например, метод remove() будет выбрасывать UnsupportedOperationException.
При запросе префиксов по URI пространства имён, следующая таблица описывает возвращаемые значения префиксов для всех значений URI пространства имён:
| Параметр URI пространства имён | Возвращаемые значения префиксов |
|---|---|
привязанный URI пространства имён, включая <default Namespace URI>
| Iterator над префиксами, привязанными к URI пространства имён в текущей области видимости в произвольном, зависимом от реализации порядке |
| непривязанный URI пространства имён | пустой Iterator
|
XMLConstants.XML_NS_URI ("http://www.w3.org/XML/1998/namespace") |
Iterator с одним элементом, установленным в XMLConstants.XML_NS_PREFIX ("xml") |
XMLConstants.XMLNS_ATTRIBUTE_NS_URI ("http://www.w3.org/2000/xmlns/") |
Iterator с одним элементом, установленным в XMLConstants.XMLNS_ATTRIBUTE ("xmlns") |
null |
IllegalArgumentException выбрасывается |
- Параметры:
-
namespaceURI- URI пространства имён для поиска - Возвращает:
-
Iteratorдля всех префиксов, привязанных к URI пространства имён в текущей области видимости - Исключения:
-
IllegalArgumentException- КогдаnamespaceURIявляетсяnull
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.xml/javax/xml/namespace/NamespaceContext.html