パッケージ jakarta.xml.ws

インターフェース BindingProvider

  • すべての既知のサブインターフェース:
    Dispatch<T>
    public interface BindingProvider
    BindingProvider インターフェースは、リクエストおよびレスポンスメッセージ処理のためのプロトコルバインディングおよび関連するコンテキストオブジェクトへのアクセスを提供します。
    導入:
    1.6、JAX-WS 2.0
    関連事項:
    Binding

    • フィールドの詳細

      • USERNAME_PROPERTY

        static final StringSE USERNAME_PROPERTY
        標準プロパティ: 認証用のユーザー名。

        タイプ: java.lang.String

        関連事項:
        定数フィールド値

      • PASSWORD_PROPERTY

        static final StringSE PASSWORD_PROPERTY
        標準プロパティ: 認証用のパスワード。

        タイプ: java.lang.String

        関連事項:
        定数フィールド値

      • ENDPOINT_ADDRESS_PROPERTY

        static final StringSE ENDPOINT_ADDRESS_PROPERTY
        標準プロパティ: ターゲットサービスエンドポイントアドレス。エンドポイントアドレス仕様の URI スキームは、使用中のバインディングのプロトコル / トランスポートバインディングに対応しなければなりません。

        タイプ: java.lang.String

        関連事項:
        定数フィールド値

      • SESSION_MAINTAIN_PROPERTY

        static final StringSE SESSION_MAINTAIN_PROPERTY
        標準プロパティ: このブール値プロパティは、サービスクライアントがサービスエンドポイントとのセッションに参加するかどうかを示すために使用します。このプロパティが true に設定されている場合、サービスクライアントはセッションを維持する必要があることを示します。false に設定すると、セッションは維持されません。このプロパティのデフォルト値は false です。

        タイプ: java.lang.Boolean

        関連事項:
        定数フィールド値

      • SOAPACTION_USE_PROPERTY

        static final StringSE SOAPACTION_USE_PROPERTY
        SOAPAction の標準プロパティ。このブール値プロパティは、jakarta.xml.ws.soap.http.soapaction.uri プロパティの値が SOAPAction の値に使用されるかどうかを示します。このプロパティのデフォルト値は false であり、jakarta.xml.ws.soap.http.soapaction.uri プロパティが SOAPAction の値に使用されないことを示します。ただし、WS-Addressing が有効な場合、デフォルト値は true です。

        タイプ: java.lang.Boolean

        関連事項:
        定数フィールド値

      • SOAPACTION_URI_PROPERTY

        static final StringSE SOAPACTION_URI_PROPERTY
        SOAPAction の標準プロパティ。jakarta.xml.ws.soap.http.soapaction.use プロパティが true に設定されている場合の SOAPAction URI を示します。WS-Addressing が有効になっている場合、この値は WS-Addressing アクションヘッダーの値にも使用されます。このプロパティが設定されていない場合、デフォルトの SOAPAction および WS-Addressing アクションが送信されます。

        タイプ: java.lang.String

        関連事項:
        定数フィールド値

    • メソッドの詳細

      • getRequestContext

        MapSE<StringSE,​ObjectSE> getRequestContext()
        リクエストメッセージのメッセージコンテキストを初期化するために使用されるコンテキストを取得します。リクエストコンテキストへの変更は、すでに開始されている同期または非同期操作のメッセージコンテキストには影響しません。
        戻り値:
        リクエストメッセージの処理に使用されるコンテキスト。

      • getResponseContext

        MapSE<StringSE,​ObjectSE> getResponseContext()
        レスポンスメッセージの処理の結果生じたコンテキストを取得します。返されるコンテキストは、最後に完了した同期操作のものです。後続の同期操作の呼び出しは、レスポンスコンテキストを上書きします。非同期操作は、Response インターフェースを介してレスポンスコンテキストを返します。
        戻り値:
        最新のレスポンスメッセージを処理した結果のコンテキスト。

      • getBinding

        Binding getBinding()
        このバインディングプロバイダーのバインディングを取得します。
        戻り値:
        このバインディングプロバイダーの Binding。

      • getEndpointReference

        EndpointReference getEndpointReference()
        この BindingProvider インスタンスに関連付けられている EndpointReference を返します。

        この bindingProvider のバインディングが SOAP1.1/HTTP または SOAP1.2/HTTP の場合、W3CEndpointReference を返さなければなりません。

        戻り値:
        この BindingProvider インスタンスに関連付けられているターゲットエンドポイントの EndpointReference。
        例外:
        UnsupportedOperationExceptionSE - この BindingProvider が XML/HTTP バインディングを使用する場合。
        導入:
        1.6、JAX-WS 2.1
        関連事項:
        W3CEndpointReference

      • getEndpointReference

        <T extends EndpointReference> T getEndpointReference​(ClassSE<T> clazz)
        この BindingProvider インスタンスに関連付けられた EndpointReference を返します。返されるインスタンスの型は clazz です。
        型パラメーター:
        T - EndpointReference の型
        パラメーター:
        clazz - 返さなければならない EndpointReference の型を指定します。
        戻り値:
        この BindingProvider インスタンスに関連付けられているターゲットエンドポイントの EndpointReference。型 clazz でなければなりません。
        例外:
        WebServiceException - クラス clazz がこの実装でサポートされていない場合。
        UnsupportedOperationExceptionSE - この BindingProvider が XML/HTTP バインディングを使用する場合。
        導入:
        1.6、JAX-WS 2.1