javax.xml.ws.soap.MTOMアノテーションは,MTOM/XOP仕様形式の添付ファイルを使用するWebサービスに指定します。
javax.xml.ws.soap.MTOMアノテーションについて,次に説明します。
cjwsimportコマンドが生成するWebサービス実装クラスのスケルトンクラスを使用してMTOM/XOP仕様形式の添付ファイルを使用するWebサービスを作成する場合,Webサービス実装クラスのスケルトンクラスにはjavax.xml.ws.soap.MTOMアノテーションをマッピングしないので,javax.xml.ws.soap.MTOMアノテーションを指定する必要があります。なお,Webサービス実装クラスにjavax.xml.ws.soap.MTOMアノテーションを指定しても,Webサービス側のJAX-WSエンジンが発行するWSDLファイルやcjwsgenコマンドが生成するWSDLファイルには,MTOM/XOP仕様形式の添付ファイルが使用されていることを示す要素や属性は出現しません。
javax.xml.ws.soap.MTOMアノテーションは,Webサービス開始時に参照されるだけです。cjaptコマンドまたはcjwsgenコマンドの実行時には解釈されません。
Webサービス側でjavax.xml.ws.soap.MTOMアノテーションを使用した例を次に示します。
・・・・・ |
enabled要素は,WebサービスでMTOM/XOP仕様形式の添付ファイルを使用するかどうかを指定します。"true"を指定した場合はMTOM/XOP仕様形式の添付ファイルが使用でき,"false"を指定した場合はMTOM/XOP仕様形式の添付ファイルが使用できません。デフォルト値は"true"です。
threshold要素は,WebサービスでMTOM/XOP仕様形式の添付ファイルが使用できるときに,バイナリデータをMTOM/XOP仕様形式の添付ファイルとして送信するためのしきい値です。javax.activation.DataHandlerクラス以外で,さらに指定された値を超えるバイナリデータ(threshold要素値≦送信するデータのサイズ)の場合,MTOM/XOP仕様形式の添付ファイルとして送信されます。デフォルト値は"0"です。