JavaTM Platform
Standard Ed. 6

javax.xml.soap
インタフェース Name


public interface Name

XML 名の表現です。このインタフェースは、ローカル名と名前空間修飾名を取得するメソッドや、名前の名前空間に関連付けられた接頭辞を取得するメソッドを提供します。また、名前空間の URI を取得することも可能です。

次に、要素内の名前空間宣言の例を示します。

   <wombat:GetLastTradePrice xmlns:wombat="http://www.wombat.org/trader">
 
ここでの「xmlns」は「XML の名前空間」を意味します。Name インタフェースのメソッドが返すものは次のとおりです。

XML の名前空間を使用すると、アプリケーション固有の識別子から発生する SOAP 識別子間の差異をなくすことができます。

Name オブジェクトは、2 つのバージョンの SOAPEnvelope.createName メソッドにより作成されます。1 つはローカル名、名前空間の接頭辞、名前空間の URI を使用して Name オブジェクトを作成し、もう 1 つは、ローカル名のみを使用して Name を作成するメソッドです。次のコード (seSOAPEnvelope オブジェクト) に、3 つすべての引数を使用して新しい Name オブジェクトを作成する例を示します。

     Name name = se.createName("GetLastTradePrice", "WOMBAT",
                                "http://www.wombat.org/trader");
 
次のコードで、Name オブジェクトの使用例を示します。変数 elementSOAPElement オブジェクトを意味します。この例では、指定の名前で SOAPElement オブジェクトを新しく作成し、element にそれを追加しています。
     element.addChildElement(name);
 

Name インタフェースは、javax.xml.namespace.QName との関係で、SAAJ の将来のリリースで推奨されなくなる可能性があります。

関連項目:
SOAPEnvelope.createName, SOAPFactory.createName

メソッドの概要
 String getLocalName()
          この Name オブジェクトが表す XML 名のローカル名の部分を取得します。
 String getPrefix()
          この Name オブジェクトが初期化された際に、指定された接頭辞を返します。
 String getQualifiedName()
          この Name オブジェクトが表す XML 名の名前空間修飾名を取得します。
 String getURI()
          Name オブジェクトが表す XML 名の名前空間の URI を返します。
 

メソッドの詳細

getLocalName

String getLocalName()
この Name オブジェクトが表す XML 名のローカル名の部分を取得します。

戻り値:
ローカル名を提供する文字列

getQualifiedName

String getQualifiedName()
この Name オブジェクトが表す XML 名の名前空間修飾名を取得します。

戻り値:
文字列の名前空間修飾名

getPrefix

String getPrefix()
この Name オブジェクトが初期化された際に、指定された接頭辞を返します。この接頭辞は Name オブジェクトが表す XML 名の名前空間に関連付けられています。

戻り値:
文字列の接頭辞

getURI

String getURI()
Name オブジェクトが表す XML 名の名前空間の URI を返します。

戻り値:
文字列の URI

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。