Класс NamespaceSupport

public static final String XMLNS

URI пространства имён XML в качестве константы. Значение равно http://www.w3.org/XML/1998/namespace согласно рекомендации "Пространства имён в XML".

Это URI пространства имён, который автоматически сопоставляется с префиксом "xml".

public static final String NSDECL

URI объявления пространства имён в качестве константы. Значение равно http://www.w3.org/xmlns/2000/, как определено в несовместимой с предыдущими версиями поправке к рекомендации "Пространства имён в XML". Поскольку эта поправка была создана после SAX2, SAX2 по умолчанию использует первоначальную рекомендацию и обычно не использует этот URI.

Это URI пространства имён, который необязательно применяется к атрибутам xmlns и xmlns:*, используемым для объявления пространств имён.

public NamespaceSupport()

Создаёт новый объект поддержки пространств имён.

public void reset()

Сбрасывает этот объект поддержки пространств имён для повторного использования.

Необходимо вызвать этот метод перед повторным использованием объекта поддержки пространств имён для новой сессии. Если поддержка пространств имён объявления URI требуется, необходимо также установить этот флаг в значение, отличное от значения по умолчанию.

public void pushContext()

Начинает новый контекст пространства имён. Новый контекст автоматически унаследует объявления родительского контекста, но также будет отслеживать объявления, сделанные в этом контексте.

Код обратного вызова события должен запускать новый контекст один раз на каждый элемент. Это означает, что нужно быть готовым вызвать это в одном из двух мест. Для элементов, не содержащих объявлений пространств имён, соответствующим местом является обратный вызов ContentHandler.startElement(). Для элементов с таким объявлением, это делается в первом обратном вызове ContentHandler.startPrefixMapping(). Можно использовать флаг булевого типа, чтобы отслеживать, был ли контекст запущен. Когда вызывается любой из этих методов, проверяется флаг, чтобы увидеть, нужно ли запустить новый контекст. Если нужно, запускается контекст и устанавливается флаг. После того, как ContentHandler.startElement() делает это, он всегда сбрасывает флаг.

Обычно драйверы SAX запускают новый контекст в начале каждого XML-элемента. Затем они выполняют первый проход по атрибутам, чтобы обработать все объявления пространств имён, вызывая обратные вызовы ContentHandler.startPrefixMapping(). Затем выполняется второй проход, чтобы определить имена пространств имён для всех атрибутов и для имени элемента. Наконец, вся информация для обратного вызова ContentHandler.startElement() становится доступной, поэтому его можно вызвать.

Объект поддержки пространств имён всегда начинает работу с базовым контекстом: в этом контексте объявлено только префикс "xml".

public void popContext()

Возвращается к предыдущему контексту пространства имён.

Обычно контекст следует извлекать в конце каждого XML-элемента. После извлечения контекста все сопоставления префиксов пространств имён, которые ранее действовали, восстанавливаются.

Нельзя пытаться объявить дополнительные префиксы пространств имён после извлечения контекста, пока не будет создан новый контекст.

public boolean declarePrefix(String prefix, String uri)

Объявляет префикс пространства имён. Все префиксы должны быть объявлены перед их использованием. Например, драйвер SAX (парсер) будет сканировать атрибуты элемента двумя проходами: сначала для объявлений пространств имён, а затем — второй проход с использованием processName() для интерпретации префиксов по отношению к (возможно переопределённым) префиксам.

Этот метод объявляет префикс в текущем контексте пространства имён; префикс будет действовать до тех пор, пока этот контекст не будет извлечён, если он не будет затенён в дочернем контексте.

Для объявления пространства имён элемента по умолчанию используйте пустую строку в качестве префикса.

Обратите внимание на асимметрию в этой библиотеке: getPrefix не вернёт префикс "", даже если вы объявили пространство имён элемента по умолчанию. Чтобы проверить наличие пространства имён по умолчанию, необходимо явно обратиться к нему с помощью getURI.

public String[] processName(String qName, String[] parts, boolean isAttribute)

Обрабатывает квалифицированное имя XML, после того как все объявления в текущем контексте были обработаны методом declarePrefix().

Этот метод обрабатывает квалифицированное имя XML в текущем контексте путём удаления префикса и его поиска среди объявленных префиксов. Возвращаемое значение будет массивом, предоставленным вызывающим объектом, заполненным следующим образом:

parts[0]

URI пространства имён или пустая строка, если он не используется.

parts[1]

Локальное имя (без префикса).

parts[2]

Оригинальное квалифицированное имя.

Все строки в массиве будут интернализованы. Если у квалифицированного имени есть префикс, который не был объявлен, то возвращаемое значение будет null.

Обратите внимание, что имена атрибутов обрабатываются по-другому, чем имена элементов: неименованное имя элемента получит пространство имён по умолчанию (если оно есть), в то время как неименованное имя атрибута его не получит.

public String getURI(String prefix)

Ищет префикс и получает сопоставленный URI пространства имён.

Этот метод ищет префикс в текущем контексте. Используйте пустую строку ("") для пространства имён по умолчанию.

public Enumeration<String> getPrefixes()

Возвращает перечисление всех префиксов, объявления которых активны в текущем контексте. Это включает объявления из родительских контекстов, которые не были переопределены.

Примечание: если есть префикс по умолчанию, он не будет возвращён в этом перечислении; проверьте префикс по умолчанию, используя getURI с аргументом "".

public String getPrefix(String uri)

Возвращает один из префиксов, сопоставленных с URI пространства имён.

Если более одного префикса сопоставлено с одним и тем же URI, этот метод сделает произвольный выбор; если вам нужны все префиксы, используйте метод getPrefixes() вместо этого.

Примечание: это значение никогда не вернёт пустой (по умолчанию) префикс; чтобы проверить наличие префикса по умолчанию, используйте метод getURI с аргументом "".

public Enumeration<String> getPrefixes(String uri)

Возвращает перечисление всех префиксов для данного URI, объявления которых активны в текущем контексте. Это включает объявления из родительских контекстов, которые не были переопределены.

Этот метод возвращает префиксы, сопоставленные с конкретным URI пространства имён. Префикс xml: будет включён. Если вам нужен только один префикс, сопоставленный с URI пространства имён, и вам всё равно какой, используйте метод getPrefix вместо этого.

Примечание: пустой (по умолчанию) префикс никогда не включается в это перечисление; чтобы проверить наличие пространства имён по умолчанию, используйте метод getURI с аргументом "".

public Enumeration<String> getDeclaredPrefixes()

Возвращает перечисление всех префиксов, объявленных в этом контексте.

Пустой (по умолчанию) префикс будет включён в это перечисление; обратите внимание, что это поведение отличается от поведения методов getPrefix(java.lang.String) и getPrefixes().

public void setNamespaceDeclUris(boolean value)

Управляет тем, помещаются ли атрибуты объявления пространства имён в пространство имён NSDECL методом processName(). Это можно изменить только до того, как любые контексты будут добавлены.

public boolean isNamespaceDeclUris()

Возвращает true, если атрибуты объявления пространства имён помещаются в пространство имён. Это поведение не является по умолчанию.