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

インタフェースDetail

  • すべてのスーパー・インタフェース:
    Element, Node, Node, SOAPElement, SOAPFaultElement
    public interface Detail
extends SOAPFaultElement
    DetailEntryオブジェクトのコンテナ。 DetailEntryオブジェクトは、アプリケーション固有のエラー情報や、このオブジェクトを含むSOAPBodyオブジェクトに関連したエラー情報の詳細を示します。

    SOAPFaultオブジェクトの一部であるDetailオブジェクトは、SOAPFault.getDetailメソッドを使用して取得できます。 Detailのインタフェースには2つのメソッドがあります。 DetailEntryオブジェクトを新しく作成してDetailオブジェクトに自動的に追加するメソッドと、 Detailオブジェクトに含まれるDetailEntryオブジェクトのリストを取得するメソッドです。

    次のコードの抜粋(sfはSOAPFaultオブジェクト)は、Detailオブジェクト(d)を取得したあと、新しいDetailEntryオブジェクトをdに追加し、dのすべてのDetailEntryオブジェクトのリストを取得する方法を示しています。 また、このコードはaddDetailEntryメソッドに渡すNameオブジェクトも作成します。 Nameオブジェクトの作成に使用する変数seは、SOAPEnvelopeオブジェクトのことです。 

    
    Detail d = sf.getDetail();
    Name name = se.createName("GetLastTradePrice", "WOMBAT",
                                "http://www.wombat.org/trader");
    d.addDetailEntry(name);
    Iterator<DetailEntry> it = d.getDetailEntries();
    導入されたバージョン:
    1.6

    • メソッドの詳細

      • addDetailEntry

        DetailEntry addDetailEntry​(Name name)
                    throws SOAPException
        指定の名前でDetailEntryオブジェクトを新しく作成し、このDetailオブジェクトに追加します。
        パラメータ:
        name - 新しいDetailEntryオブジェクトを識別するNameオブジェクト
        戻り値:
        作成された新しいDetailEntryオブジェクト
        例外:
        SOAPException - このDetailオブジェクトにDetailEntryオブジェクトを追加するときに問題が発生した場合にスローされる。
        関連項目:
        addDetailEntry(QName qname)

      • addDetailEntry

        DetailEntry addDetailEntry​(QName qname)
                    throws SOAPException
        指定のQNameでDetailEntryオブジェクトを新しく作成し、このDetailオブジェクトに追加します。 このメソッドはNameを使用したものよりも優先します。
        パラメータ:
        qname - 新しいDetailEntryオブジェクトを識別するQNameオブジェクト
        戻り値:
        作成された新しいDetailEntryオブジェクト
        例外:
        SOAPException - このDetailオブジェクトにDetailEntryオブジェクトを追加するときに問題が発生した場合にスローされる。
        導入されたバージョン:
        1.6, SAAJ 1.3
        関連項目:
        addDetailEntry(Name name)

      • getDetailEntries

        Iterator<DetailEntry> getDetailEntries()
        このDetailオブジェクトのすべてのDetailEntryのIteratorを取得します。
        戻り値:
        このDetailオブジェクト内のDetailEntryオブジェクトのIteratorオブジェクト