Hibernate-mapping-files
提供:Dev Guides
Hibernate-マッピングファイル
通常、オブジェクト/リレーショナルマッピングはXMLドキュメントで定義されます。 このマッピングファイルはHibernateに指示します—定義されたクラスをデータベーステーブルにマップする方法は?
多くのHibernateユーザーは手作業でXMLを記述することを選択しますが、マッピングドキュメントを生成するためのツールがいくつか存在します。 これらには、上級Hibernateユーザー向けの XDoclet、Middlegen および AndroMDA が含まれます。
オブジェクトが次のセクションで定義されるテーブルに保持される、以前に定義されたPOJOクラスを考えてみましょう。
public class Employee {
private int id;
private String firstName;
private String lastName;
private int salary;
public Employee() {}
public Employee(String fname, String lname, int salary) {
this.firstName = fname;
this.lastName = lname;
this.salary = salary;
}
public int getId() {
return id;
}
public void setId( int id ) {
this.id = id;
}
public String getFirstName() {
return firstName;
}
public void setFirstName( String first_name ) {
this.firstName = first_name;
}
public String getLastName() {
return lastName;
}
public void setLastName( String last_name ) {
this.lastName = last_name;
}
public int getSalary() {
return salary;
}
public void setSalary( int salary ) {
this.salary = salary;
}
}
永続性を提供する各オブジェクトに対応するテーブルが1つあります。 上記のオブジェクトは、次のRDBMSテーブルに格納および取得する必要があることを考慮してください-
create table EMPLOYEE (
id INT NOT NULL auto_increment,
first_name VARCHAR(20) default NULL,
last_name VARCHAR(20) default NULL,
salary INT default NULL,
PRIMARY KEY (id)
);
上記の2つのエンティティに基づいて、以下のマッピングファイルを定義できます。このファイルは、定義済みのクラスをデータベーステーブルにマッピングする方法をHibernateに指示します。
<?xml version = "1.0" encoding = "utf-8"?>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD//EN"
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
<hibernate-mapping>
<class name = "Employee" table = "EMPLOYEE">
<meta attribute = "class-description">
This class contains the employee detail.
</meta>
<id name = "id" type = "int" column = "id">
<generator class="native"/>
</id>
<property name = "firstName" column = "first_name" type = "string"/>
<property name = "lastName" column = "last_name" type = "string"/>
<property name = "salary" column = "salary" type = "int"/>
</class>
</hibernate-mapping>
マッピングドキュメントは、<classname> .hbm.xml形式のファイルに保存する必要があります。 マッピング文書をファイルEmployee.hbm.xmlに保存しました。
マッピングファイルで使用されるマッピング要素について少し詳しく理解してみましょう-
- マッピングドキュメントは、ルート要素として <hibernate-mapping> を持つXMLドキュメントであり、すべての <class> 要素が含まれます。
- <class> 要素は、Javaクラスからデータベーステーブルへの特定のマッピングを定義するために使用されます。 Javaクラス名は、クラス要素の name 属性を使用して指定され、データベースの table 名は、table属性を使用して指定されます。
- <meta> 要素はオプションの要素であり、クラスの説明を作成するために使用できます。
- <id> 要素は、クラスの一意のID属性をデータベーステーブルの主キーにマップします。 id要素の name 属性はクラスのプロパティを参照し、 column 属性はデータベーステーブルの列を参照します。 type 属性はhibernateマッピングタイプを保持します。このマッピングタイプはJavaからSQLデータタイプに変換します。
- id要素内の <generator> 要素は、主キー値を自動的に生成するために使用されます。 ジェネレーター要素の class 属性は native に設定され、休止状態が基になるデータベースの機能に応じて主キーを作成するために identity、sequence 、または hilo アルゴリズムを選択できるようにします。
- <property> 要素は、Javaクラスプロパティをデータベーステーブルの列にマップするために使用されます。 要素の name 属性はクラスのプロパティを参照し、 column 属性はデータベーステーブルの列を参照します。 type 属性はhibernateマッピングタイプを保持します。このマッピングタイプはJavaからSQLデータタイプに変換します。
マッピングドキュメントで使用される他の属性と要素があります。Hibernateに関連する他のトピックについて議論しながら、できるだけ多くをカバーするようにします。