クラスQName

java.lang.Object
javax.xml.namespace.QName
すべての実装されたインタフェース:
Serializable
public class QName extends Object implements Serializable

QNameは、XML仕様で定義されている修飾名を表します: XMLスキーマPart2: データ型の仕様, XMLにおける名前空間.

QNameの値には名前空間URI、ローカル部分、接頭辞が含まれます。

XML input sourceに存在する場合に、QNameには字句情報を保持する接頭辞が含まれます。 QName.equals(Object)内、またはQName.hashCode()の計算には接頭辞は使用されません。 同一性およびハッシュ・コードは、名前空間URIおよびローカル部分のみを使用して定義されます。

名前空間URIを指定しない場合、XMLConstants.NULL_NS_URIに設定されます。 接頭辞を指定しない場合、XMLConstants.DEFAULT_NS_PREFIXに設定されます。

QNameは不変です。

導入されたバージョン:
1.5
関連項目:

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    QName(String localPart)
    ローカル部分を指定するQNameコンストラクタです。
    QName(String namespaceURI, String localPart)
    名前空間URIとローカル部分を指定するQNameコンストラクタです。
    QName(String namespaceURI, String localPart, String prefix)
    名前空間URI、ローカル部分、および接頭辞を指定するQNameコンストラクタです。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    final boolean
    equals(Object objectToTest)
    このQNameが別のObjectと等しいかどうかを判定します。
    String
    getLocalPart()
    このQNameのローカル部分を取得します。
    String
    getNamespaceURI()
    このQNameの名前空間URIを取得します。
    String
    getPrefix()
    このQNameの接頭辞を取得します。
    final int
    hashCode()
    このQNameのハッシュ・コードを生成します。
    String
    toString()
    このQNameの文字列表現を返します。
    static QName
    valueOf(String qNameAsString)
    文字列表現からQNameを返します。

    クラスオブジェクトで宣言されたメソッド

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • 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

      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の場合

    • 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のローカル部分
      スロー:
      IllegalArgumentException - localPartが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
      関連項目:

    • hashCode

      public final int hashCode()

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

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

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

      オーバーライド:
      hashCode、クラスObject
      戻り値:
      このQNameObjectのハッシュ・コード
      関連項目:

    • toString

      public String toString()
      このQNameの文字列表現を返します。 書式は次のとおりです。 
          {NamespaceURI}LocalPart
      NamespaceURIがnullの場合、LocalPartのみが返されます。
      オーバーライド:
      toString、クラスObject
      APIのノート:
      Prefixは、文字列表現では返されません。
      戻り値:
      このQNameの文字列表現

    • valueOf

      public static QName valueOf(String qNameAsString)
      文字列表現からQNameを返します。 文字列表現は、toString()によって返される形式である必要があります。 
          {NamespaceURI}LocalPart
      Prefixは文字列形式で表されないため、XMLConstants.DEFAULT_NS_PREFIXに設定されます。
      APIのノート:
      このメソッドでは、結果のQNameの完全な検証は実行されません。 NamespaceURIは、URI参照として検証されません。 LocalPartは、「XMLのネームスペース」で指定されているNCNameとして検証されません。
      パラメータ:
      qNameAsString - QNameの文字列表現
      戻り値:
      文字列表現からのQName
      スロー:
      IllegalArgumentException - qNameAsStringがnullまたは不正な場合
      関連項目: