Cosminexus アプリケーションサーバ V8 Webサービス開発の手引
javax.xml.ws.soap.MTOMアノテーションは,MTOM/XOP仕様形式の添付ファイルを使用するWebサービスに指定します。
javax.xml.ws.soap.MTOMアノテーションはWebサービス実装クラスだけで指定できます。SEIに指定すると無視されます。また,プロバイダ実装クラス(javax.xml.ws.providerインタフェースを実装するクラス)に指定した場合は動作が保証されません。
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サービス開始時に参照されるだけです。aptコマンドまたはcjwsgenコマンドの実行時には解釈されません。
javax.xml.ws.soap.MTOMアノテーションを使用した例を次に示します。
・・・・・
@MTOM
@WebService(endpointInterface = "jaxwstp.example.service.ExamplePortType", targetNamespace = "http://service.example.jaxwstp/", serviceName = "ExampleService", portName = "ExamplePort")
public class ExampleBinding implements ExamplePortType {
|
enabled要素は,WebサービスでMTOM/XOP仕様形式の添付ファイルを使用するかどうかを指定します。"true"を指定した場合はMTOM/XOP仕様形式の添付ファイルが使用でき,"false"を指定した場合はMTOM/XOP仕様形式の添付ファイルが使用できません。デフォルト値は"true"です。
threshold要素は,WebサービスでMTOM/XOP仕様形式の添付ファイルが使用できるときに,バイナリデータをMTOM/XOP仕様形式の添付ファイルとして送信するためのしきい値です。javax.activation.DataHandlerクラス以外で,さらに指定された値を超えるバイナリデータ(threshold要素値<送信するデータのサイズ)の場合,MTOM/XOP仕様形式の添付ファイルとして送信されます。デフォルト値は"0"です。
All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.