2.2. EJB3/JPA アノテーションとのマッピング

EJB3 エンティティはプレーンな POJO です。実際には EJB3 エンティティの概念は Hibernate 永続エンティティの概念とまったく同じです。マッピングは JDK 5.0 アノテーションを使用して定義されます (オーバーライド用の XML 記述子の構文は EJB3 仕様で定義されます)。アノテーションは、論理マッピングアノテーション (オブジェクトモデルやクラスの関連付けなどの定義を可能にします) と物理マッピングアノテーション (物理スキーマ、テーブル、カラム、インデックスなどを定義します) の 2 つのカテゴリに分けることができます。以下のサンプルコードで両方のカテゴリのアノテーションを組み合わせます。

EJB3 アノテーションは javax.persistence.* パッケージに含まれます。ほとんどの JDK 5 準拠 IDE (Eclipse、IntelliJ IDEA、Netbeans など) では、アノテーションインターフェースと属性をユーザーのために自動的に補完します (EJB3 アノテーションがプレーンな JDK 5 アノテーションであるため、固有の "EJB3" モジュールがない場合であっても)。

具体的かつ実践的な例については、JBoss EJB 3.0 チュートリアルを参照するか、Hibernate Annotations テストスイートを確認してください。ほとんどのユニットテストは、具体的な例を示し、さまざまなアイデアを提供するよう設計されています。

@Entity
public class Flight implements Serializable {
    Long id;

    @Id
    public Long getId() { return id; }

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

@Entity
@Table(name="tbl_sky")
public class Sky implements Serializable {
...

@Table(name="tbl_sky",
    uniqueConstraints = {@UniqueConstraint(columnNames={"month", "day"})}
)

@Entity
public class Flight implements Serializable {
...
    @Version
    @Column(name="OPTLOCK")
    public Integer getVersion() { ... }
}