インターフェース SOAPMessageContext

  • すべてのスーパーインターフェース:
    MapSE<StringSE,​ObjectSE>MessageContext

    public interface SOAPMessageContext
    extends MessageContext
    インターフェース SOAPMessageContext は、RPC リクエストまたはレスポンスの SOAP メッセージへのアクセスを提供します。jakarta.xml.soap.SOAPMessage は、添付ファイル付きの SOAP 1.1 メッセージを表すための標準 Java API を指定します。
    導入:
    1.6、JAX-WS 2.0
    関連事項:
    SOAPMessage
    • メソッドの詳細

      • getMessage

        SOAPMessage getMessage()
        このメッセージコンテキストから SOAPMessage を取得します。返された SOAPMessage を変更すると、メッセージがインプレースで変更されます。後で setMessage を呼び出す必要はありません。
        戻り値:
        SOAPMessage を返します。; このメッセージコンテキストに SOAPMessage が存在しない場合、null を返します
      • setMessage

        void setMessage​(SOAPMessage message)
        このメッセージコンテキストに SOAPMessage を設定します
        パラメーター:
        message - SOAP メッセージ
        例外:
        WebServiceException - このメッセージコンテキストでの SOAPMessage の設定中にエラーが発生した場合
        UnsupportedOperationExceptionSE - この操作がサポートされていない場合
      • getHeaders

        ObjectSE[] getHeaders​(QNameSE header,
                            JAXBContext context,
                            boolean allRoles)
        メッセージコンテキスト内のメッセージから特定の修飾名を持つヘッダーを取得します。SOAP メッセージには、同じ修飾名を持つ複数のヘッダーを含めることができることに注意してください。
        パラメーター:
        header - SOAP ヘッダーの XML 修飾名。
        context - ヘッダーのマーシャリングを解除するために使用する必要がある JAXBContext
        allRoles - true がすべての SOAP ロールのヘッダーを返す場合、false がこの SOAP ノードによって現在再生されているロールをターゲットとするヘッダーのみを返す場合は、getRoles を参照してください。
        戻り値:
        マーシャリングされていないヘッダーの配列。このメッセージコンテキストにメッセージが存在しない場合、または指定された修飾名に一致するヘッダーがない場合は、空の配列を返します。
        例外:
        WebServiceException - 付属の JAXBContext を使用してマーシャリングを解除するときにエラーが発生した場合。WebServiceException の原因は、元の JAXBException です。
      • getRoles

        SetSE<StringSE> getRoles()
        ハンドラーチェーンの実行に関連付けられた SOAP アクターロールを取得します。SOAP アクターのロールは SOAP ノードに適用され、SOAPBinding.setRoles(java.util.Set<java.lang.String>) および SOAPBinding.getRoles() を使用して管理されることに注意してください。ハンドラーチェーンの Handler インスタンスは、SOAP アクターロールに関するこの情報を使用して、SOAP ヘッダーブロックを処理します。ハンドラーチェーンを介した SOAP メッセージの処理中、SOAP アクターのロールは不変であることに注意してください。
        戻り値:
        SOAP アクターロールの String の配列