JAXBガイド

@XmlRootElement(name = "book")
@XmlType(propOrder = { "id", "name", "date" })
public class Book {
    private Long id;
    private String name;
    private String author;
    private Date date;

    @XmlAttribute
    public void setId(Long id) {
        this.id = id;
    }

    @XmlElement(name = "title")
    public void setName(String name) {
        this.name = name;
    }

    @XmlTransient
    public void setAuthor(String author) {
        this.author = author;
    }

   //constructor, getters and setters
}

public void marshal() throws JAXBException, IOException {
    Book book = new Book();
    book.setId(1L);
    book.setName("Book1");
    book.setAuthor("Author1");
    book.setDate(new Date());

    JAXBContext context = JAXBContext.newInstance(Book.class);
    Marshaller mar= context.createMarshaller();
    mar.setProperty(Marshaller.JAXB__FORMATTED__OUTPUT, Boolean.TRUE);
    mar.marshal(book, new File("./book.xml"));
}

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<book id="1">
    <title>Book1</title>
    <date>2016-11-12T11:25:12.227+07:00</date>
</book>

public Book unmarshall() throws JAXBException, IOException {
    JAXBContext context = JAXBContext.newInstance(Book.class);
    return (Book) context.createUnmarshaller()
      .unmarshal(new FileReader("./book.xml"));
}

Book[id=1, name=Book1, author=null, date=Sat Nov 12 11:38:18 ICT 2016]----

===  **  6. ** 複雑なデータ型

JAXBでは直接利用できない可能性がある複雑なデータ型を処理する場合、JAXBに特定の型の管理方法を指示するためのアダプタを作成することがあります。

JAXBの__XmlAdapter__を使用して、マッピング不可能なクラスをJAXBが処理できるものに変換するためのカスタムコードを定義できます。 __ @ XmlJavaTypeAdapter__アノテーションは、カスタムマーシャリング用に__XmlAdapter__クラスを拡張するアダプタを使用します。

マーシャリング時に日付形式を指定するためのアダプタを作成しましょう。

[source,java,gutter:,true]

整列化するときに__Date__を__String__に変換するには日付形式「__yyyy-MM-dd HH:mm:ss__」を使用し、__DateFormat__をスレッドセーフにするには__ThreadLocal__を使用します。

__DateAdapter__を__Book__に適用しましょう。

[source,java,gutter:,true]

上記のコードを実行すると、__book.xml__の結果を確認して、新しい日付形式 "__yyyy-MM-dd HH:mm:ss__"を使用してJavaオブジェクトをXMLに正常に変換したことを確認できます。

[source,xml,gutter:,true]

===  **  7.  JAXB-2 Mavenプラグイン+

**

このプラグインはXMLバインディング用Java API（JAXB）バージョン2を使用して、XMLスキーマ（およびオプションでバインディングファイル）からJavaクラスを生成したり、注釈付きのJavaクラスからXMLスキーマを作成したりします。

Webサービスを構築するための2つの基本的なアプローチ、__最後の契約__と__最初の契約__があることに注意してください。これらのアプローチの詳細については、以下のhttp://docs.spring.io/spring-ws/site/reference/html/why-contract-first.html[link]をチェックしてください。

====  **  7.1.  XSD ** からJavaクラスを生成する

JAXB-2 Mavenプラグインは、JDK提供のツールXJC、XSD（XML Schema Definition）からJavaクラスを生成するJAXBバインディングコンパイラツールを使用します。

単純な__user.xsd__ファイルを作成し、JAXB-2 Mavenプラグインを使用してこのXSDスキーマからJavaクラスを生成しましょう。

[source,xml,gutter:,true]

JAXB-2 Mavenプラグインを設定しましょう。

[source,xml,gutter:,true]

デフォルトでは、このプラグインは__src/main/xsd__にあるXSDファイルを見つけます。それに応じて__pom.xml__のこのプラグインの設定セクションを変更することでXSD検索を設定することができます。

デフォルトでは、これらのJavaクラスは__target/generated-resources/jaxb__フォルダーに生成されます。プラグイン設定に__outputDirectory__要素を追加することで出力ディレクトリを変更することができます。このディレクトリ内のファイルが消去されないように、falseの値を持つ__clearOutputDir__要素を追加することもできます。

デフォルトのバインディング規則をオーバーライドするグローバルJAXBバインディングを設定することもできます。

[source,xml,gutter:,true]

上記の__global.xjb__は、__dateTime__タイプを__java.util.Calendar__タイプにオーバーライドします。 +プロジェクトをビルドすると、__src/main/java__フォルダーとパッケージ__com.baeldung.jaxb.gen__にクラスファイルが生成されます。

====  **  7.2.  Java ** からXSDスキーマを生成する

同じプラグインがJDK提供のツール__Schemagen__を使用しています。これは、JavaクラスからXSDスキーマを生成できるJAXBバインディングコンパイラツールです。

JavaクラスがXSDスキーマ候補に適格となるためには、クラスに__ @ XmlType__アノテーションを付けなければなりません。

前の例のJavaクラスファイルを再利用します。プラグインを設定しましょう。

[source,xml,gutter:,true]

デフォルトでは、JAXBは注釈付きのJAXBクラスについて、__src/main/java__の下のすべてのフォルダを再帰的にスキャンします。プラグイン構成に__source__要素を追加することで、JAXBアノテーション付きクラスに別の__source__フォルダーを指定できます。

XSDスキーマの命名を担当するポストプロセッサ__transformSchemas__を登録することもできます。これは、__namespace__をJavaクラスの__ @ XmlType__の名前空間と照合することによって機能します。

プロジェクトをビルドすると、__src/main/resources__ディレクトリに__user-gen.xsd__ファイルが生成されます。

===  **  8. **  ** 結論**

この記事では、JAXBの概要について説明しました。詳細については、http://www.oracle.com/technetwork/articles/javase/index-140168.html[JAXB home page]を参照してください。

この記事のソースコードはhttps://github.com/eugenp/tutorials/tree/master/jaxb[GitHub]にあります。