javax.xml.namespace
클래스 QName

java.lang.Object 
  javax.xml.namespace.QName

모든 구현된 인터페이스:

Serializable

public class QName
extends Object 
implements Serializable 

QName는 XML 사양「XML Schema Part2: Datatypes specification」, 「Namespaces in XML」, 「Namespaces in XML Errata」에 정의되고 있는수식명을 나타냅니다.

QName값에는이름 공간 URI, 로컬 부분, 접두사가 포함됩니다.

XML 입력 소스 에존재하는경우에 QName에는 자구 정보를 보관 유지하는 접두사가 포함됩니다. QName.equals(Object) 내, 또는 QName.hashCode() 계산에는 접두사는사용되지 않습니다. 동일성 및 해시 코드는 이름 공간 URI 및 로컬 부분마셔를 사용해 정의됩니다.

이름 공간 URI를 지정하지 않는 경우, XMLConstants.NULL_NS_URI 로 설정됩니다. 접두사를 지정하지 않는 경우, XMLConstants.DEFAULT_NS_PREFIX 로 설정됩니다.

QName는 불변입니다.

도입된 버전 :

1.5

관련 항목:

XML Schema Part2: Datatypes specification, Namespaces in XML, Namespaces in XML Errata, 직렬화 된 형식

생성자 개요

QName (String localPart)
로컬 부분을 지정하는 QName 생성자 입니다.

QName (String namespaceURI, String localPart)
이름 공간 URI와 로컬 부분을 지정하는 QName 생성자 입니다.

QName (String namespaceURI, String localPart, String prefix)
이름 공간 URI, 로컬 부분, 접두사를 지정하는 QName 생성자 입니다.

메서드 개요

boolean	equals (Object objectToTest) 이 QName가 다른 Object와 동일한지 어떤지를 판정합니다.
String	getLocalPart () 이 QName 로컬 부분을 취득합니다.
String	getNamespaceURI () 이 QName 이름 공간 URI를 취득합니다.
String	getPrefix () 이 QName 접두사를 취득합니다.
int	hashCode () 이 QName 해시 코드를 생성합니다.
String	toString () 이 QName String 표현 QName를 String로 서 나타내는 일반적으로 받아들여지고 있는 방법은 James Clark 에 해정의되고 있습니다 .
static QName	valueOf (String qNameAsString) 서식화 된 String 해석으로부터 취득된 QName 입니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

생성자 상세

QName

public QName(String  namespaceURI,
             String  localPart)

이름 공간 URI와 로컬 부분을 지정하는 QName 생성자 입니다.

이름 공간 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 로서 검증되지 않습니다. 또, 로컬 부분은, 「Namespaces in XML」 로 가리키는 NCName 로서 검증되지 않습니다.

파라미터:

namespaceURI - QName 이름 공간 URI

localPart - QName 로컬 부분

관련 항목:

QName(String namespaceURI, String localPart, String prefix)

QName

public QName(String  namespaceURI,
             String  localPart,
             String  prefix)

이름 공간 URI, 로컬 부분, 접두사를 지정하는 QName 생성자 입니다.

이름 공간 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 로서 검증되지 않습니다. 또, 로컬 부분 및 접두사는 「Namespaces in XML」 로 가리키는 NCName 로서 검증되지 않습니다.

파라미터:

namespaceURI - QName 이름 공간 URI

localPart - QName 로컬 부분

prefix - QName 접두사

QName

public QName(String  localPart)

로컬 부분을 지정하는 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)를 사용하는 것을 추천합니다.

로컬 부분은, 「Namespaces in XML」로 가리키는 NCName 로서 검증되지 않습니다.

파라미터:

localPart - QName 로컬 부분

관련 항목:

QName(String namespaceURI, String localPart), QName(String namespaceURI, String localPart, String prefix)

메서드의 상세

getNamespaceURI

public String  getNamespaceURI()

이 QName 이름 공간 URI를 취득합니다.

반환값:

이 QName 이름 공간 URI

getLocalPart

public String  getLocalPart()

이 QName 로컬 부분을 취득합니다.

반환값:

이 QName 로컬 부분

getPrefix

public String  getPrefix()

이 QName 접두사를 취득합니다.

QName에 할당할 수 있는 접두사는 다른 컨텍스트에 서는유효하지 않을가능성이 있습니다. 예를 들어 문서의 구문 분석의 컨텍스트 으로QName에 접두사를 할당할 수 있는 일이 있습니다만, 그 접두사는 다른 문서의 컨텍스트에 서는 무효인 경우가 있습니다.

반환값:

이 QName 접두사

equals

public final boolean equals(Object  objectToTest)

이 QName가 다른 Object와 동일한지 어떤지를 판정합니다.

판정하는 Object이 QName가 아닌지, null인 경우, 이 메서드는 false를 리턴합니다.

2개의 QName는 양쪽 모두의 이름 공간 URI와 로컬 부분이 동일한 경우에게만 같다라고 보입니다. 이 메서드는 String.equals()를 사용해, 이름 공간 URI와 로컬 부분이 같은가 체크합니다. 동일성의 판정에 접두사는사용되지 않습니다.

이 메서드는 Object.equals(Object) 범용 규약을 채웁니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

objectToTest - 이 QName와 같은가 어떤가가 비교되는 Object

반환값:

지정된 Object이 이 QName와 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode(), Hashtable

hashCode

public final int hashCode()

이 QName 해시 코드를 생성합니다.

해시 코드는 QName 이름 공간 URI와 로컬 부분의 양쪽 모두를 사용해 계산됩니다. 해시 코드의 계산에 접두사는사용되지 않습니다.

이 메서드는 Object.hashCode() 범용 규약을 채웁니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 QName Object 해시 코드

관련 항목:

Object.equals(java.lang.Object), Hashtable

toString

public String  toString()

이 QName String 표현

QName를 String로 서 나타내는 일반적으로 받아들여지고 있는 방법은 James Clark 에 해정의되고 있습니다 . 이것은 「표준」사양이 아닙니다만, 일반적으로 사용되고 있습니다. 예를 들어 Transformer.setParameter(String name, Object value) 등입니다. 이 구현은 QName를 { + 이름 공간 URI + } + 로컬 부분에서 나타냅니다. 이름 공간 URI . equals(XMLConstants.NULL_NS_URI)인 경우, 로컬 부분만이 리턴됩니다 . 이 메서드의 적절한 용도는 디버그나 사용자 용의 로그 등입니다.

접두사의 값은 String 표현의 일부로서돌려주고지지 않은것으로 주의해 주세요.

이 메서드는 Object.toString() 범용 규약을 채웁니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 QName String 표현

valueOf

public static QName  valueOf(String  qNameAsString)

서식화 된 String 해석으로부터 취득된 QName 입니다.

String가 null, 또는 QName.toString() 서식에 따르지 않은 경우, IllegalArgumentException가 발생 됩니다.

String는 QName.toString() 에 의해 리턴된 형식이 아니면 안됩니다.

QName를 String로 서 나타내는 일반적으로 받아들여지고 있는 방법은 James Clark 에 해정의되고 있습니다 . 이것은 「표준」사양이 아닙니다만, 일반적으로 사용되고 있습니다. 예를 들어 Transformer.setParameter(String name, Object value) 등입니다. 이 구현은 { + 이름 공간 URI + } + 로컬 부분에서 서식화 된 String를 해석합니다. 이름 공간 URI . equals(XMLConstants.NULL_NS_URI)인 경우, 로컬 부분만이 제공될 것입니다.

접두사치는 String에 나타낼 수 없는모아 두어XMLConstants.DEFAULT_NS_PREFIX 로 설정됩니다.

이 메서드는 결과의 QName를 완전하게 검증하지 않습니다.

이름 공간 URI는 URI reference 로서 검증되지 않습니다. 또, 로컬 부분은, 「Namespaces in XML」 로 가리키는 NCName 로서 검증되지 않습니다.

파라미터:

qNameAsString - QName String 표현

반환값:

지정된 String에 대응하는 QName

관련 항목:

QName.toString()