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 가 throw 됩니다. "" 의 로컬 부분은 QName 1.0 과의 호환성이 있는 동작이 보관 유지됩니다.

　

이 생성자 을 사용하는 경우, 접두사는 XMLConstants.DEFAULT_NS_PREFIX 로 설정됩니다.

　

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

파라미터:

namespaceURI - QName 의 이름 공간 URI

localPart - QName 의 로컬 부분

예외:

IllegalArgumentException - localPart 가 null 의 경우

관련 항목:

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 가 throw 됩니다. "" 의 로컬 부분은 QName 1.0 과의 호환성이 있는 동작이 보관 유지됩니다.

　

접두사가 null 의 경우,IllegalArgumentException 가 throw 됩니다. XMLConstants.DEFAULT_NS_PREFIX 를 사용해, 접두사가 존재하지 않는지, 접두사가 관계없는 것을 명시적으로 지시합니다.

　

이름 공간 URI 는,URI reference 로서 검증되지 않습니다. 또, 로컬 부분 및 접두사는,「Namespaces in XML」 로 지정되고 있는 NCName 로서 검증되지 않습니다.

파라미터:

namespaceURI - QName 의 이름 공간 URI

localPart - QName 의 로컬 부분

prefix - QName 의 접두사

예외:

IllegalArgumentException - localPart 또는 prefix 가 null 의 경우

QName

public QName(String  localPart)

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

　

로컬 부분이 null 의 경우,IllegalArgumentException 가 throw 됩니다. "" 의 로컬 부분은 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 의 로컬 부분

예외:

IllegalArgumentException - localPart 가 null 의 경우

관련 항목:

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) 등입니다. This implementation represents a QName as: "{" + Namespace URI + "}" + local part. 이름 공간 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 가 throw 됩니다.

　

String 는 QName.toString() 에 의해 반환되는 형식이 아니면 안됩니다.

　

QName 를 String 로서 나타내는 일반적으로 받아들여지고 있는 방법은 James Clark 에 의해정의되고 있습니다 . 이것은 「표준」스펙이 아닙니다만, 일반적으로 사용되고 있습니다. 예를 들어 Transformer.setParameter(String name, Object value) 등입니다. This implementation parses a String formatted as: "{" + Namespace URI + "}" + local part. 이름 공간 URI . equals(XMLConstants.NULL_NS_URI) 의 경우, 로컬 부분만이 제공될 것입니다.

　

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

　

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

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

파라미터:

qNameAsString - QName 의 String 표현

반환값:

지정된 String 에 대응하는 QName

예외:

IllegalArgumentException - qNameAsString 가 null 또는 부정한 경우

관련 항목:

QName.toString()