public interface NamespaceContext
Интерфейс для XML только для чтения обработка контекста Пространства имен.
У XML Пространство имен есть свойства:
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 единого пространства имен в текущем контексте.
Модификатор и Тип | Метод и Описание |
---|---|
Строка |
getNamespaceURI(String prefix)
Свяжите URI Пространства имен с префиксом в текущем контексте.
|
Строка |
getPrefix(String namespaceURI)
Получите префикс, связанный с URI Пространства имен в текущем контексте.
|
Iterator |
getPrefixes(String namespaceURI)
Получите все префиксы, связанные с URI Пространства имен в текущем контексте.
|
String getNamespaceURI(String prefix)
Свяжите URI Пространства имен с префиксом в текущем контексте.
Запрашивая URI Пространства имен префиксом, следующая таблица описывает возвращенное значение URI Пространства имен для всех возможных префиксных значений:
getNamespaceURI(prefix) возвращаемое значение для указанных префиксов |
|
префиксный параметр | Возвращаемое значение 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
- префикс, чтобы искатьIllegalArgumentException
- Когда prefix
null
String getPrefix(String namespaceURI)
Получите префикс, связанный с URI Пространства имен в текущем контексте.
Чтобы получить все префиксы, связанные с URI Пространства имен в текущем контексте, использовать getPrefixes(String namespaceURI)
.
Запрашивая префикс URI Пространства имен, следующая таблица описывает возвращенное префиксное значение для всех значений URI Пространства имен:
getPrefix(namespaceURI) возвращаемое значение для указанных URI Пространства имен |
|
---|---|
Параметр 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 Пространства имен к поискуIllegalArgumentException
- Когда namespaceURI
null
Iterator getPrefixes(String namespaceURI)
Получите все префиксы, связанные с URI Пространства имен в текущем контексте.
Iterator по Строковым элементам возвращается в произвольном, зависящем от реализации, порядке.
Iterator
не является поддающимся изменению. например, remove()
метод бросит UnsupportedOperationException
.
Запрашивая префиксы URI Пространства имен, следующая таблица описывает возвращенное значение префиксов для всех значений URI Пространства имен:
getPrefixes(namespaceURI) возвращаемое значение для указанных URI Пространства имен |
|
---|---|
Параметр URI пространства имен | значение префиксов возвратилось |
связанный URI Пространства имен, включая <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
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92