Класс 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.

Если объект, который нужно проверить, не является 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 пустая или не соответствует формату 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.