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

Если проверяемый 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, как указано в Namespaces in XML.