モジュール java.xml
パッケージ javax.xml.namespace

クラスQName

    • コンストラクタの詳細

      • 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のローカル部分
        例外:
        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がスローされます。"" のローカル部分はQName 1.0との互換性のある動作が保持されます。

        接頭辞がnullの場合、IllegalArgumentExceptionがスローされます。 XMLConstants.DEFAULT_NS_PREFIXを使用して、接頭辞が存在しないか、接頭辞が関係ないことを明示的に指示します。

        名前空間URIは、URI referenceとして検証されません。 ローカル部分および接頭辞は、「Namespaces in XML」で指定されているNCNameとして検証されません。

        パラメータ:
        namespaceURI - QNameの名前空間URI
        localPart - QNameのローカル部分
        prefix - QNameの接頭辞
        例外:
        IllegalArgumentException - localPartまたはprefixがnullの場合

    • メソッドの詳細

      • 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)の汎用規約を満たします

        オーバーライド:
        equals、クラスObject
        パラメータ:
        objectToTest - このQNameと等しいかどうかが判定されるObject
        戻り値:
        指定されたObjectがこのQNameと等しい場合はtrue、そうでない場合はfalse
        関連項目:
        Object.hashCode()、HashMap

      • hashCode

        public final int hashCode()

        このQNameのハッシュ・コードを生成します。

        ハッシュ・コードは、QNameの名前空間URIとローカル部分の両方を使用して計算されます。 ハッシュ・コードの計算に接頭辞は使用されません。

        このメソッドはObject.hashCode()の汎用規約を満たします。

        オーバーライド:
        hashCode、クラスObject
        戻り値:
        このQNameObjectのハッシュ・コード
        関連項目:
        Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

      • 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()の汎用規約を満たします。

        オーバーライド:
        toString、クラスObject
        戻り値:
        この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
        例外:
        IllegalArgumentException - qNameAsStringがnullまたは不正である場合
        関連項目:
        QName.toString()