16.2.11　javax.xml.bind.annotation.XmlMimeTypeアノテーション

javax.xml.bind.annotation.XmlMimeTypeアノテーションは，Java型とMIMEタイプの関連づけに使用されるJAXBのアノテーションで，javax.xml.ws.soap.MTOMアノテーションを使用する場合で，Java型とMIMEタイプを関連づけるときに使用します。

javax.xml.bind.annotation.XmlMimeTypeアノテーションは，SEIや暗黙のSEIがあるWebサービス実装クラスが持つサービスメソッドの引数，戻り値，またはユーザ定義型のgetterメソッドに指定できます。それ以外の個所（暗黙のSEIがないWebサービス実装クラスが持つサービスメソッドの引数，戻り値，ユーザ定義例外のフィールドなど）に指定した場合は動作が保証されません。

javax.xml.bind.annotation.XmlMimeTypeアノテーションをSEIなどにアノテートしている場合，Webサービス側のJAX-WSエンジンが発行するWSDLファイルやhwsgenコマンドが生成するWSDLファイルは，javax.xml.bind.annotation.XmlMimeTypeアノテーションをアノテートしたJava型に対応するスキーマの要素に，アノテーションのvalue要素に指定した値を持つxmime:expectedContentTypes属性が付与されます。

javax.xml.bind.annotation.XmlMimeTypeアノテーションを使用した例を次の図に示します。

図16‒19　javax.xml.bind.annotation.XmlMimeTypeアノテーションを使用した例

Java型とMIMEタイプを関連づけない場合，javax.xml.bind.annotation.XmlMimeTypeアノテーションをアノテートする必要はありません。そのとき，MTOM/XOP仕様形式の添付ファイルで送信されるメッセージの添付ファイルパートにあるContent-Typeフィールドの値は，Java型に対応する初期値が使用されます。

javax.xml.bind.annotation.XmlMimeTypeアノテーションを使用しない例を次の図に示します。

図16‒20　javax.xml.bind.annotation.XmlMimeTypeアノテーションを使用しない例

javax.xml.bind.annotation.XmlMimeTypeアノテーションをアノテートし，MIMEタイプを関連づけることができるJava型とその指定個所を次の表に示します。なお，それ以外の型にjavax.xml.bind.annotation.XmlMimeTypeアノテーションをアノテートした場合の動作は保証されません。

表16‒17　MIMEタイプを関連づけることができるJava型とその指定個所

項番	Java型	関連づけの可否	指定個所
			メソッド引数	メソッド戻り値	ユーザ定義型のフィールド	ユーザ定義例外のフィールド
1	java.awt.Image	○※1	○	○	△※2	×※3
2	javax.xml.transform.Source	○	○	○	△※2	×※3
3	javax.activation.DataHandler	○	○	○	△※2	×※3
4	java.awt.Imageの配列型	△※4	○	○	△※2	×※3
5	javax.activation.DataHandlerの配列型	△※4	○	○	△※2	×※3
6	java.util.List<Image>	○	○	○	△※2	×※3
7	java.util.List<DataHandler>	○	○	○	△※2	×※3
8	javax.xml.ws.Holder<Image>	○	○	×※5	×※5	×※5
9	javax.xml.ws.Holder<Source>	○	○	×※5	×※5	×※5
10	javax.xml.ws.Holder<DataHandler>	○	○	×※5	×※5	×※5

注※1

JAXB仕様に従います。java.awt.ImageクラスはJava SE仕様でのグラフィカルイメージを表現する抽象クラスで，データ形式の規定はありません。この関連づけを使用して画像データをインスタンス化した場合，具象クラスのインスタンスには復号化した情報だけが保持される可能性があります。そのため，JPEG形式のように符号化するときに情報が削減される可能性のある画像を添付ファイルとして送信する場合，受信側のインスタンスが送信側のインスタンスや元のデータと異なることがあります。

画像を元の形式のまま扱いたい場合は，javax.activation.DataHandlerにマッピングされるMIMEタイプ（application/octet-streamなど）を使用してください。

注※2

JavaプロパティにMIMEタイプを関連づける場合，javax.xml.bind.annotation.XmlMimeTypeアノテーションをgetterメソッドにアノテートしてください。フィールドおよびsetterメソッドにアノテートした場合，動作は保証されません。JavaプロパティにMIMEタイプを関連づける例を次に示します。

package com.sample;
 
import java.awt.Image;
 
public class UserData {
 
    private Image image;
 
    public void setImage(Image image) {
        this.image = image;
    }
 
    @javax.xml.bind.annotation.XmlMimeType("image/png")
    public Image getImage() {
        return image;
    }
}

注※3

ユーザ定義例外のフィールドにjavax.xml.bind.annotation.XmlMimeTypeアノテーションを指定した場合，動作は保証されません。

注※4

1次元配列だけ使用でき，多次元配列は使用できません。多次元配列を使用した場合，動作は保証されません。

注※5

Holder型は引数にだけ指定できます。戻り値には指定できません。

〈この項の構成〉

• (1)　value要素（javax.xml.bind.annotation.XmlMimeType）