Класс QName

QName конструктор, задающий URI пространства имён и локальную часть.

Если URI пространства имён является null, он устанавливается в значение XMLConstants.NULL_NS_URI. Это значение обозначает отсутствие явно определённого пространства имён, как определено в спецификации Namespaces in XML. Это действие сохраняет совместимое поведение с QName 1.0. Явное указание значения XMLConstants.NULL_NS_URI предпочтительнее.

Если локальная часть является null, выбрасывается исключение IllegalArgumentException. Локальная часть "" разрешена для сохранения совместимого поведения с QName 1.0.

При использовании этого конструктора префикс устанавливается в значение XMLConstants.DEFAULT_NS_PREFIX.

URI пространства имён не проверяется как ссылка URI reference. Локальная часть не проверяется как NCName, как указано в Namespaces in XML.

QName конструктор, задающий URI пространства имён, локальную часть и префикс.

Если URI пространства имён является null, он устанавливается в значение XMLConstants.NULL_NS_URI. Это значение обозначает отсутствие явно определённого пространства имён, как определено в спецификации Namespaces in XML. Это действие сохраняет совместимое поведение с QName 1.0. Явное указание значения XMLConstants.NULL_NS_URI предпочтительнее.

Если локальная часть является null, выбрасывается исключение IllegalArgumentException. Локальная часть "" разрешена для сохранения совместимого поведения с QName 1.0.

Если префикс является null, выбрасывается исключение IllegalArgumentException. Используйте XMLConstants.DEFAULT_NS_PREFIX для явного указания отсутствия префикса или его неактуальности.

URI пространства имён не проверяется как ссылка URI reference. Локальная часть и префикс не проверяются как NCName, как указано в Namespaces in XML.

QName конструктор, задающий локальную часть.

Если локальная часть является null, выбрасывается исключение IllegalArgumentException. Локальная часть "" разрешена для сохранения совместимого поведения с QName 1.0.

При использовании этого конструктора URI пространства имён устанавливается в XMLConstants.NULL_NS_URI, а префикс устанавливается в XMLConstants.DEFAULT_NS_PREFIX.

В контексте XML все имена элементов и атрибутов существуют в контексте пространства имён. Явное указание этого при создании QName помогает предотвратить труднодиагностируемые ошибки валидации XML. Конструкторы QName(String namespaceURI, String localPart) и QName(String namespaceURI, String localPart, String prefix) предпочтительнее.

Локальная часть не проверяется как NCName, как указано в Namespaces in XML.

Получить URI пространства имён этого QName.

Получить локальную часть этого QName.

Получить префикс этого QName.

Префикс, присвоенный QName, МОЖЕТ быть недействительным в другом контексте. Например, QName может получить префикс при разборе документа, но этот префикс может быть недействительным в контексте другого документа.

Проверить равенство этого QName с другим Object.

Если Object для проверки не является QName или является null, то этот метод возвращает false.

Два QName считаются равными тогда и только тогда, когда равны URI пространства имён и локальная часть. Этот метод использует String.equals() для проверки равенства URI пространства имён и локальной части. Префикс НЕ используется для определения равенства.

Этот метод удовлетворяет общему контракту Object.equals(Object)

Сгенерировать код хэша для этого QName.

Код хэша вычисляется с использованием URI пространства имён и локальной части QName. Префикс НЕ используется для вычисления кода хэша.

Этот метод удовлетворяет общему контракту Object.hashCode().

String представление этого QName.

Общепринятый способ представления QName как String был определён Джеймсом Кларком. Хотя это не стандартная спецификация, она широко используется, например, в Transformer.setParameter(String name, Object value). Это реализация представляет QName как: "{" + URI пространства имён + "}" + локальная часть. Если URI пространства имён .equals(XMLConstants.NULL_NS_URI), возвращается только локальная часть. Подходящее использование этого метода — для отладки или ведения журнала для человека.

Обратите внимание, что значение префикса НЕ возвращается как часть представления String.

Этот метод удовлетворяет общему контракту Object.toString().

QName полученного из парсинга форматированной String.

Если String является null или не соответствует формату QName.toString(), будет брошено исключение IllegalArgumentException.

String ОБЯЗАТЕЛЬНО должно быть в формате, возвращаемом QName.toString().

Общепринятый способ представления QName в виде String был определён Джеймсом Кларком. Хотя это не стандартная спецификация, она широко используется, например, в Transformer.setParameter(String name, Object value). Эта реализация парсит String в формате: "{" + URI пространства имён + "}" + локальная часть. Если URI пространства имён .equals(XMLConstants.NULL_NS_URI), следует предоставить только локальную часть.

Значение префикса НЕЛЬЗЯ представить в String и будет установлено в XMLConstants.DEFAULT_NS_PREFIX.

Этот метод не выполняет полную валидацию результирующего QName.

URI пространства имён не валидируется как ссылка URI. Локальная часть не валидируется как NCName, как указано в пространствах имён в XML.