javax.xml.ws.soap

クラスMTOMFeature

java.lang.Object

javax.xml.ws.WebServiceFeature

javax.xml.ws.soap.MTOMFeature

public final class MTOMFeature
extends WebServiceFeature

この機能は、WebサービスでのMTOMの使用を表します。この機能は、SEIプロキシ、クライアント側のDispatchインスタンスおよびサーバー側のEndpointインスタンスの作成時に使用できます。この機能はクライアント側のServiceインスタンスの作成には使用できません。

この機能を有効または無効にした場合の影響は次のとおりです。

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

thresholdプロパティを使用して、いつバイナリ・データをXOPでエンコードすべきかどうかを判定するためのしきい値を設定できます。

導入されたバージョン:

JAX-WS 2.1

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static String	ID MTOMFeatureを識別する定数です
protected int	threshold MTOMしきい値のプロパティです。

クラス javax.xml.ws.WebServiceFeatureから継承されたフィールド

enabled

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
MTOMFeature() MTOMFeatureを作成します。
MTOMFeature(boolean enabled) MTOMFeatureを作成します。
MTOMFeature(boolean enabled, int threshold) MTOMFeatureを作成します。
MTOMFeature(int threshold) MTOMFeatureを作成します。

メソッドのサマリー

修飾子と型	メソッドと説明
String	getID() このWebServiceFeatureの一意の識別子を取得します。
int	getThreshold() バイナリ・データを添付として送信すべきかどうかを判定するためのしきい値を取得します。

クラス javax.xml.ws.WebServiceFeatureから継承されたメソッド

isEnabled

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

ID

public static final String ID

MTOMFeatureを識別する定数です

関連項目:

定数フィールド値

threshold

protected int threshold

MTOMしきい値のプロパティです。このプロパティは、MTOMが有効になっている場合にヒントとして機能します。このサイズ(バイト単位)を超えるバイナリ・データは、添付として送信される必要があります。このプロパティの値は常に0以上でなければいけません。デフォルト値は0です。

コンストラクタの詳細

MTOMFeature

public MTOMFeature()

MTOMFeatureを作成します。作成されたインスタンスは有効になります。

MTOMFeature

public MTOMFeature(boolean enabled)

MTOMFeatureを作成します。

パラメータ:

enabled - この機能を有効にするかどうかを指定する

MTOMFeature

public MTOMFeature(int threshold)

MTOMFeatureを作成します。作成されたインスタンスは有効になります。

パラメータ:

threshold - 添付として送信すべきバイナリ・データのサイズ(バイト単位)。

例外:

WebServiceException - thresholdが0より小さい場合

MTOMFeature

public MTOMFeature(boolean enabled,
                   int threshold)

MTOMFeatureを作成します。

パラメータ:

enabled - この機能を有効にするかどうかを指定する

threshold - 添付として送信すべきバイナリ・データのサイズ(バイト単位)。

例外:

WebServiceException - thresholdが0より小さい場合

メソッドの詳細

getID

public String getID()

このWebServiceFeatureの一意の識別子を取得します。

定義:

getID、クラス: WebServiceFeature

戻り値:

この機能の一意の識別子。

getThreshold

public int getThreshold()

バイナリ・データを添付として送信すべきかどうかを判定するためのしきい値を取得します。

戻り値:

現在のしきい値サイズ(バイト単位)