28.1 添付ファイル機能とは（wsi:swaRef形式）
添付ファイル機能とは，SOAPメッセージにテキストや画像（バイナリデータ）などのファイルを添付した添付ファイル付きSOAPメッセージを送受信する機能です。
次に示す例を基に，添付ファイル機能の概要について説明します。
|
|
![[図データ]](GRAPHICS/ZU170100.GIF)
SOAPメッセージにファイルを添付する場合，Webサービスを呼び出すJavaメソッドの引数に，javax.activation.DataHandlerクラスを使用します。ファイルを添付したJavaソースは，送信側のJAX-WSエンジンによってSOAPメッセージにマーシャルされ，受信側のJAX-WSエンジンによってJavaソースにアンマーシャルされます。受信側のJAX-WSエンジンは，アンマーシャルされたJavaソースのメソッドの引数から，添付ファイルを取得します。
なお，この機能は，WS-I Attachments Profile - Version 1.0仕様に従っているため，wsi:swaRef形式のWSDLを使用します。また，SOAP Messages with Attachmentsプロトコルを使用しているため，添付ファイル付きSOAPメッセージはMIME Multipart/Related構造でエンコードされます。
SAAJ 1.3仕様のAPIを使用して添付ファイル付きSOAPメッセージを送受信する場合は，「22.1 SAAJ 1.3仕様のサポート範囲」を参照してください。