パッケージ jakarta.xml.ws.soap

クラス MTOMFeature


  • public final class MTOMFeature
    extends WebServiceFeature
    この機能は、Web サービスでの MTOM の使用を表します。この機能は、SEI プロキシ、クライアント側の Dispatch インスタンス、サーバー側の Endpoint インスタンスの作成中に使用できます。この機能は、クライアント側での Service インスタンスの作成には使用できません。

    以下に、有効化または無効化に関するこの機能の影響について説明します。

    • ENABLED: このモードでは、MTOM が有効になります。受信者は最適化されていないメッセージと最適化されたメッセージの両方を受け入れる必要があり、送信者は最適化されたメッセージまたは最適化されていないメッセージを送信できます(MAY)。最適化を使用するかどうかを決定するために送信者が使用するヒューリスティックは、実装固有です。
    • DISABLED: このモードでは、MTOM は無効になります

    threshold プロパティを使用して、バイナリデータを XOP エンコードするタイミングを決定するために使用するしきい値を設定できます。

    導入:
    1.6、JAX-WS 2.1
    • コンストラクターの詳細

      • MTOMFeature

        public MTOMFeature()
        MTOMFeature を作成します。作成されたインスタンスが有効になります。
      • MTOMFeature

        public MTOMFeature​(boolean enabled)
        MTOMFeature を作成します。
        パラメーター:
        enabled - この機能を有効にするかどうかを指定します
      • MTOMFeature

        public MTOMFeature​(int threshold)
        MTOMFeature を作成します。作成されたインスタンスが有効になります。
        パラメーター:
        threshold - 添付ファイルとして送信される前に、バイナリデータが存在する必要があるバイト単位のサイズ。
        例外:
        WebServiceException - しきい値が 0 未満の場合
      • MTOMFeature

        public MTOMFeature​(boolean enabled,
                           int threshold)
        MTOMFeature を作成します。
        パラメーター:
        enabled - この機能を有効にするかどうかを指定します
        threshold - 添付ファイルとして送信される前に、バイナリデータが存在する必要があるバイト単位のサイズ。
        例外:
        WebServiceException - しきい値が 0 未満の場合
    • メソッドの詳細

      • getID

        public StringSE getID()
        クラスからコピーされた説明: WebServiceFeature
        この WebServiceFeature の一意の識別子を取得します。
        次で指定:
        クラス WebServiceFeaturegetID 
        戻り値:
        この機能の一意の識別子。
      • getThreshold

        public int getThreshold()
        バイナリデータを添付ファイルとして送信するタイミングを決定するために使用されるしきい値を取得します。
        戻り値:
        現在のしきい値サイズ(バイト単位)