QName (Платформа Java SE 8 b92)

java.lang. Объект
- javax.xml.namespace. QName

Все Реализованные Интерфейсы:

Сериализуемый
```
public class QName
extends Object
implements Serializable
```
QName представляет полностью определенное имя как определено в спецификациях XML: XML-схема Part2: спецификация Типов данных, Пространства имен в XML, Пространства имен в XML Опечатки.

Значение a QName содержит URI Пространства имен, локальную часть и префикс.

Префикс включается в QName сохранить лексическую информацию когда существующий в XML input source. Префикс НЕ используется в QName.equals(Object) или вычислить QName.hashCode(). Равенство и хэш-код определяются, используя только URI Пространства имен и локальную часть.

Если не определенный, URI Пространства имен устанавливается в XMLConstants.NULL_NS_URI. Если не определенный, префикс устанавливается в XMLConstants.DEFAULT_NS_PREFIX.

QName является неизменным.

С тех пор:

1.5

Версия:

$Revision: 1,8$, $Date: 18.03.2010$ 3:06:17

См. Также:

XML-схема Part2: спецификация Типов данных, Пространства имен в XML, Пространства имен в XML Опечатки, Сериализированная Форма

Сводка конструктора

Конструкторы
Конструктор и Описание
`QName(String localPart)` `QName` конструктор, определяющий локальную часть.
`QName(String namespaceURI, String localPart)` `QName` конструктор, определяющий URI Пространства имен и локальную часть.
`QName(String namespaceURI, String localPart, String prefix)` `QName` конструктор, определяющий URI Пространства имен, локальную часть и префикс.

Сводка метода

Все Методы Статические Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`boolean`	`equals(Object objectToTest)` Протестируйте это `QName` для равенства с другим `Object`.
`Строка`	`getLocalPart()` Получите локальную часть этого `QName`.
`Строка`	`getNamespaceURI()` Получите URI Пространства имен этого `QName`.
`Строка`	`getPrefix()` Получите префикс этого `QName`.
`int`	`hashCode()` Генерируйте хэш-код для этого `QName`.
`Строка`	`toString()` `String` представление этого `QName`.
`static QName`	`valueOf(String qNameAsString)` `QName` полученный из парсинга отформатированного `String`.

Методы, наследованные от class java.lang. Объект
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - QName
```
public QName(String namespaceURI,
             String localPart)
```
    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.
    
    Параметры:
    
    namespaceURI - URI пространства имен QName
    
    localPart - локальная часть QName
    
    Броски:
    
    IllegalArgumentException - Когда localPart null
    
    См. Также:
    
    QName(String namespaceURI, String localPart, String prefix)
  - QName
```
public QName(String namespaceURI,
             String localPart,
             String prefix)
```
    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.
    
    Параметры:
    
    namespaceURI - URI пространства имен QName
    
    localPart - локальная часть QName
    
    prefix - префикс QName
    
    Броски:
    
    IllegalArgumentException - Когда localPart или prefix null
  - QName
```
public QName(String localPart)
```
    QName конструктор, определяющий локальную часть.
    
    Если локальная часть null IllegalArgumentException бросается. Локальной части "" позволяют сохранить совместимое поведение с QName 1.0.
    
    При использовании этого конструктора URI Пространства имен устанавливается в XMLConstants.NULL_NS_URI и префикс устанавливается в XMLConstants.DEFAULT_NS_PREFIX.
    
    В контексте XML весь Элемент и Названия атрибута существуют в контексте Пространства имен. Создание этого явного во время конструкции a QName помогает предотвратить трудно к ошибкам законности XML диагноза. Конструкторы QName(String namespaceURI, String localPart) и QName(String namespaceURI, String localPart, String prefix) предпочитаются.
    
    Локальная часть не проверяется как NCName как определено в Пространствах имен в XML.
    
    Параметры:
    
    localPart - локальная часть QName
    
    Броски:
    
    IllegalArgumentException - Когда localPart null
    
    См. Также:
    
    QName(String namespaceURI, String localPart), QName(String namespaceURI, String localPart, String prefix)
- Деталь метода
  - getNamespaceURI
```
public String getNamespaceURI()
```
    Получите URI Пространства имен этого QName.
    
    Возвраты:
    
    URI пространства имен этого QName
  - getLocalPart
```
public String getLocalPart()
```
    Получите локальную часть этого QName.
    
    Возвраты:
    
    локальная часть этого QName
  - getPrefix
```
public String getPrefix()
```
    Получите префикс этого QName.
    
    Префикс, присвоенный a QName НЕ могло бы быть допустимым в различном контексте. Например, a QName может быть присвоен префикс в контексте парсинга документа, но что префикс может быть недопустимым в контексте различного документа.
    
    Возвраты:
    
    префикс этого QName
  - равняется
```
public final boolean equals(Object objectToTest)
```
    Протестируйте это QName для равенства с другим Object.
    
    Если Object быть протестированным не a QName или null, тогда этот метод возвраты false.
    
    Два QNames считают равными, если и только если и URI Пространства имен и локальная часть равны. Этот метод использование String.equals() проверять равенство URI Пространства имен и локальной части. Префикс НЕ используется, чтобы определить равенство.
    
    Этот метод удовлетворяет общий контракт Object.equals(Object)
    
    Переопределения:
    
    equals в class Object
    
    Параметры:
    
    objectToTest - Object протестировать на равенство с этим QName
    
    Возвраты:
    
    true если данный Object равно этому QName еще false
    
    См. Также:
    
    Object.hashCode(), HashMap
  - хэш-код
```
public final int hashCode()
```
    Генерируйте хэш-код для этого QName.
    
    Хэш-код вычисляется, используя и URI Пространства имен и локальную часть QName. Префикс НЕ используется, чтобы вычислить хэш-код.
    
    Этот метод удовлетворяет общий контракт Object.hashCode().
    
    Переопределения:
    
    hashCode в class Object
    
    Возвраты:
    
    хэш-код для этого QName Object
    
    См. Также:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    String представление этого QName.
    
    Обычно принимаемый способ представить a QName как a String был определен Джеймсом Кларком. Хотя это не стандартная спецификация, это широко используется, например. Transformer.setParameter(String name, Object value). Эта реализация представляет a QName как: "{" + URI Пространства имен +"}" + локальная часть. Если URI Пространства имен .equals(XMLConstants.NULL_NS_URI), только локальная часть возвращается. Соответствующее использование этого метода для отладки или журналирования для потребления человеком.
    
    Отметьте, что префиксное значение НЕ возвращается как часть String представление.
    
    Этот метод удовлетворяет общий контракт Object.toString().
    
    Переопределения:
    
    toString в class Object
    
    Возвраты:
    
    String представление этого QName
  - valueOf
```
public static QName valueOf(String qNameAsString)
```
    QName полученный из парсинга отформатированного String.
    
    Если String null или не соответствует QName.toString() форматирование, IllegalArgumentException бросается.
    
    String ДОЛЖЕН быть в форме, возвращенной QName.toString().
    
    Обычно принимаемый способ представить a QName как a String был определен Джеймсом Кларком. Хотя это не стандартная спецификация, это широко используется, например. Transformer.setParameter(String name, Object value). Эта реализация анализирует a String отформатированный как: "{" + URI Пространства имен +"}" + локальная часть. Если URI Пространства имен .equals(XMLConstants.NULL_NS_URI), только локальная часть должна быть обеспечена.
    
    Префиксное значение не МОЖЕТ быть представлено в String и будет установлен в XMLConstants.DEFAULT_NS_PREFIX.
    
    Этот метод не делает полной проверки допустимости получающегося QName.
    URI Пространства имен не проверяется как ссылка URI. Локальная часть не проверяется как NCName как определено в Пространствах имен в XML.
    
    Параметры:
    
    qNameAsString - String представление QName
    
    Возвраты:
    
    QName соответствие данному String
    
    Броски:
    
    IllegalArgumentException - Когда qNameAsString null или уродливый
    
    См. Также:
    
    QName.toString()

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс QName

Сводка конструктора

Сводка метода

Методы, наследованные от class java.lang. Объект

Деталь конструктора

QName

QName

QName

Деталь метода

getNamespaceURI

getLocalPart

getPrefix

равняется

хэш-код

toString

valueOf