Hibernate注解

hibernate注解

常用的hibernate annotation标签如下:

@Entity

--注释声明该类为持久类。

@Table(name="promotion_info") --持久性映射的表(表名="promotion_info)。

@Column（name=”DESC”,nullable=false,length=512) --用于指定持久属性或字段的映射列。

@Id

--注释可以表明哪种属性是该类中的独特标识符(即相当于数据表的主键)。 @GeneratedValue

--定义自动增长的主键的生成策略。

@Transient

--将忽略这些字段和属性,不用持久化到数据库。 @Temporal(TemporalType.TIMESTAMP)

--声明时间格式 。 @Enumerated

--声明枚举

@Version

--声明添加对乐观锁定的支持 @OneToOne

--可以建立实体bean之间的一对一的关联 @OneToMany

--可以建立实体bean

之间的一对多的关联

@ManyToOne

--可以建立实体bean之间的多对一的关联 @ManyToMany

--可以建立实体bean之间的多对多的关联

@Formula

--一个SQL表达式，这种属性是只读的,不在数据库生成属性(可以使用sum、average、max等)

@OrderBy

--Many端某个字段排序(List)

下面是对以上常用Hibernate注解标签的详细介绍与举例：

@Entity

--注释声明该类为持久类。将一个Javabean类声明为一个实体的数据库表映射类,最好实现序列化.此时,默认情况下,所有的类属性都为映射到数据表的持久性字段.若在类中,添加另外属性,而非映射来数据库的, 要用下面的Transient来注解.

@Table(name="promotion_info")

--持久性映射的表(表名="promotion_info).@Table是类一级的注解,定义在@Entity下

为实体bean映射表,目录和schema的名字,默认为实体bean的类名,不带包名.

示例：

@Entity

@Table(name="CUST", schema="RECORDS") public class Customer { ... }

@Column（name=”DESC”,nullable=false,length=512)

--用于指定持久属性或字段的映射列。如果没有指定 Column 注释，则应用默认值。

该注释下的一些具体属性如下：

① unique属性表示该字段是否为唯一标识，默认为false。如果表中有一个字段需要唯一标识，则既可以使用该标记，也可以使用@Table标记中的@UniqueConstraint。

② nullable属性表示该字段是否可以为null值，默认为true。

③ insertable属性表示在使用“INSERT”脚本插入数据时，是否需要插入该字段的值。 ④ updatable属性表示在使用“UPDATE”脚本插入数据时，是否需要更新该字段的值。insertable和updatable属性一般多用于只读的属性，例如主键和外键等。这些字段的值通常是自动生成的。

⑤ columnDefinition属性表示创建表时，该字段创建的SQL语句，一般用于通过Entity生成表定义时使用。

⑥ table属性表示当映射多个表时，指定表的表中的字段。默认值为主表的表名。 ⑦ length属性表示字段的长度，当字段的类型为varchar时，该属性才有效，默认为255个字符。

⑧ precision属性和scale属性表示精度，当字段类型为double时，precision表示数值的总长度，scale表示小数点所占的位数。

示例 1：

@Column(name="DESC", nullable=false, length=512) public String getDescription() { return description; }

示例 2：

@Column(name="DESC",columnDefinition="CLOB NOT NULL",table="EMP_DETAIL") @Lob

public String getDescription() { return description; }

示例3：

@Column(name="ORDER_COST", updatable=false, precision=12, scale=2) public BigDecimal getCost() { return cost; }

@Id

--注释可以表明哪种属性是该类中的独特标识符(即相当于数据表的主键)。

示例：

@Id

public Long getId() { return id; }

@GeneratedValue

--定义自动增长的主键的生成策略. 示例 1：

@Id

@GeneratedValue(strategy=SEQUENCE, generator="CUST_SEQ") @Column(name="CUST_ID") public Long getId() { return id; }

示例 2： @Id

@GeneratedValue(strategy=TABLE, generator="CUST_GEN") @Column(name="CUST_ID") Long id;�

@Transient

--将忽略这些字段和属性,不用持久化到数据库.适用于,在当前的持久类中,某些属性不是用于映射到数据表,而是用于其它的业务逻辑需要,这时,须将这些属性进行transient的注解.否则系统会因映射不到数据表相应字段而出错.

示例：�

@Entity�

public class Employee {� @Id int id;�

@Transient User currentUser;� ...� }�

@Temporal(TemporalType.TIMESTAMP)

--声明时间格式

示例：

@Temporal(DATE)

protected Java.util.Date endDate; @Enumerated

--声明枚举

示例：

public enum EmployeeStatus {FULL_TIME, PART_TIME, CONTRACT} public enum SalaryRate {JUNIOR, SENIOR, MANAGER, EXECUTIVE}

@Entity public class Employee { public EmployeeStatus getStatus() {...} @Enumerated(STRING)

public SalaryRate getPayScale() {...} ... }

@Version

--声明添加对乐观锁定的支持