Hibernate注解之基本注解的注解使用

文章目录

1. 1. Hibernate注解之基本注解的注解使用
   1. 1.1. 使用注解须知
   2. 1.2. 类级别注解
   3. 1.3. 属性级别的注解
   4. 1.4. 主键相关的注解
   5. 1.5. 与非主键相关的注解
   6. 1.6. 实例
   7. 1.7. @JoinColumn
   8. 1.8. @JoinTabl
   9. 1.9. 参考文档

Hibernate注解之基本注解的注解使用

使用注解须知

• 我们在使用注解自动创建表的时候，系统会默认为我们创建一张表Hibernate_sequence，我们可以在Hibernate.cfg.xml文件中添加如下语句解决问题<!-- 配置不生成Hibernate_sequence --> <property name="hibernate.id.new_generator_mappings">false</property>

类级别注解

1. @Entity : 映射实体类，其中有一个name属性指定当前实体类映射的表的名称
   • name: 可选属性 ，指定对应表的名称，如果没有指定name属性，那么创建表的名称和类名一样
2. @Table : 在实体类的上方使用，和Entity配合使用，指定实体类对应的数据库中的表的信息
   • name ：可选，指定表的名称，默认的是和类名一样，只有在不一致的情况下才会指定表名
   • catalog ： 可选，表示Catalog名称，默认为 Catalog(“”)
   • schema ： 可选 , 表示 Schema 名称 , 默认为Schema(“”)

属性级别的注解

• 属性级别的注解在getXXX()方法上使用
• @Id 映射生成主键
• @Version 定义乐观锁
• @Column 映射表的列
• @Transient 定义暂态属性

主键相关的注解

1. @id： 指定该属性为主键
2. @GeneratedValue(strategy=,generator="") : 主键生成策略
   • Strategy的值
     • GenerationType.AUTO - 根据底层数据库自动选择（默认），若数据库支持自动增长类型，则为自动增长。
     • GenerationType.INDENTITY - 根据数据库的Identity字段生成，支持DB2、MySQL、 MS、SQL Server、SyBase与HyperanoicSQL数据库的Identity 类型主键。
     • GenerationType.SEQUENCE - 使用Sequence来决定主键的取值，适合Oracle、DB2等 支持Sequence的数据库，一般结合@SequenceGenerator使用。
     • GenerationType.TABLE - 使用指定表来决定主键取值，结合@TableGenerator使用。

与非主键相关的注解

1. @Version - 可以在实体bean中使用@Version注解,通过这种方式可添加对乐观锁定的支持
2. @Basic - 用于声明属性的存取策略：
   • @Basic(fetch=FetchType.EAGER) 即时获取（默认的存取策略）
   • @Basic(fetch=FetchType.LAZY) 延迟获取
3. @Temporal
   • 这个使用来设置数据库表中显示的日期的精度，因为java中的Date属性可以对应着数据库中的三种类型(DATE,TIME, TIMESTAMP)即是单纯的表示日期，时间，两者兼备的，默认的是两者兼备的，输出的是:2012-01-22 17:55:55
   • 因此可以使用@Temporal来设置显示的时间的精度，这三种的表示形式如下：
   • TemporalType.TIME 输出到数据库中的仅仅是小时格式的，比如:12:22:12
   • TemporalType.DATE 输出到数据库中的是日期的格式：2012-12-01
   • TemporalType.TIMESTAMP 两者兼备，这个是默认的
4. @Column - 可将属性映射到列，使用该注解来覆盖默认值，@Column描述了数据库表中 该字段的详细定义，这对于根据 JPA 注解生成数据库表结构的工具非常有作用。
   • name - 可选，表示数据库表中该字段的名称，默认情形属性名称一致
   • nullable -可选，表示该字段是否允许为 null，默认为true
   • unique - 可选，表示该字段是否是唯一标识，默认为 false
   • length - 可选，表示该字段的大小，仅对 String 类型的字段有效，默认值255.
   • insertable -可选，表示在ORM框架执行插入操作时，该字段是否应出现INSETRT 语句中，默认为 true
   • updateable -可选，表示在ORM 框架执行更新操作时，该字段是否应该出现在 UPDATE语句中，默认为 true. 对于一经创建就不可以更改的字段，该 属性非常有用，如对于 birthday字段。
   • columnDefinition - 可选，表示该字段在数据库中的实际类型。通常ORM框架可以根 据属性类型自动判断数据库中字段的类型，但是对于Date类型仍无法确定数据 库中字段类型究竟是 DATE,TIME还是 TIMESTAMP. 此外 ,String 的默认映射类型为VARCHAR, 如果要将 String 类型映射到特定数据库的 BLOB或 TEXT字段类型，该属性非常有用。
5. @Transient - 可选，表示该属性并非一个到数据库表的字段的映射，ORM框架将忽略该属性，如果一个属性并非数据库表的字段映射，就务必将其标示为@Transient。
   • 如果使用这个注解，那么表中不会出现这个字段

实例

• 我们现在创建一个实体类Teacher，映射到数据库teacher表中

import java.util.Date;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;
import javax.persistence.Temporal;
import javax.persistence.TemporalType;
import javax.persistence.Transient;
@Entity
@Table(name="teacher")
public class Teacher {
	private int id;  //主键
	private String name;
	private int age;
	private double sal;
	private Date joinDate;
	private String wife;  //妻子的名字

	@Transient   //设置该属性不在表中
	public String getWife() {
		return wife;
	}

	public void setWife(String wife) {
		this.wife = wife;
	}
	@Id
	@GeneratedValue(strategy=GenerationType.AUTO) //设置主键自增长
	public int getId() {
		return id;
	}

	@Temporal(TemporalType.DATE)   //设置时间精确到天数，2012-01-12
	@Column(name="JoinTime")   //改变表中字段的名字
	public Date getJoinDate() {
		return joinDate;
	}
	public void setId(int id) {
		this.id = id;
	}
	@Column(nullable=false)   //设置名字不为空
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public int getAge() {
		return age;
	}
	public void setAge(int age) {
		this.age = age;
	}
	public double getSal() {
		return sal;
	}
	public void setSal(double sal) {
		this.sal = sal;
	}

	public void setJoinDate(Date joinDate) {
		this.joinDate = joinDate;
	}
}

• 在核心配置文件(hibernate.cfg.xml)中配置这个映射<!-- 直接指定这个Teacher实体类的全类名即可，即是完成了映射 --> <mapping class="cn.tedu.bean.Teacher"></mapping>

@JoinColumn

• 我们知道外键的生成的字段的名称是默认的，但是我们也可以使用这个注解改变这个名称
• 这个注解是用来设置自动生成的外键的属性，比如外键的名称，非空……
• name 指定外键的名称
• nullable 指定外键是否为空，默认的是true
• unique 生成唯一的约束，就是这个字段的值唯一，默认的false

@JoinTabl

• 当涉及到多对多的映射关系的时候，用来定义第三表的表名，和字段的名称。
• name 设置第三张表的名称
• joinColumns 设置的是当前实体类对应的表在第三张表的外键的字段名称
• inverseJoinColumns 设置的是另外一个实体类对应的表在第三张表的外键的字段名称

参考文档

• http://docs.jboss.org/hibernate/annotations/3.4/reference/zh_cn/html_single/#d0e1148
• http://www.cnblogs.com/qjjazry/p/6306744.html