本文書は、Henrik Kniberg氏による文書、「塹壕よりScrumとXP（Scrum and XP from the Trenches)」を日本語へ訳したものです。
Kniberg氏はスウェーデンのCRISP社に所属する、Javaによる開発やアジャイル方法論のコンサルタントです。
本文書では、Kniberg氏がScrumとXPを組み合わせて組織やプロジェクトへ適用した際の苦労や工夫を見ることができます。特に計画の立て方や見積の実際など、実践が難しい部分を非常に詳しく例示して説明してくれているため、Scrumやアジャイル開発を実践するヒントを求めている方には大きな助けとなるのではないでしょうか。

本文書はもともと社内の一部部署での情報共有のために訳したものでしたが、とても興味深く面白い内容であったため、Kniberg氏の許可を得て公開させて頂きました。
原文の最新版はInfoQからダウンロードすることができます。訳が杜撰で判りづらい部分もあるかと思いますので、おかしな部分や誤訳などにお気づきの場合は、訳者(goto@mamezou.com)までお知らせ頂ければ幸いです。

(2008/07/07更新）

• 誤字/脱字を修正しました
• オリジナルへのポインタや配布元の情報を加えました

◆Scrum and XP from the Trenches v.2.2　日本語訳（PDF)ダウンロード
http://mamezou.net/modules/xfsection/downloads/ScrumAndXpFromTrenches.pdf

◆Henrik Kniberg氏のサイト
http://www.crisp.se/henrik.kniberg/

◆InfoQのScrum And XP From The Trenchesのページ
http://www.infoq.com/minibooks/scrum-xp-from-the-trenches

以下に、特定単語の対訳や意図を示します。

JAXB 2 で XML データバインディング (1)

1. JAXB とは

JAXB とは、Java Architecture for Xml Binding の略称で、XML データと Java オブジェクトの相互変換を実現するためのテクノロジです。Sun Microsystems 社によって仕様策定・実装がされており、現時点で最新の Java SE 6 Update 4 では、JAXB 2.1 がインプリメントされています。(Sun Microsystems 社による JAXB のアーキテクチャ説明)

旧バージョン (1.x 系) では、XML スキーマからバインディング対象の Java オブジェクトを生成する方法しかありませんでしたが、新バージョン (2.x 系) では、アノテーションの採用により、バインディング対象の Java オブジェクトから XML スキーマを生成することも可能となりました。Java SE 6 からは標準 API (javax.xml.bind.*) となっているため、特別なキットをインストールする必要はありません。

旧バージョンでは、XML スキーマから Java オブジェクトを生成すると、膨大な量のクラスが生成されていましたが、新バージョンでは最低限のクラスだけを生成・必要としているため、軽量化、高速化が図られています。

1.1. JAXB を使うと何が嬉しい？

さて、JAXB にはいったいどんなメリットがあるのでしょうか。ざっと以下のものがあります。

1. Java 標準である。
   → Java SE 6 からは JDK に標準機能として搭載されているので、外部プロダクトの使用を嫌う顧客にも導入し易い。
2. W3C の XML スキーマをフルサポートしている。
   
3. XML データ構造やデータ値などの、正当性チェックの全て (もしかしたら一部例外あり？) を JAXB に委譲することが出来る。
   → XML スキーマに準拠していないデータを変換しようとすると、JAXB から例外が送出されるので、アプリ側でチェック機構を実装しなくて済む。
4. 独自の XML パーサを実装する必要がない (車輪の再開発が不要)。
   → 実装コスト、テストコストを大きく削減しつつ、高品質を保つことが出来る。
5. XML データ構造に変更があっても、XML パーサに影響を及ぼさない。
   → XML パーサの改修が不要なので、仕様変更や機能拡張に柔軟に対応出来る。

では、JAXB 2 はJAXB 1.x 系と比較してどのような点で利点があるのでしょうか。

1. 実行時に必要なクラス数が劇的に減らされたため、ヒープ領域の軽減が図られた。
2. JAXP 1.3 の XML スキーマ検証機能に置き換えられた (UnMarshaller#setValidating() メソッドが非推奨 (Deprecated) となった)。
3. javax.xml.bind.annotation パッケージ内のアノテーションを用いることで、Java オブジェクトから XML スキーマを生成出来るようになった。
4. XML スキーマに完全準拠したため、より使い易くなり、トリッキーな XML 構造を定義しなくて良くなった。
5. JDK 標準搭載となったため、JAXP や Xerces のバージョン違いによる競合が起こり難くなり、より簡単にシステムに導入し易くなった。

では、概要はこのくらいにして進めて行きましょう。

2. 必要な環境

• Java SE 6

本記事では Update 4 を使用します。インストール方法については他のサイトを参考にしてください。

環境変数 (JAVA_HOME) に ${インストールフォルダ} を、環境変数 (path) に %JAVA_HOME%\bin を忘れずに追加してください。

3. 本記事の構成

本記事では少しずつ段階を踏んで解説していきたいと思います。『そんなの知ってるよ』という方は読み飛ばしてください。また、本記事は『JAXB 2 の具体的な使用方法』に重点を置いていますので、JAXB 2 の詳細なアーキテクチャについては言及していません。適宜 JavaDoc (link) を参照して確認してみてください。

注意:XML スキーマの詳細な仕様解説は割愛しています。

4. とりあえず何も考えずに動かしてみよう

まず、複雑なことは一切考えずに以下のプログラムをコーディングして実行してみましょう。

import java.util.Calendar;

import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlType;

@XmlAccessorType(XmlAccessType.FIELD)
@XmlRootElement(name="BookOrder")
@XmlType(propOrder={"title", "category", "author", "price", "publisher", "publishDate"})
public class BookOrder {
    @XmlElement(name="Title")
    private String title;

    @XmlElement(name="Category")
    private String category;

    @XmlElement(name="Author")
    private String author;

    @XmlElement(name="Price")
    private int price;

    @XmlElement(name="Publisher")
    private String publisher;

    @XmlElement(name="PublishDate")
    private Calendar publishDate;

    〜 アクセッサは略 〜
}
                

import java.io.File;
import java.text.SimpleDateFormat;

import javax.xml.bind.JAXBContext;
import javax.xml.bind.Marshaller;
import javax.xml.bind.Unmarshaller;

public class Main {
    public static void main(String[] args) throws Exception {
        // BookOrder クラスをバインディングするコンテキストを生成
        JAXBContext context = JAXBContext.newInstance(BookOrder.class);

        // XML -> POJO 変換を行うアンマーシャラを生成
        Unmarshaller um = context.createUnmarshaller();
        
        // XML -> POJO 変換
        BookOrder book = (BookOrder)um.unmarshal(new File("[in]SimpleBookOrder.xml"));
        
        System.out.println("タイトル  : " + book.getTitle());
        System.out.println("カテゴリ  : " + book.getCategory());
        System.out.println("著者      : " + book.getAuthor());
        System.out.println("価格(税込): " + book.getPrice());
        System.out.println("出版社    : " + book.getPublisher());
        System.out.println("発売日    : " + new SimpleDateFormat("yyyy/MM/dd").
                                                    format(book.getPublishDate().getTime()));
        // POJO -> XML 変換を行うマーシャラを生成
        Marshaller ma = context.createMarshaller();

        // POJO -> XML 変換
        ma.marshal(book, new File("[out]SimpleBookOrder.xml"));
    }
}
                

<?xml version="1.0" encoding="UTF-8"?>
<BookOrder>
    <Title>豆蔵セミナーライブオンテキスト(1) わかるオブジェクト指向</Title>
    <Category>オブジェクト指向</Category>
    <Author>山田 隆太</Author>
    <Price>2604</Price>
    <Publisher>技術評論社</Publisher>
    <PublishDate>2005-07-29T00:00:00+09:00</PublishDate>
</BookOrder>
                

さて実行してみましょう。XML データがコンソールに出力され、[out]SimpleBookOrder.xml には XML データが出力されているはずです。出力結果は以下の様になります。

タイトル  : 豆蔵セミナーライブオンテキスト(1) わかるオブジェクト指向
カテゴリ  : オブジェクト指向
著者      : 山田 隆太
価格(税込): 2604
出版社    : 技術評論社
発売日    : 2005/07/29
                

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><BookOrder><Title>豆蔵セミナーライブオンテキスト(1) 
わかるオブジェクト指向</Title><Category>オブジェクト指向</Category><Author>山田 隆太</Author><Price>2604
</Price><Publisher>技術評論社</Publisher><PublishDate>2005-07-29T00:00:00+09:00</PublishDate></BookOrder>
                

どうですか？複雑な処理は一切コーディングすることなく、簡単に XML データ⇔Java オブジェクト変換が行えました。それでは少しずつ JAXB 2 を理解、楽しんでいきましょう。

4.1. JAXB 2 主要クラス

それでは、JAXB 2 の主要クラスから見ていきましょう。JAXB 2 は主に JAXBContext, Unmarshaller, Marshaller から構成されており、それぞれ次のような機能を持ちます。

JAXB 2 主要クラス

では次に、ここで使用している JAXB 2 のアノテーションを見ていきましょう。

4.1 @XmlRootElement

XML のルート要素となり得るクラスに付与します。name 属性には XML 要素名を指定します。グローバル宣言された xs:element に対応します。

4.2 @XmlElement

XML の要素となり得るクラスに付与します。name 属性には XML 要素名を指定します。ローカル宣言された xs:element に対応します。

4.3 @XmlType

XML の要素型となり得るクラスに付与します。xs:complexType に対応します。ここでは指定していませんが、name 属性で型名を指定することが出来ます。propOrder 属性には @XmlElement が付与されたフィールドの出現順序を フィールド名 で指定します。

4.4 @XmlAccessorType

XML データとバインドする対象 (フィールドやプロパティ (アクセッサメソッド)) を指定します。ここでは XmlAccessType.FIELD を指定しているので、フィールドの宣言を基に XML データをバインドします。

XML データとバインドする必要がないフィールドに対しては、@XmlTransient を付与します。

JAXB 2 で XML データバインディング (2)

5. スキーマ検証をしてみよう

さきほどの例で、[in]SimpleBookOrder.xml の要素順序を変えて (Category 要素を Title 要素の前に移動するなど) もう一度実行してみましょう。

ちゃんと動いたでしょうか？動きますね。さきほど @XmlType の propOrder 属性で出現順序を指定すると言いました。にも関わらず、要素の出現順序を変えても動いてしまうのはなぜでしょう？XML はデータの構成 (出現順序や出現回数) を厳密に定義出来ることもメリットのひとつであるので、これでは困ってしまいます。

いきなり理由を書くと、JAXB 2 はデフォルトでは XML スキーマとの検証を 行わない からです。これは当然と言えば当然です。さきほどの例では XML スキーマを作成しませんでしたね。JAXB 2 は動的にアノテーションから XML スキーマを生成・検証するということはしてくれません。

『え！？じゃぁ結局スキーマを作成しなきゃならないじゃん。(- -;』と思った方。大丈夫です。JAXB 2 には、『schemagen』というツールが付属されており、(アノテーションが付与された) Java オブジェクトから XML スキーマを 自動生成 することが出来ます。

それではさっそく、XML スキーマを作成して確認してみましょう。

コマンドプロンプトを開いて、以下のコマンドを入力し実行してください。

カレントフォルダ (ここでは C:\) に schema1.xsd というファイルが出力されていると思います。生成されたスキーマは以下の様になっていると思います。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="BookOrder" type="bookOrder"/>

  <xs:complexType name="bookOrder">
    <xs:sequence>
      <xs:element name="Title" type="xs:string" minOccurs="0"/>
      <xs:element name="Category" type="xs:string" minOccurs="0"/>
      <xs:element name="Author" type="xs:string" minOccurs="0"/>
      <xs:element name="Price" type="xs:int"/>
      <xs:element name="Publisher" type="xs:string" minOccurs="0"/>
      <xs:element name="PublishDate" type="xs:dateTime" minOccurs="0"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>
            

XML スキーマが作成出来たら、次は先ほどの Main.java を以下のように修正します。

〜 package, imports は略 〜

public class Main {
    public static void main(String[] args) throws Exception {
        JAXBContext context = JAXBContext.newInstance(BookOrder.class);

        // 検証に使用するスキーマを生成 (*1)
        SchemaFactory schemaFactory = SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI);
        Schema schema = schemaFactory.newSchema(new File("ValidationSchema.xsd"));

        Unmarshaller um = context.createUnmarshaller();

        // アンマーシャル時に使用する検証スキーマを設定 (*2)
        um.setSchema(schema);

        BookOrder book = (BookOrder)um.unmarshal(new File("[in]ValidateBookOrder.xml"));

        〜 System.out.println は略 〜

        Marshaller ma = context.createMarshaller();
        
        // マーシャル時に使用する検証スキーマを設定 (*3)
        ma.setSchema(schema);

        ma.marshal(book, new File("[out]ValidateBookOrder.xml"));
    }
}
            

• (*1) では、ValidationSchema.xsd を基に Schema オブジェクトを生成しています。これは、スキーマの外部表現を読み取り、検証するための準備となります。ちなみに、SchemaFactory はスレッドセーフではないため、注意が必要です。
• (*2) では、アンマーシャル時に使用する検証スキーマを設定しています。スキーマに準拠していない XML データをアンマーシャルしようとすると (Unmarshaller#unmarshal() メソッドを呼び出すと) 例外 (javax.xml.bind.UnmarshalException) が送出されます。
• (*3) では、同様にマーシャル時に使用する検証スキーマを設定しています。

それでは、[in]SimpleBookOrder.xml の要素順序を変えて (ここでは、要素順序を変えた XML を [in]ValidationBookOrder.xml に名前を変えています) もう一度実行してみましょう。今度は例外が送出されるはずです。厳密な XML データ変換を行いたい場合は、このようにスキーマを生成してから行うことで、アプリケーションによるデータ正当性の確認ロジックを JAXB 2 に委譲することが出来ます。

<?xml version="1.0" encoding="UTF-8"?>
<BookOrder>
    <Category>オブジェクト指向</Category>
    <Title>豆蔵セミナーライブオンテキスト(1) わかるオブジェクト指向</Title>
    <Author>山田 隆太</Author>
    <Price>2604</Price>
    <Publisher>技術評論社</Publisher>
    <PublishDate>2005-07-29T00:00:00+09:00</PublishDate>
</BookOrder>
            

Exception in thread "main" javax.xml.bind.UnmarshalException
 - with linked exception:
[org.xml.sax.SAXParseException: cvc-complex-type.2.4.a: Invalid content was found starting with element 'Title'.
 One of '{Author, Price}' is expected.]
    at javax.xml.bind.helpers.AbstractUnmarshallerImpl.createUnmarshalException(Unknown Source)
    at com.sun.xml.internal.bind.v2.runtime.unmarshaller.UnmarshallerImpl.createUnmarshalException(Unknown Source)
    at com.sun.xml.internal.bind.v2.runtime.unmarshaller.UnmarshallerImpl.unmarshal0(Unknown Source)
    at com.sun.xml.internal.bind.v2.runtime.unmarshaller.UnmarshallerImpl.unmarshal(Unknown Source)
    at javax.xml.bind.helpers.AbstractUnmarshallerImpl.unmarshal(Unknown Source)
    at javax.xml.bind.helpers.AbstractUnmarshallerImpl.unmarshal(Unknown Source)
    at javax.xml.bind.helpers.AbstractUnmarshallerImpl.unmarshal(Unknown Source)
    at javax.xml.bind.helpers.AbstractUnmarshallerImpl.unmarshal(Unknown Source)
    at com.mamezou.jaxb2.validate.Main.main(Main.java:28)
〜 略 〜
            

6. 繰り返し定義をしてみよう

今度は繰り返し要素の定義をしてみましょう。例えば書籍だと共著ということがありますね。ここでは、Author 要素を繰り返し記述出来るようにしてみます。繰り返し要素を定義するには、該当のフィールド (ここでは BookOrder#author フィールド) を配列、または List で定義します。

修正したら schemagen ツールで XML スキーマを作成してみましょう。生成したスキーマは次の様になっていると思います。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="BookOrder" type="bookOrder"/>

  <xs:complexType name="bookOrder">
    <xs:sequence>
      <xs:element name="Title" type="xs:string" minOccurs="0"/>
      <xs:element name="Category" type="xs:string" minOccurs="0"/>
      <xs:element name="Author" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
      <xs:element name="Price" type="xs:int"/>
      <xs:element name="Publisher" type="xs:string" minOccurs="0"/>
      <xs:element name="PublishDate" type="xs:dateTime" minOccurs="0"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>
            

Author 要素の maxOccurs 属性 (最大出現回数) が unbounded (無制限) になっていますね。これで完了です。それでは入力となる XML ファイルに Author 要素を複数回記述してみましょう。例えば以下のようになります (適宜改行しています)。

<?xml version="1.0" encoding="UTF-8"?>
<BookOrder>
  <Title>豆蔵セミナーライブオンテキスト(3) Java・オブジェクト指向の壁を突破する 抽象化プログラミング入門 
-UMLからJavaへ、すらすらコーディングできますか? </Title>
  <Category>オブジェクト指向</Category>
  <Author>岡村 敦彦</Author>
  <Author>山田 隆太</Author>
  <Price>2604</Price>
  <Publisher>技術評論社</Publisher>
  <PublishDate>2005-07-29T00:00:00+09:00</PublishDate>
</BookOrder>
            

では、Main.java を修正して実行してみましょう。もちろん、BookOrder#getAuthor() メソッドは配列、または List を返すように修正されているはずですから、Main.java もそれに合わせて修正します。修正が終わったら実行してみてください。岡村さん、山田さんの両方がきちんと表示されましたか？特にアノテーションを変更することなく、フィールドの型を変更するだけで繰り返しを表現することが出来ました。とても簡単です。

例では、『最大出現回数は無制限 (maxOccurs="unbounded")』になりましたが、通常の XML データ定義では、『出現回数は 2 回まで』と言ったように制限を付与したいことがあります。しかし、JavaDoc (link) を見渡しても最大出現回数を指定するような属性が見つかりません。残念ながら、アノテーションでは 最大出現回数を指定出来ないのかも知れません (ちなみに minOccurs も 0 か 1 しか指定出来ません)。

6.1 @XmlElementWrapper

Author 要素が複数回出現するのだから、上位に Authors 要素を加えたくなりますよね？そんなときは @XmlElementWrapper を使用します。@XmlElementWrapper は、その名の通り、ある要素を包み込みだけの場合に使用します。BookOrder クラスを以下のように修正後、XML スキーマを再作成しましょう。もちろん、入力となる XML データも併せて修正してください。

@XmlElementWrapper(name="Authors")
@XmlElement(name="Author")
private String[] author;
            

<?xml version="1.0" encoding="UTF-8"?>
<BookOrder>
  <Title>豆蔵セミナーライブオンテキスト(3) Java・オブジェクト指向の壁を突破する 抽象化プログラミング入門 
-UMLからJavaへ、すらすらコーディングできますか? </Title>
  <Category>オブジェクト指向</Category>
  <Authors>
    <Author>岡村 敦彦</Author>
    <Author>山田 隆太</Author>
  </Authors>
  <Price>2604</Price>
  <Publisher>技術評論社</Publisher>
  <PublishDate>2005-07-29T00:00:00+09:00</PublishDate>
</BookOrder>
            

Main.java は一切変更せずに実行してみてください。正常に出力されましたか？されたと思います。

Main.java を変更することなくラッピング要素 (Authors 要素) を追加することが出来ました。JAXB 2 は XML スキーマの変更に柔軟に対応できるように実装されていることが分かります。

6.2. @XmlElementWrapper を使用せずにラッピング要素を定義をしてみよう

例えば、書籍注文だと複数の書籍を同時に注文することがありますね。ここでは、Book 要素を新たに追加し、ルート要素である BookOrder 要素配下に複数の Book 要素を記述出来るようにしてみます。これまで BookOrder 要素配下に定義していた Title 要素などは Book 要素に移動します。

〜 package, imports は略 〜

@XmlAccessorType(XmlAccessType.FIELD)
@XmlRootElement(name="BookOrder")
public class BookOrder {
    @XmlElement(name="Book")
    private List<Book> books;

    〜 アクセッサは略 〜
}
            

〜 package, imports は略 〜

@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(propOrder={"title", "category", "author", "price", "publisher", "publishDate"})
public class Book {
    〜 略 〜
}
            

ここでは、Book クラスに @XmlType だけを付加し、要素型として定義します。修正したら XML スキーマを作成してみましょう。生成したスキーマは次の様になっていると思います。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="BookOrder" type="bookOrder"/>

  <xs:complexType name="bookOrder">
    <xs:sequence>
      <xs:element name="Book" type="book" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="book">
    <xs:sequence>
      <xs:element name="Title" type="xs:string" minOccurs="0"/>
      <xs:element name="Category" type="xs:string" minOccurs="0"/>
      <xs:element name="Authors" minOccurs="0">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Author" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
      <xs:element name="Price" type="xs:int"/>
      <xs:element name="Publisher" type="xs:string" minOccurs="0"/>
      <xs:element name="PublishDate" type="xs:dateTime" minOccurs="0"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>
            

それでは XML データを定義してみましょう。ここでは以下の XML データを定義します。

<?xml version="1.0" encoding="UTF-8"?>
<BookOrder>
  <Book>
    <Title>豆蔵セミナーライブオンテキスト(1) わかるオブジェクト指向</Title>
    <Category>オブジェクト指向</Category>
    <Authors>
      <Author>山田 隆太</Author>
    </Authors>
    <Price>2604</Price>
    <Publisher>技術評論社</Publisher>
    <PublishDate>2005-07-29T00:00:00+09:00</PublishDate>
  </Book>
  <Book>
    <Title>豆蔵セミナーライブオンテキスト(2) すいすい習得 UMLモデリング</Title>
    <Category>モデリング</Category>
    <Authors>
      <Author>岡村 敦彦</Author>
    </Authors>
    <Price>2604</Price>
    <Publisher>技術評論社</Publisher>
    <PublishDate>2006-04-11T00:00:00+09:00</PublishDate>
  </Book>
  <Book>
    <Title>豆蔵セミナーライブオンテキスト(3) Java・オブジェクト指向の壁を突破する 抽象化プログラミング入門 
-UMLからJavaへ、すらすらコーディングできますか? </Title>
    <Category>オブジェクト指向</Category>
    <Authors>
      <Author>岡村 敦彦</Author>
      <Author>山田 隆太</Author>
    </Authors>
    <Price>2604</Price>
    <Publisher>技術評論社</Publisher>
    <PublishDate>2005-07-29T00:00:00+09:00</PublishDate>
  </Book>
</BookOrder>
            

Main.java を修正して実行してみましょう。正しく実行されれば OK です。

7. 選択定義をしてみよう

選択要素の定義をしてみましょう。例えば書籍だとタイトル、または ISBN で特定することがありますね。ここでは、Title 要素と ISBN 要素のいずれかを選択出来るように定義してみます。選択要素を定義するには、@XmlElements と @XmlElement を使用します。

Book.java の title フィールド (宣言とアクセッサメソッド) を削除し、id フィールド (宣言とアクセッサメソッド) を追加します。@XmlType の propOrder 属性も title から id に変更します。

〜 package, imports は略 〜

@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(propOrder={"id", "category", "author", "price", "publisher", "publishDate"})
public class Book {
    @XmlElements(value={
            @XmlElement(name="Title", type=String.class), 
            @XmlElement(name="ISBN", type=String.class)})
    private String id;
    
    〜 略 〜

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    〜 略 〜
}
            

XML スキーマを作成してみましょう。生成したスキーマは次の様になっていると思います。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="BookOrder" type="bookOrder"/>

  <xs:complexType name="bookOrder">
    <xs:sequence>
      <xs:element name="Book" type="book" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="book">
    <xs:sequence>
      <xs:choice minOccurs="0">
        <xs:element name="Title" type="xs:string"/>
        <xs:element name="ISBN" type="xs:string"/>
      </xs:choice>
      <xs:element name="Category" type="xs:string" minOccurs="0"/>
      <xs:element name="Authors" minOccurs="0">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Author" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
      <xs:element name="Price" type="xs:int"/>
      <xs:element name="Publisher" type="xs:string" minOccurs="0"/>
      <xs:element name="PublishDate" type="xs:dateTime" minOccurs="0"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>
            

次に XML データを定義してみましょう。一方の Book 要素は Title 要素を、もう一方の Book 要素は ISBN 要素を持つようにします。

<?xml version="1.0" encoding="UTF-8"?>
<BookOrder>
  <Book>
    <Title>豆蔵セミナーライブオンテキスト(1) わかるオブジェクト指向</Title>
    <Category>オブジェクト指向</Category>
    <Authors>
      <Author>山田 隆太</Author>
    </Authors>
    <Price>2604</Price>
    <Publisher>技術評論社</Publisher>
    <PublishDate>2005-07-29T00:00:00+09:00</PublishDate>
  </Book>
  <Book>
    <ISBN>978-4774127392</ISBN>
    <Category>モデリング</Category>
    <Authors>
      <Author>岡村 敦彦</Author>
    </Authors>
    <Price>2604</Price>
    <Publisher>技術評論社</Publisher>
    <PublishDate>2006-04-11T00:00:00+09:00</PublishDate>
  </Book>
</BookOrder>
            

Main.java を修正して実行してみましょう (getTitle メソッド呼び出しを getId メソッド呼び出しに変更します)。前者には Title 要素の値が、後者には ISBN 要素の値が出力されていれば成功です。実行結果は以下の通りです。

タイトル(ISBN) : 豆蔵セミナーライブオンテキスト(1) わかるオブジェクト指向
カテゴリ       : オブジェクト指向
著者           : 山田 隆太
価格(税込)     : 2604
出版社         : 技術評論社
発売日         : 2005/07/29

タイトル(ISBN) : 978-4774127392
カテゴリ       : モデリング
著者           : 岡村 敦彦
価格(税込)     : 2604
出版社         : 技術評論社
発売日         : 2006/04/11
            

Main.java からは Book クラスの id フィールドに対してアクセスすれば良いので、Main クラスからは、XML データに Title 要素が記述されているのか、ISBN 要素が記述されているのかは透過的になります。

8. all 定義をしてみよう

all 定義をしてみましょう。all 定義は順序定義とほぼ同等で、@XmlType の propOrder 属性に 何も指定しない ようにします。propOrder 属性を指定しないのとは等価ではありませんので注意してください。

@XmlType(propOrder={})
            

生成した XML スキーマは、以下に示すように xs:all で定義されていると思います。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="BookOrder" type="bookOrder"/>

  <xs:complexType name="bookOrder">
    <xs:sequence>
      <xs:element name="Book" type="book" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="book">
    <xs:all>
      <xs:element name="Title" type="xs:string" minOccurs="0"/>
      <xs:element name="Category" type="xs:string" minOccurs="0"/>
      <xs:element name="Authors" minOccurs="0">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Author" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
      <xs:element name="Price" type="xs:int"/>
      <xs:element name="Publisher" type="xs:string" minOccurs="0"/>
      <xs:element name="PublishDate" type="xs:dateTime" minOccurs="0"/>
    </xs:all>
  </xs:complexType>
</xs:schema>
            

JAXB 2 で XML データバインディング (3)

9. デフォルト値を設定してみよう

XML データに値が設定されていなかった場合のデフォルト値を指定してみましょう。デフォルト値を指定するには、@XmlElement の defaultValue 属性を使用します。

〜 package, imports は略 〜

@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(propOrder={"id", "category", "author", "price", "publisher", "publishDate"})
public class Book {
    @XmlElements(value={
            @XmlElement(name="Title", type=String.class), 
            @XmlElement(name="ISBN", type=String.class)})
    private String id;

    @XmlElement(name="Category", defaultValue="分類なし")
    private String category;

    @XmlElementWrapper(name="Authors")
    @XmlElement(name="Author")
    private String[] author;

    @XmlElement(name="Price")
    private int price;

    @XmlElement(name="Publisher", defaultValue="不明")
    private String publisher;

    @XmlElement(name="PublishDate")
    private Calendar publishDate;

    〜 アクセッサは略 〜
}
            

では、XML スキーマを作成し、次の XML データを変換してみましょう。

<?xml version="1.0" encoding="UTF-8"?>
<BookOrder>
  <Book>
    <Title>豆蔵セミナーライブオンテキスト(1) わかるオブジェクト指向</Title>
    <Category></Category>
    <Authors>
      <Author>山田 隆太</Author>
    </Authors>
    <Price>2604</Price>
    <PublishDate>2005-07-29T00:00:00+09:00</PublishDate>
  </Book>
</BookOrder>
            

出力結果は以下のようになります。

タイトル(ISBN) : 豆蔵セミナーライブオンテキスト(1) わかるオブジェクト指向
カテゴリ       : 分類なし
著者           : 山田 隆太
価格(税込)     : 2604
出版社         : null
発売日         : 2005/07/29
            

『カテゴリ』にはデフォルト値である "分類なし" が出力されていますが、『出版社』にはデフォルト値が出力されていません。XML データをもう一度確認してみましょう。『Category』要素が空要素であるのに対し、『Publisher』要素が存在しないことが確認出来ます。

JavaDoc を確認してみましょう。JavaDoc (link) にはこのよう記述されています。

わかりずらっ！まぁ『空要素と要素自体がないのとは違いますよ。』と。『defaultValue で設定した値は空要素の場合にのみ設定されますよ。』ということですね。XML では、空要素であることと、要素自体が存在しないことは等価ではありませんので、JAXB もこれに準拠して動作します。

10. 固定値を設定してみよう

固定値とは、「属性や要素の値は必ず定められた値でなくてはならない」ことを定義するもので、fixed 属性によって XML スキーマで定義されます。JAXB 1.x 系ではこの fixed 属性はサポートされていませんでした。JAXB 2 ではどうでしょう？

JavaDoc で @XmlElement (link) や @XmlAttribute (link) を見る限り、fixed 属性を定義するような方法は見当たりません。JAXB 2 は XML スキーマの完全準拠が謳われていますが、リファレンスインプリメンテーション (RI) では完全準拠に至っていないようです。

10.1. 属性の固定値設定

xs:attribute に fixed 属性を指定するには、xjc ツールを用いて、XML スキーマ⇒Java オブジェクト変換を行う必要があります。その際、XML スキーマには以下のような指定も併せて記述する必要があります (xjc ツールの使用方法については 後述 (link) します)。

<xsd:annotation>
  <xsd:appinfo>
      <jaxb:property fixedAttributeAsConstantProperty="true"/>
  </xsd:appinfo>
</xsd:annotation>
            

このとき、xs:schema に 属性値として以下の記述も併せて行います。

jaxb:version="1.0" xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
            

fixed 属性が付与された属性は、public static final フィールドとしてクラス内に定義されます。

10.2. 要素の固定値設定

要素に対する fixed 属性はサポートされていません。

11. 名前空間を設定してみよう

名前空間とは、Java で言う「package」、.NET で言う「namespace」と同じ概念であり、タグ名の衝突を防ぐためのものです。名前空間を定義するには、@XmlRootElement や @XmlType に namespace 属性を付与するだけです。ここでは、複数のクラスを同一の名前空間として定義した場合と、異なる名前空間として定義した場合を見ていきましょう。

11.1. 同一名前空間

上述した通り、名前空間を設定するには、namespace 属性を使用します。それでは、BookOrder クラス、Book クラスに名前空間を付与してみましょう。

〜 package, imports は略 〜

@XmlAccessorType(XmlAccessType.FIELD)
@XmlRootElement(name = "BookOrder", namespace="http://www.mamezou.com/jaxb2/namespace")
@XmlType(namespace="http://www.mamezou.com/jaxb2/namespace")
public class BookOrder {
〜 略 〜
}
            

〜 package, imports は略 〜

@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(propOrder={"id", "category", "author", "price", "publisher", "publishDate"},
         namespace="http://www.mamezou.com/jaxb2/namespace")
public class Book {
〜 略 〜
}
            

どちらのクラスも http://www.mamezou.com/jaxb2/namespace に属すように namespace 属性を定義しました。このクラスから生成される XML スキーマはどのようになっているか、確認してみましょう (適宜改行しています)。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" targetNamespace="http://www.mamezou.com/jaxb2/namespace"
                         xmlns:tns="http://www.mamezou.com/jaxb2/namespace"
                         xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="BookOrder" type="tns:bookOrder"/>

  <xs:complexType name="bookOrder">
    <xs:sequence>
      <xs:element name="Book" type="tns:book" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="book">
    <xs:sequence>
      <xs:choice minOccurs="0">
        <xs:element name="Title" type="xs:string"/>
        <xs:element name="ISBN" type="xs:string"/>
      </xs:choice>
      <xs:element name="Category" type="xs:string" default="分類なし" minOccurs="0"/>
      <xs:element name="Authors" minOccurs="0">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Author" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
      <xs:element name="Price" type="xs:int"/>
      <xs:element name="Publisher" type="xs:string" default="不明" minOccurs="0"/>
      <xs:element name="PublishDate" type="xs:dateTime" minOccurs="0"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>
            

xs:schema 要素に targetNamespace 属性が追加され、xmlns:tns で名前空間が追加定義されています。つまり、グローバル宣言されたいずれの要素、及び型も http://www.mamezou.com/jaxb2/namespace 名前空間に属するように定義がされました。それでは、入力 XML データを修正し、それぞれこの名前空間に属するように修正してみましょう。

<?xml version="1.0" encoding="UTF-8"?>
<ns:BookOrder xmlns:ns="http://www.mamezou.com/jaxb2/namespace">
  <Book>
    <Title>豆蔵セミナーライブオンテキスト(1) わかるオブジェクト指向</Title>
    <Category>オブジェクト指向</Category>
    <Authors>
      <Author>山田 隆太</Author>
    </Authors>
    <Price>2604</Price>
    <Publisher>技術評論社</Publisher>
    <PublishDate>2005-07-29T00:00:00+09:00</PublishDate>
  </Book>
  <Book>
    <ISBN>978-4774127392</ISBN>
    <Category>モデリング</Category>
    <Authors>
      <Author>岡村 敦彦</Author>
    </Authors>
    <Price>2604</Price>
    <Publisher>技術評論社</Publisher>
    <PublishDate>2006-04-11T00:00:00+09:00</PublishDate>
  </Book>
</ns:BookOrder>
            

グローバル宣言されている BookOrder 要素のみ http://www.mamezou.com/jaxb2/namespace 名前空間に属するようにします。Book 要素配下は名前空間に属していないことがわかります。XML スキーマに関する知識がある方は特に説明は不要だと思いますが、XML スキーマでは、デフォルトでは xs:complexType 内でローカル宣言された要素 (xs:element) は名前空間に属さないため、ここでもそのように定義します。

それでは実行してみましょう。実行結果は以下の通りです。特に何も変わった点はなく、正常に出力されます。

タイトル(ISBN) : 豆蔵セミナーライブオンテキスト(1) わかるオブジェクト指向
カテゴリ       : オブジェクト指向
著者           : 山田 隆太
価格(税込)     : 2604
出版社         : 技術評論社
発売日         : 2005/07/29

タイトル(ISBN) : 978-4774127392
カテゴリ       : モデリング
著者           : 岡村 敦彦
価格(税込)     : 2604
出版社         : 技術評論社
発売日         : 2006/04/11

            

11.2. 異名前空間

次に、異なる名前空間に属するようにしてみましょう。BookOrder クラスはそのままで、Book クラスが http://www.mamezou.com/jaxb2/namespace/other 名前空間に属するように修正してみましょう。

〜 package, imports は略 〜

@XmlType(propOrder={"id", "category", "author", "price", "publisher", "publishDate"},
         namespace="http://www.mamezou.com/jaxb2/namespace/other")
public class Book {
〜 略 〜
}
            

それではこのクラス (BookOrder, Book) を基に XML スキーマを生成してみましょう。

C:\>schemagen BookOrder.java Book.java
注:Writing C:\\schema1.xsd
注:Writing C:\\schema2.xsd
            

2 つのスキーマが出力されました。XML スキーマの仕様では、ひとつの XML スキーマに定義された要素や属性は、必ず同一の名前空間に属している必要があるため、これに準拠して 2 つのスキーマ (定義した名前空間分) が出力されることになります。それでは、schema2.xsd を見ていきましょう (適宜改行しています)。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" targetNamespace="http://www.mamezou.com/jaxb2/namespace"
                         xmlns:ns1="http://www.mamezou.com/jaxb2/namespace/other"
                         xmlns:tns="http://www.mamezou.com/jaxb2/namespace"
                         xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:import namespace="http://www.mamezou.com/jaxb2/namespace/other" schemaLocation="schema1.xsd"/>

  <xs:element name="BookOrder" type="tns:bookOrder"/>

  <xs:complexType name="bookOrder">
    <xs:sequence>
      <xs:element name="Book" type="ns1:book" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>
            

xs:import 要素を使って、schema1.xsd を読み込んでいることが分かります。xs:import 要素は、異なる名前空間に属する XML スキーマを参照する場合に使用するもので、ここでは http://www.mamezou.com/jaxb2/namespace/other 名前空間に属す schema1.xsd を参照しています。

SchemaFactory#newSchema() メソッドでは、親となる方のスキーマ、つまりこの例では schema2.xsd の Schema オブジェクトを生成するよう指示することで、schema1.xsd も同時に読み込まれます。

12. グローバル宣言された要素を参照してみよう

最後にグローバル宣言された他要素を参照する方法を見ていきましょう。XML スキーマでは <xs:element ref="参照先グローバル要素名" /> で表現される JAXB アノテーションは何でしょう？キーワード的に出てきましたね。そう、@XmlElementRef です。名は体を表す良いネーミングです (これ以外の名前を付けたらおかしいでしょ？という突っ込みは置いておきましょう)。

本と言えば A4 版、B5 版などサイズがたくさんあります。では、ここでは縦、横、高さ (厚み) を追加してみます。Size クラスを定義してみましょう。しかし、サイズは何も本に限らず世の中の物質全てに共通するものです。そこで Size 要素を共通要素として定義し、参照するようにしてみます。

まず、以下の様に Size クラスを定義します。

〜 package, imports は略 〜

@XmlAccessorType(XmlAccessType.FIELD)
@XmlRootElement(name="Size", namespace="http://www.mamezou.com/jaxb2/namespace/common")
@XmlType(propOrder={"length", "width", "height"},
         namespace="http://www.mamezou.com/jaxb2/namespace/common")
public class Size {
    @XmlElement(name="Length")
    private double length;

    @XmlElement(name="Width")
    private double width;

    @XmlElement(name="Height")
    private double height;

    〜 アクセッサは略 〜
}
            

次に Book クラスを修正します。@XmlElementRef を使って size フィールドを定義します。併せて @XmlType の propOrder 属性も修正します。

〜 略 〜
@XmlType(propOrder={"id", "category", "author", "price", "publisher", "publishDate", "size"},
         namespace="http://www.mamezou.com/jaxb2/namespace/other")
〜 略 〜

    @XmlElementRef(name="Size", type=Size.class)
    private Size size;
〜 略 〜
            

XML スキーマを作成後、取得したサイズをコンソールに出力するよう、Main.java を修正します (割愛)。最後に XML データを修正します。Size 要素はグローバル要素として定義されているので、名前空間を付与しなくてはならない点に注意してください。

<?xml version="1.0" encoding="UTF-8"?>
<ns1:BookOrder xmlns:ns1="http://www.mamezou.com/jaxb2/namespace"
               xmlns:ns2="http://www.mamezou.com/jaxb2/namespace/common">
  <Book>
    <Title>豆蔵セミナーライブオンテキスト(1) わかるオブジェクト指向</Title>
    <Category>オブジェクト指向</Category>
    <Authors>
      <Author>山田 隆太</Author>
    </Authors>
    <Price>2604</Price>
    <Publisher>技術評論社</Publisher>
    <PublishDate>2005-07-29T00:00:00+09:00</PublishDate>
    <ns2:Size>
      <Length>21.0</Length>
      <Width>14.8</Width>
      <Height>1.8</Height>
    </ns2:Size>
  </Book>
</ns1:BookOrder>
            

さぁ仕上げです。実行してみましょう。Size 要素に設定した値は正しく取得出来ましたか？取得出来ていれば完成です。(=￣▽￣=)Ｖ

JAXB 2 で XML データバインディング (4)

13. Ant から schemagen ツールを実行してみよう

13.1. 必要な環境

• JAXB 2

schemagen ツールを Ant で実行するために使用します。本記事では JAXB 2.1.6 を使用します。

1. https://jaxb.dev.java.net/2.1.6/ から JAXB2_20071219.jar をダウンロードします。
2. コマンドプロンプトを開いて、java -jar JAXB2_20071219.jar (パスは環境に合わせて適宜変更してください) と入力するか、ダブルクリックします。
3. 「License Agreement」ダイアログが表示されたら、(ライセンス規約を確認しながら) 垂直スクロールバーを一番下まで引っ張ります。
4. Accept ボタンが有効になるので押下します。
5. 解凍後、作成されたフォルダを適当な場所に配置します。
• Ant

本記事では 1.7.0 を使用します。

1. http://ant.apache.org/bindownload.cgi から apache-ant-1.7.0-bin.zip をダウンロードします。
2. ダウンロードしたファイルを解凍し、適当な場所に配置します。
3. 環境変数 (ANT_HOME) に ${インストールフォルダ} を、環境変数 (path) に %ANT_HOME%\bin を設定します。

13.2. build.xml ファイルの作成

Ant で使用する build.xml ファイルを作成します。筆者環境での build.xml ファイルを以下に示します。必要に応じてパスを変更してください。ここでは 11.2. 異名前空間 で作成したプログラムから XML スキーマを作成してみます。

<?xml version="1.0" encoding="Shift_JIS" ?>
<project default="compile" basedir=".">
    <taskdef name="schemagen" classname="com.sun.tools.jxc.SchemaGenTask">
        <classpath>
            <fileset dir="C:/jaxb-ri-20071219/lib" includes="*.jar" />
        </classpath>
    </taskdef>

    <target name="compile">
        <echo message="Generating schemas..." />
        <schemagen destdir="C:/">
            <src path="C:/eclipse_europa/workspace/Jaxb Sample/src/com/mamezou/jaxb2/namespace/other" />
            <exclude name="Main.java"/>
            <schema namespace="http://www.mamezou.com/jaxb2/namespace" file="BookOrder.xsd" />
            <schema namespace="http://www.mamezou.com/jaxb2/namespace/other" file="Book.xsd" />
        </schemagen>
    </target>
</project>
            

13.3. Ant の実行

それでは、コマンドプロンプトを開いて Ant を実行してみましょう (build.xml ファイルは C:\ に配置しています)。コンソール出力は以下の様になります。

C:\>ant
Buildfile: build.xml

compile:
     [echo] Generating schemas...
[schemagen] Generating schema from 2 source files
[schemagen] 注:Writing C:\Book.xsd
[schemagen] 注:Writing C:\BookOrder.xsd

BUILD SUCCESSFUL
Total time: 4 seconds
            

指定したファイル名でスキーマが生成されました。schemagen ツールを直接実行した場合、スキーマファイル名を指定出来ないため、開発現場では Ant (もしくは Maven) を使用する方が良いでしょう。

14. XML スキーマから Java オブジェクトを生成してみよう

これまで、Java オブジェクトにアノテーションを付与し、schemagen ツールを用いて XML スキーマを自動生成する方法を見てきました。では、今度は逆に『xjc』ツールを用いて XML スキーマから Java オブジェクトを生成してみましょう。これは JAXB 1.x 系で用いられていた方法でもあります。

ここでは、既に作成した SequenceSchema.xsd (link) から Java オブジェクトを生成してみましょう。

コマンドプロンプトを開いて、以下のコマンドを入力し実行してください。

カレントフォルダ (ここでは C:\) に generated フォルダが作成され、その中に Java ファイルが出力されていると思います。ここで特に注目すべき点は、生成されるファイル数の少なさです。バインディング対象のクラスとなる BookOrder.java と Book.java を除いて、JAXB 2 用に生成されるファイルは ObjectFactory.java のみです。

本記事の最初で述べたように、JAXB 1.x 系の xjc ツールでは、ランタイムなど全て含めて 40 ファイル (ランタイムを除いても 10 ファイル) 生成されていたので、随分進歩したと言えます。

さきに、『アノテーションでは minOccur 属性や maxOccurs 属性に、2, 3 など自由な値を設定することが出来ない。』と解説しました。そして、『自動生成した XML スキーマを修正することは賛否両論。』だとも解説しました。筆者自身も自動生成したものに手修正を加えることは反対です。XML スキーマを再生成するたびに修正を加えることは現実的ではありません (スクリプトで実施したとしても)。

筆者は JAXB 1.x 系を使用していたので、XML スキーマの仕様もある程度理解していますし、堅いスキーマ定義をすることで入力データチェックをアプリケーションに組み込まなくても良いのが大きな魅力だと感じています。そんなことをするくらいなら、いっそ XML スキーマから Java オブジェクトを生成出来るように XML スキーマの学習をお勧めします。

XML スキーマの仕様をある程度理解している方は、『XML スキーマ⇒Java オブジェクト』変換を採用する方が、ストレスなく効率的に実装が出来るのではないでしょうか。

おわりに

ここまで、基本的なスキーマ定義を中心に JAXB 2 の機能を見てきました。JAXB 2 を知ることで DOM や SAX, StAX などの仕様は全くと言っていいほど意識する必要性がなくなりました。時折、『JAXB 2 では XML スキーマの知識が必須でなくなる』と耳にすることがありますが、(あくまで) 個人的な意見としてはそれは誤りであるかのように思います。いくら Java オブジェクトから XML スキーマを生成出来るからと言って、XML スキーマの知識がなければアノテーションを適切に定義することも出来ませんし、何が出来て、何が出来ないかを把握することも出来ません。

さきでも解説した通り、@XmlElement や @XmlElementRef では、minOccurs 属性や maxOccurs 属性に固定値を指定することも出来ません。XML スキーマに慣れている開発者にとってはこれが大きな問題のようにも思えます。その場合は、『xjc ツールを利用して XML スキーマから Java クラスを生成する』と言った方法で回避することになるでしょう (または JAXB 2 の仕様が拡張されるまで待つしかありません)。

JAXB 2 は非常に優れた強力な XML バインダであり、JAX-WS 2 にも採用されているなどスタンダードな機能です。Jakarta Commons Digester や Castor など、他にも優れた XML バインダは数多くありますが、Java 標準である JAXB 2 は、他の XML バインダに負けないほどの機能を持っています。

本記事をご覧になられて、アーキテクチャ選定の際に、『JAXB 2 を使用する手もあるな』と思い出して頂けたり、『JAXB 1.x 系ではパフォーマンスに問題が』と感じていた方が再度、JAXB を試して頂く機会になれば幸いです。