Interstage Studio プログラマーズガイド

5.2.6 Webサービスで添付ファイルを利用する

Webサービスアプリケーションで添付ファイルの送受信ができます。WS-I Attachments Profile 1.0に準拠したアプリケーションの開発も可能です。

++添付ファイルを利用できる型

サービスエンドポイントインタフェースのサポート型として、添付ファイルで利用する、以下の型を指定します。

• javax.activation.DataHandler
• java.awt.Image
• javax.mail.internet.MimeMultipart
• javax.xml.transform.Source

javax.activation.DataHandler以外のクラスは、バイナリからJavaオブジェクトへ変換が行われるためオリジナルのファイルデータが完全には保持されません。Interstage Application Serverでは、バイナリのストリームをそのまま保持するjavax.activation.DataHandlerの使用を推奨しています。

++WS-I Attachments Profile 1.0に準拠したアプリケーションの開発

WS-I Attachments Profile 1.0に準拠したアプリケーションの開発には2とおりがあります。以下に従って開発します。

1)添付ファイルで利用する型としてjavax.activation.DataHandlerを利用する場合

• 添付ファイルで利用する型として、javax.activation.DataHandlerを利用する
• WebサービスウィザードのWSDL関連情報ページの[添付ファイル]で、[WS-I Attachments Profile 1.0準拠のWSDLファイルを生成]を指定する

2) 添付ファイルで利用する型としてjavax.activation.DataHandlerを利用しない場合

• 添付ファイルで利用する型として、以下のどれかを指定する
  • java.awt.Image
  • javax.mail.internet.MimeMultipart
  • javax.xml.transform.Source
• 添付ファイルとして利用する型をサービスエンドポイントインタフェースの引数および復帰値として宣言する
• WebサービスウィザードのWSDL関連情報ページの[style属性/use属性]で、[RPC/LITERAL]または[RPC/ENCODED]を指定する
• WebサービスウィザードのWSDL関連情報ページの[添付ファイル]で、[WS-I Attachments Profile 1.0準拠のWSDLファイルを生成]を指定する

WebサービスウィザードのWSDL関連情報ページの[添付ファイル]で、[WS-I Attachments Profile 1.0準拠のWSDLファイルを生成]を指定した場合に、WS-I Attachments Profile 1.0準拠の条件に合わない場合は、エラーが発生します。その場合は、WS-I Attachments Profile1.0に準拠したアプリケーションが生成されるように設定を変更してください。WS-I Attachments Profile1.0準拠としない場合は、[固有データ型を使用したWSDLファイル生成]を選択してください。