Класс NamespaceSupport

public static final String XMLNS

URI пространства имен XML в виде константы. Значение — http://www.w3.org/XML/1998/namespace, как определено в рекомендации «Namespaces in XML».

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

public static final String NSDECL

URI объявления пространства имен в виде константы. Значение — http://www.w3.org/xmlns/2000/, как определено в исправлении к рекомендации «Namespaces in 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 пространства имен или пустая строка, если 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(String) и getPrefixes().

public void setNamespaceDeclUris(boolean value)

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

public boolean isNamespaceDeclUris()

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