2.2. 設定
最初にクラスパスを設定します (お好きな IDE で新しいプロジェクトを作成した後)。
- すべての Hibernate3 コアと必要なサードパーティライブラリをコピーします (Hibernate の lib/README.txt を参照)。
hibernate-annotations.jar
、lib/hibernate-comons-annotations.jar
、およびlib/ejb3-persistence.jar
を Hibernate Annotations ディストリビューションからクラスパスにコピーします。
また、
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
HibernateUtil
という名前の、Hibernate を静的な初期化子ブロックで起動する小さなラッパークラスを使用することが推奨されます。Hibernate ドキュメンテーションの他の場所でさまざまな形式のこのクラスを見たことがあるかもしれません。アノテーションサポートについては、このヘルパークラスを次のように拡張する必要があります:
ここで興味深いことは
AnnotationConfiguration
の使用です。パッケージとアノテートされたクラスが通常の XML 設定ファイル (通常は、hibernate.cfg.xml
) で宣言されます。以下は上記の宣言と同じです。
hbm.xml と新しいアノテーションを同時に使用できることに注意してください。リソースエレメントは hbm ファイルまたは EJB3 XML デプロイメント記述子のいずれかになります。この違いは設定プロセスが透過的であるかどうかです。
または、プログラミング API を使用してアノテートされたクラスとパッケージを定義できます。
sessionFactory = new AnnotationConfiguration() .addPackage("test.animals") //the fully qualified package name .addAnnotatedClass(Flight.class) .addAnnotatedClass(Sky.class) .addAnnotatedClass(Person.class) .addAnnotatedClass(Dog.class) .addResource("test/animals/orm.xml") configure()..buildSessionFactory();
sessionFactory = new AnnotationConfiguration() .addPackage("test.animals") //the fully qualified package name .addAnnotatedClass(Flight.class) .addAnnotatedClass(Sky.class) .addAnnotatedClass(Person.class) .addAnnotatedClass(Dog.class)
.addResource("test/animals/orm.xml")
configure()..buildSessionFactory();
また、独自の設定メカニズムを持つ Hibernate EntityManager を使用することもできます。詳細については、このプロジェクトドキュメンテーションを参照してください。
Hibernate API でアノテーションを使用するにあたって、この起動ルーチンの変更や設定ファイル以外に違いはありません。他のプロパティ (
hibernate.properties
、hibernate.cfg.xml
、プログラミング API など) に対してお好きな設定方法を使用できます。アノテートされた永続化クラスと従来の hbm.cfg.xml
宣言を同じ SessionFactory
とともに使用することもできます。ただし、クラスは複数回宣言できません (アノテートされているか hbm.xml を使用するかどうか)。マップされたエンティティ階層で設定方針を混在させることはできません (hbm とアノテーション)。
hbm ファイルからアノテートへの移行プロセスを簡単にするために、設定メカニズムはアノテーションと hbm ファイル間のマッピングの重複を検出します。HBM ファイルは、クラスごとにアノテートされたメタデータよりも優先されます。優先度は
hibernate.mapping.precedence
プロパティを使用して変更できます。デフォルト値は hbm, class
であり、デフォルト値を class, hbm
に変更すると、重複が発生したときにアノテートされたクラスが hbm ファイルよりも優先されます。