论坛徽章:: 0

电梯直达

1楼 [收藏(0)] [报告]

发表于 2012-03-19 17:25 |只看该作者 |倒序浏览

Hibernate Annotation文档整理（一）

Setting up an annotations project
•HibernateUtil类（Annotation方式）
Java代码

1.public class HibernateUtil {
2.private static final SessionFactory sessionFactory;
3. static {
4. try {
5. sessionFactory = new AnnotationConfiguration()
6. .configure().buildSessionFactory();
7. } catch (Throwable ex) {
8. // Log exception!
9. throw new ExceptionInInitializerError(ex);
10. }
11. }
12. public static Session getSession()
13. throws HibernateException {
14. return sessionFactory.openSession();
15. }
16.}
public class HibernateUtil {
private static final SessionFactory sessionFactory;
static {
try {
sessionFactory = new AnnotationConfiguration()
.configure().buildSessionFactory();
} catch (Throwable ex) {
// Log exception!
throw new ExceptionInInitializerError(ex);
}
}
public static Session getSession()
throws HibernateException {
return sessionFactory.openSession();
}
}

复制代码

•需要添加hibernate.cfg.xml配置文件，内容如：

Xml代码

1.<!DOCTYPE hibernate-configuration PUBLIC
2. "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
3. "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
4.<hibernate-configuration>
5. <session-factory>
6. <mapping package="test.animals"/>
7. <mapping class="test.Flight"/>
8. <mapping class="test.Sky"/>
9. <mapping class="test.Person"/>
10. <mapping class="test.animals.Dog"/>
11.
12. <mapping resource="test/animals/orm.xml"/>
13. </session-factory>
14.</hibernate-configuration>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<session-factory>
<mapping package="test.animals"/>
<mapping class="test.Flight"/>
<mapping class="test.Sky"/>
<mapping class="test.Person"/>
<mapping class="test.animals.Dog"/>
<mapping resource="test/animals/orm.xml"/>
</session-factory>
</hibernate-configuration>

复制代码

hibernate 特定的属性

Property
描述

hibernate.cache.default_cache_concurrency_strategy
当使用注解@Cacheable @Cache时，用来给的默认org.hibernate.annotations.CacheConcurrencyStrategy设置名称，@Cache(strategy="..") 可以覆盖默认设置。

hibernate.id.new_generator_mappings
值为true或者false，这个设置表示是否新建的IdentifierGenerator实现类的生成策略为AUTO、Table和Sequence。默认为false，以保持向后兼容性。

我们建议所有新项目使用hibernate.id.new_generator_mappings= true，新的生成器是更有效率和更密切的JPA规范语义。然而，他们不向后兼容现有的数据库（如果ID生成一个序列或表）。

Mapping Entities
Marking a POJO as persistent entity

Java代码

1.@Entity
2.public class Flight implements Serializable {
3. Long id;
4.
5. @Id
6. public Long getId() { return id; }
7.
8. public void setId(Long id) { this.id = id; }
9.}
10.public class Flight implements Serializable {
@Entity
public class Flight implements Serializable {
Long id;
@Id
public Long getId() { return id; }
public void setId(Long id) { this.id = id; }
}
public class Flight implements Serializable {
Defining the table
@Table元素包含一个schema和catalog属性，如果他们需要被定义。
你还可以使用@ UniqueConstraint 给表定义唯一约束（建议使用@Column.unique方法。）
Java代码
1.@Table(name="tbl_sky",
2. uniqueConstraints = {@UniqueConstraint(columnNames={"month", "day"})}
3.)
@Table(name="tbl_sky",
uniqueConstraints = {@UniqueConstraint(columnNames={"month", "day"})}
)
通过@Version设置乐观锁
Java代码
1.@Entity
2.public class Flight implements Serializable {
3. ...
4. @Version
5. @Column(name="OPTLOCK")
6. public Integer getVersion() { ... }
7.}
@Entity
public class Flight implements Serializable {
...
@Version
@Column(name="OPTLOCK")
public Integer getVersion() { ... }
}

复制代码

version这个属性会被映射成为乐观锁字段，实体管理器会通过它检测到有冲突的更新。为了防止丢失更新，可以设置最晚提交生效策略（last-commit-wins strategy）。

version字段可以是数字或者时间戳，Hibernate支持自定义的或者适当的实现UserVersionType的类型。

Mapping simple properties
Declaring basic property mappings(声明基本属性映射)
实体中任何一个非静态的、非暂时性属性都认为是持久化字段，除非使用@Transient注解。

属性不加注解相当于加@Basic，@Basic允许声明加载策略（FetchType）。

Java代码

1.public transient int counter; //transient property
2.
3.private String firstname; //persistent property
4.
5.@Transient
6.String getLengthInMeter() { ... } //transient property
7.
8.String getName() {... } // persistent property
9.
10.@Basic
11.int getLength() { ... } // persistent property
12.
13.@Basic(fetch = FetchType.LAZY)
14.String getDetailedComment() { ... } // persistent property
15.
16.@Temporal(TemporalType.TIME)
17.java.util.Date getDepartureTime() { ... } // persistent property
18.
19.@Enumerated(EnumType.STRING)
20.Starred getNote() { ... } //enum persisted as String in database
public transient int counter; //transient property
private String firstname; //persistent property
@Transient
String getLengthInMeter() { ... } //transient property
String getName() {... } // persistent property
@Basic
int getLength() { ... } // persistent property
@Basic(fetch = FetchType.LAZY)
String getDetailedComment() { ... } // persistent property
@Temporal(TemporalType.TIME)
java.util.Date getDepartureTime() { ... } // persistent property
@Enumerated(EnumType.STRING)
Starred getNote() { ... } //enum persisted as String in database

复制代码

在普通的Java API中，时间精度是没有定义的。当处理时间数据时，你可能需要在数据库中描述期望的时间精度。

时间数据可以有DATE、TIME、TIMESTAMP的精度，通过@Temporal注解可以微调。

@Lob标识属性应该持久化为Blob或者Clob类型，这决定于属性的类型。
java.sql.Clob、Character[]、char[] 和 String会持久化成Clob。
java.sql.Blob、Byte[]、byte[]和Serializable会被持久化成Blob。

Java代码