ここでは,Javaインタフェース内で添付ファイルを指定するJava型について説明します。
Javaインタフェースでの添付ファイルのJava型の使用可否を次の表に示します。
添付ファイルに使用できるJava型には,javax.xml.bind.annotation.XmlAttachmentRefアノテーションを付加する必要があります。添付ファイルに使用できない型にこのアノテーションを付加した場合,動作は保証されません。
表28-1 添付ファイルとしてのJava型の使用可否
項番 | Java型 | 使用可否 |
---|---|---|
1 | javax.activation.DataHandler | ○ |
2 | javax.xml.ws.Holder<DataHandler> | ○ |
3 | javax.activation.DataHandlerの配列型 | △ |
4 | javax.xml.ws.Holder<DataHandler>の配列型 | × |
5 | javax.activation.DataHandlerを継承したデータ型 | × |
添付ファイルは,Javaインタフェースのメソッド引数,メソッド戻り値,およびユーザ定義型のフィールドで指定できます。ユーザ定義例外では指定できません。
Javaインタフェース内での添付ファイルの指定個所と,Java型の指定可否を次の表に示します。
表28-2 添付ファイルのJava型の指定個所と指定可否
項番 | Javaインタフェースでの指定個所 | 添付ファイルのJava型 | 指定可否 |
---|---|---|---|
1 | メソッド引数 | javax.activation.DataHandler | ○ |
2 | javax.xml.ws.Holder<DataHandler> | ○ | |
3 | javax.activation.DataHandlerの配列型 | △ | |
4 | メソッド戻り値 | javax.activation.DataHandler | ○ |
5 | javax.xml.ws.Holder<DataHandler> | × | |
6 | javax.activation.DataHandlerの配列型 | △ | |
7 | ユーザ定義型のフィールド | javax.activation.DataHandler | ○ |
8 | javax.xml.ws.Holder<DataHandler> | × | |
9 | javax.activation.DataHandlerの配列型 | △ | |
10 | ユーザ定義例外のフィールド | javax.activation.DataHandler | × |
11 | javax.xml.ws.Holder<DataHandler> | × | |
12 | javax.activation.DataHandlerの配列型 | × |
javax.activation.DataHandler型は,JavaBeans Activation Framework(JAF)の型であるため,任意のMIMEタイプの添付ファイルを指定できます。添付ファイルの拡張子と,デフォルトで設定されるMIMEタイプのマッピングについては,「28.4.2(3) 添付ファイルの拡張子とMIMEタイプのマッピング」を参照してください。