Spec-Zone.ru › OpenJDK 21

Интерфейс NamespaceContext

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"> 
 
Это также может произойти, когда один и тот же URI пространства имён используется в нескольких XMLConstants.XMLNS_ATTRIBUTE ("xmlns") объявлениях пространств имён в иерархии логических родительских элементов. Например:
 
 <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: Типы данных
  • Пространства имён в XML

Краткое описание методов

Модификатор и тип Метод Описание
String getNamespaceURI(String prefix)
Получение URI пространства имён, привязанного к префиксу в текущей области видимости.
String getPrefix(String namespaceURI)
Получение префикса, привязанного к URI пространства имён в текущей области видимости.
Iterator<String> getPrefixes(String namespaceURI)
Получение всех префиксов, привязанных к URI пространства имён в текущей области видимости.

Подробное описание методов

getNamespaceURI

String getNamespaceURI(String prefix)
Получение URI пространства имён, привязанного к префиксу в текущей области видимости.

При запросе URI пространства имён по префиксу, следующая таблица описывает возвращаемое значение URI пространства имён для всех возможных значений префикса:

Возвращаемое значение для указанных префиксов
Параметр префикса Возвращаемое значение URI пространства имён
DEFAULT_NS_PREFIX ("") URI по умолчанию в текущей области видимости или XMLConstants.NULL_NS_URI("") если 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 пространств имён
Параметр 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)
Получение всех префиксов, привязанных к URI пространства имён в текущей области видимости.

Возвращается итератор над строковыми элементами в произвольном, зависимом от реализации порядке.

Итератор не изменяем. Например, метод remove() будет выбрасывать UnsupportedOperationException.

При запросе префиксов по URI пространства имён, следующая таблица описывает возвращаемые значения префиксов для всех значений 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API