Класс QName

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

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

Если локальная часть равна null, выбрасывается IllegalArgumentException. Разрешается локальная часть «», чтобы сохранить совместимость с QName 1.0.

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

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

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

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

Если локальная часть равна null, выбрасывается IllegalArgumentException. Разрешается локальная часть «», чтобы сохранить совместимость с QName 1.0.

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

URI пространства имён не проверяется как ссылка URI. Локальная часть и префикс не проверяются как NCName, как указано в Пространства имён в 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, как указано в Пространства имён в XML.

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

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

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

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

Проверить равенство этого QName с другим 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.