http://blog.csdn.net/yerenyuan_pku/article/details/70162268

Hibernate注解开发

在Hibernate中我们一般都会使用注解，这样可以帮助我们大大简化hbm映射文件的配置。下面我就来为大家详细介绍。

PO类注解配置

首先肯定是搭建好Hibernate的开发环境啦，我在此也不过多赘述，读者自行实践。接着在src目录下创建一个cn.itheima.domain包，并在该包下创建一个Book实体类，由于Book实体类中写有注解配置，所以就不用编写那个映射配置文件啦！

@Entity // 定义了一个实体
@Table(name="t_book",catalog="hibernateTest") public class Book { @Id // 这表示一个主键 // @GeneratedValue 相当于native主键生成策略 @GeneratedValue(strategy=GenerationType.IDENTITY) // 相当于identity主键生成策略 private Integer id; // 主键 @Column(name="c_name", length=30, nullable=true) private String name; @Temporal(TemporalType.TIMESTAMP) // 是用来定义日期类型 private Date publicationDate; // 出版日期 @Type(type="double") // 允许你去指定Hibernate里面的一些类型 private Double price; // 价格，如果没有添加注解，也会自动的生成在表中 public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Date getPublicationDate() { return publicationDate; } public void setPublicationDate(Date publicationDate) { this.publicationDate = publicationDate; } public Double getPrice() { return price; } public void setPrice(Double price) { this.price = price; } }

下面我就来详细说一下Book实体类中的注解。

• @Entity：声明一个实体。

• @Table：来描述类与表之间的对应关系。

  @Entity // 定义了一个实体
  @Table(name="t_book",catalog="hibernateTest") public class Book { ...... }

• @id：声明一个主键。

• @GeneratedValue：用它来声明一个主键生成策略。默认情况是native主键生成策略。可以选择的主键生成策略有：AUTO、IDENTITY、SEQUENCE。

  @Id // 这表示一个主键
  // @GeneratedValue 相当于native主键生成策略
  @GeneratedValue(strategy=GenerationType.IDENTITY) // 相当于identity主键生成策略 private Integer id; // 主键

• @Column：定义列。

  @Column(name="c_name", length=30, nullable=true)
  private String name;

  注意：对于PO类中所有属性，如果你不写注解，默认情况下也会在表中生成对应的列，列的名称就是属性的名称，列的类型也即属性的类型。

• @Temporal：声明日期类型。

  @Temporal(TemporalType.TIMESTAMP) // 是用来定义日期类型
  private Date publicationDate; // 出版日期

  日期类型可以选择的有：

  • TemporalType.DATA：只有年月日。
  • TemporalType.TIME：只有小时分钟秒。
  • TemporalType.TIMESTAMP：有年月日小时分钟秒。

• @Type：可允许你去指定Hibernate里面的一些类型。

  @Type(type="double") // 允许你去指定Hibernate里面的一些类型
  private Double price; // 价格，如果没有添加注解，也会自动的生成在表中

编写完上述Book实体类之后，千万不要忘记下面这一步：我们最终需要在hibernate.cfg.xml文件中将我们类中的注解配置引用生效。即需要在Hibernate核心配置文件中添加如下配置：

<mapping class="cn.itheima.domain.Book"/>

最后我们在src目录下创建一个cn.itheima.test包，在该包下编写一个HibernateAnnotationTest单元测试类，并在该类中编写一个用于测试PO类的注解开发的方法：

public class HibernateAnnotationTest {// 测试PO的注解开发@Testpublic void test1() { Session session = HibernateUtils.openSession(); session.beginTransaction(); Book b = new Book(); b.setName("情书"); b.setPrice(56.78); b.setPublicationDate(new Date()); session.save(b); session.getTransaction().commit(); session.close(); } }

现在来思考两个问题：

1. 如果主键生成策略我们想使用UUID类型呢？
2. 如何设定类的属性不在表中映射？

这两个问题我们一起解决。废话不多说，直接上例子。在cn.itheima.domain包下再编写一个Person实体类，同样使用注解配置。

@Entity
@Table(name="t_person", catalog="hibernateTest")
public class Person { // 生成UUID的主键生成策略 @Id @GenericGenerator(name="myuuid", strategy="uuid") // 声明一种主键生成策略(uuid) @GeneratedValue(generator="myuuid") // 引用uuid主键生成策略 private String id; @Type(type="string") // 允许你去指定Hibernate里面的一些类型 private String name; @Transient private String msg; // 现在这个属性不想生成在表中 public String getId() { return id; } public void setId(String id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getMsg() { return msg; } public void setMsg(String msg) { this.msg = msg; } }

当然不要忘记这一步了：我们最终需要在hibernate.cfg.xml文件中将我们类中的注解配置引用生效，故需要在Hibernate核心配置文件中添加如下配置：

<mapping class="cn.itheima.domain.Person"/>

最后在HibernateAnnotationTest单元测试类中编写如下一个方法：

public class HibernateAnnotationTest {// 测试uuid的主键生成策略及不生成表中映射@Testpublic void test2() { Session session = HibernateUtils.openSession(); session.beginTransaction(); Person p = new Person(); p.setName("李四"); p.setMsg("这是一个好人"); session.save(p); session.getTransaction().commit(); session.close(); } }

至此，两个问题就解决了。 
注意：对于我们以上讲解的关于属性配置的注解，我们也可以在其对应的getXxx方法去使用。

Hibernate关联映射——一对多（多对一）

仍以客户(Customer)和订单(Order)为例来开始我的表演。 
在src目录下创建一个cn.itheima.oneToMany包，并在该包编写这两个实体类：

• 客户(Customer)类

  // 客户 ---- 一的一方
  @Entity
  @Table(name="t_customer")
  public class Customer { @Id @GeneratedValue(strategy=GenerationType.IDENTITY) private Integer id; // 主键 private String name; // 姓名 // 描述客户可以有多个订单 /* * targetEntity="..."：相当于<one-to-many class="..."> * mappedBy="..."：相当于inverse=true，即放弃关联关系的维护，不然会生成一个中间表 */ @OneToMany(targetEntity=Order.class,mappedBy="c") private Set<Order> orders = new HashSet<Order>(); public Set<Order> getOrders() { return orders; } public void setOrders(Set<Order> orders) { this.orders = orders; } public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } }

• 订单(Order)类

  // 订单 ---- 多的一方
  @Entity
  @Table(name="t_order")
  public class Order { @Id @GeneratedValue(strategy=GenerationType.IDENTITY) private Integer id; private Double money; private String receiverInfo; // 收货地址 // 订单与客户关联 @ManyToOne(targetEntity=Customer.class) @JoinColumn(name="c_customer_id") // 指定外键列 private Customer c; // 描述订单属于某一个客户 public Customer getC() { return c; } public void setC(Customer c) { this.c = c; } public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public Double getMoney() { return money; } public void setMoney(Double money) { this.money = money; } public String getReceiverInfo() { return receiverInfo; } public void setReceiverInfo(String receiverInfo) { this.receiverInfo = receiverInfo; } }

  这儿用到了@OneToMany和@ManyToOne这两个注解。

以上两个实体类编写好之后，可以很明显的看出我们不需要写它们对应的映射配置文件了，是不是很爽呢！接下来，我就要编写测试程序测试一下了。现在我的需求是保存客户时，顺便保存订单，对于这种情况我们需要在Customer类中配置cascade操作，即配置cascade="save-update"，配置的方式有两种，下面我细细说来：

1. 第一种方式，可以使用JPA提供的注解。 
   那么@OneToMany注解就应修改为：

   @OneToMany(targetEntity=Order.class,mappedBy="c",cascade=CascadeType.ALL)
   private Set<Order> orders = new HashSet<Order>();

2. 第二种方式，可以使用Hibernate提供的注解。 
   那么@OneToMany注解就应修改为：

   @OneToMany(targetEntity=Order.class,mappedBy="c")
   @Cascade(CascadeType.SAVE_UPDATE)
   private Set<Order> orders = new HashSet<Order>();

两种方式都可以，口味任君选择，不过我倾向于第二种方式。 
接下来在HibernateAnnotationTest单元测试类中编写如下方法进行测试：

public class HibernateAnnotationTest {// 测试one-to-many注解操作(保存客户时级联保存订单)@Testpublic void test3() { Session session = HibernateUtils.openSession(); session.beginTransaction(); // 1.创建一个客户 Customer c = new Customer(); c.setName("叶子"); // 2.创建两个订单 Order o1 = new Order(); o1.setMoney(1000d); o1.setReceiverInfo("武汉"); Order o2 = new Order(); o2.setMoney(2000d); o2.setReceiverInfo("天门"); // 3.建立关系 c.getOrders().add(o1); c.getOrders().add(o2); // 4.保存客户，并级联保存订单 session.save(c); session.getTransaction().commit(); session.close(); } }

这时运行以上方法，会发现虽然客户表的那条记录插进去了，但是订单表就变成这个鬼样了： 
 
订单表中没有关联客户的id，这是为什么呢？原因是我们在Customer类中配置了mappedBy=”c”，它代表的是外键的维护由Order方来维护，而Customer不维护，这时你在保存客户时，级联保存订单，是可以的，但是不能维护外键，所以，我们必须在代码中添加订单与客户之间的关系。所以须将test3方法修改为：

public class HibernateAnnotationTest {// 测试one-to-many注解操作(保存客户时级联保存订单)@Testpublic void test3() { Session session = HibernateUtils.openSession(); session.beginTransaction(); // 1.创建一个客户 Customer c = new Customer(); c.setName("叶子"); // 2.创建两个订单 Order o1 = new Order(); o1.setMoney(1000d); o1.setReceiverInfo("武汉"); Order o2 = new Order(); o2.setMoney(2000d); o2.setReceiverInfo("天门"); // 3.建立关系 // 原因：是为了维护外键，不然的话，外键就不能正确的生成！！！ o1.setC(c); o2.setC(c); // 原因：是为了进行级联操作 c.getOrders().add(o1); c.getOrders().add(o2); // 4.保存客户，并级联保存订单 session.save(c); session.getTransaction().commit(); session.close(); } }

这时再测试，就没有任何问题啦！

扩展

Hibernate注解@Cascade中的DELETE_ORPHAN已经过时了，如下： 

可使用下面方案来替换过时方案： 

Hibernate关联映射——多对多

以学生与老师为例开始我的表演，我是使用注解完成这种多对多的配置。使用@ManyToMany注解来配置多对多，只需要在一端配置中间表，另一端使用mappedBy表示放置外键的维护权。 
在src目录下创建一个cn.itheima.manyToMany包，并在该包编写这两个实体类：

• 学生类

  @Entity
  @Table(name="t_student")
  public class Student { @Id @GeneratedValue(strategy=GenerationType.IDENTITY) private Integer id; private String name; @ManyToMany(targetEntity=Teacher.class) // @JoinTable：使用@JoinTable来描述中间表，并描述中间表中外键与Student、Teacher的映射关系 // joinColumns：它是用来描述Student与中间表的映射关系 // inverseJoinColumns：它是用来描述Teacher与中间表的映射关系 @JoinTable(name="s_t", joinColumns={@JoinColumn(name="c_student_id",referencedColumnName="id")}, inverseJoinColumns={@JoinColumn(name="c_teacher_id")}) private Set<Teacher> teachers = new HashSet<Teacher>(); public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Set<Teacher> getTeachers() { return teachers; } public void setTeachers(Set<Teacher> teachers) { this.teachers = teachers; } }

• 老师类

  @Entity
  @Table(name="t_teacher")
  public class Teacher { @Id @GeneratedValue(strategy=GenerationType.IDENTITY) private Integer id; private String name; @ManyToMany(targetEntity=Student.class, mappedBy="teachers") // 代表由对方来维护外键 private Set<Student> students = new HashSet<Student>(); public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Set<Student> getStudents() { return students; } public void setStudents(Set<Student> students) { this.students = students; } }

接下来，我就要编写测试程序测试一下了。 从上面可看出我们将外键的维护权利交由Student类来维护，现在我们演示保存学生时，将老师也级联保存，对于这种情况我们需要在Student类中配置cascade操作，即配置cascade=”save-update”，如下：

@JoinTable(name="s_t", joinColumns={@JoinColumn(name="c_student_id",referencedColumnName="id")}, inverseJoinColumns={@JoinColumn(name="c_teacher_id")}) @Cascade(CascadeType.SAVE_UPDATE) private Set<Teacher> teachers = new HashSet<Teacher>();

接下来在HibernateAnnotationTest单元测试类中编写如下方法进行测试：

public class HibernateAnnotationTest {// 测试多对多级联保存(保存学生时同时保存老师)@Testpublic void test4() {Session session = HibernateUtils.openSession();session.beginTransaction();// 1.创建两个老师 Teacher t1 = new Teacher(); t1.setName("Tom"); Teacher t2 = new Teacher(); t2.setName("Fox"); // 2.创建两个学生 Student s1 = new Student(); s1.setName("张丹"); Student s2 = new Student(); s2.setName("叶紫"); // 3.学生关联老师 s1.getTeachers().add(t1); s1.getTeachers().add(t2); s2.getTeachers().add(t1); s2.getTeachers().add(t2); // 保存学生同时保存老师 session.save(s1); session.save(s2); session.getTransaction().commit(); session.close(); } }

运行以上方法，一切正常。 
接着我们测试级联删除操作。见下图： 

可在HibernateAnnotationTest单元测试类中编写如下方法进行测试：

public class HibernateAnnotationTest {// 测试多对多级联删除(前提是建立了双向的级联)@Testpublic void test5() { Session session = HibernateUtils.openSession(); session.beginTransaction(); Student s = session.get(Student.class, 1); session.delete(s); session.getTransaction().commit(); session.close(); } }

运行以上方法，所有表的数据都删光光了，所以实际开发中我们要慎用哟！！！

Hibernate关联映射——一对一

以人与身份证为例开始我的表演。一对一操作有两种映射方式：

1. 在任意一方添加外键
2. 主键映射

外键映射

我先讲外键映射，这个在实际开发中用的比较多，而且比较容易掌握哟！ 
在src目录下创建一个cn.itheima.oneToOne包，并在该包编写这两个实体类：

• User类

  @Entity
  @Table(name="t_user")
  public class User { @Id @GenericGenerator(strategy="uuid",name="myuuid") @GeneratedValue(generator="myuuid") private String id; private String name; @OneToOne(targetEntity=IDCard.class,mappedBy="user") private IDCard idCard; public String getId() { return id; } public void setId(String id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public IDCard getIdCard() { return idCard; } public void setIdCard(IDCard idCard) { this.idCard = idCard; } }

  上述配置使得t_user表放弃对外键的维护权利。

• IDCard类

  @Entity
  @Table(name="t_idcard")
  public class IDCard { @Id @GenericGenerator(strategy="uuid",name="myuuid") @GeneratedValue(generator="myuuid") private String id; private String cardNum; @OneToOne(targetEntity=User.class) @JoinColumn(name="c_user_id") @Cascade(CascadeType.SAVE_UPDATE) private User user; public String getId() { return id; } public void setId(String id) { this.id = id; } public String getCardNum() { return cardNum; } public void setCardNum(String cardNum) { this.cardNum = cardNum; } public User getUser() { return user; } public void setUser(User user) { this.user = user; } }

  @JoinColumn用于指定外键列的名称，当前配置的外键是在t_idcard表中。而且还设置了级联保存操作，即保存身份证时，可以顺便保存人。

接下来在HibernateAnnotationTest单元测试类中编写如下方法进行测试：

public class HibernateAnnotationTest {// 测试一对一操作外键映射方案(由t_idcard表来维护外键)@Testpublic void test6() { Session session = HibernateUtils.openSession(); session.beginTransaction(); // 1.创建一个人 User user = new User(); user.setName("叶子"); // 2.创建一个身份证 IDCard idCard = new IDCard(); idCard.setCardNum("429006199010241657"); // 3.让身份证关联人 idCard.setUser(user); // 4.存储身份证 session.save(idCard); session.getTransaction().commit(); session.close(); } }

测试以上方法，一切正常。

主键映射(了解)

主键映射挺复杂的，我们只须了解即可，而且实际开发中用到的并不是很多。但我还是简单介绍一下。 
以Husband与Wife为例进行讲解。 
同样也是在cn.itheima.oneToOne包下编写这两个实体类：

• Wife类

  @Entity
  @Table(name="t_wife")
  public class Wife { @Id @GenericGenerator(name="myuuid",strategy="uuid") @GeneratedValue(generator="myuuid") private String id; private String name; @OneToOne @PrimaryKeyJoinColumn @Cascade(CascadeType.SAVE_UPDATE) private Husband husband; public String getId() { return id; } public void setId(String id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Husband getHusband() { return husband; } public void setHusband(Husband husband) { this.husband = husband; } }

  从上面可以看出t_wife表的主键生成策略是uuid，@PrimaryKeyJoinColumn注解说明了Husband类与Wife类是使用了主键映射。而且还设置了级联保存操作，即保存妻子时，可以顺便丈夫。

• Husband类

  @Entity
  @Table(name="t_husband")
  public class Husband { @Id @GenericGenerator(name="myForeignKey",strategy="foreign",parameters={ @Parameter(name="property",value="wife")}) // 自定义主键生成策略，让t_husband表的主键去参考t_wife表的主键 @GeneratedValue(generator="myForeignKey") private String id; private String name; @OneToOne(mappedBy="husband") // 由t_wife表来维护外键 @PrimaryKeyJoinColumn private Wife wife; public String getId() { return id; } public void setId(String id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Wife getWife() { return wife; } public void setWife(Wife wife) { this.wife = wife; } }

• t_husband表的主键我们设置成了参考t_wife表的主键的方式。

最后在HibernateAnnotationTest单元测试类中编写如下方法进行测试：

public class HibernateAnnotationTest {// 测试一对一主键生成策略@Testpublic void test7() { Session session = HibernateUtils.openSession(); session.beginTransaction(); // 创建一个丈夫 Husband husband = new Husband(); husband.setName("武大郎"); // 创建一个妻子 Wife wife = new Wife(); wife.setName("潘金莲"); // 要做双向关联 husband.setWife(wife); wife.setHusband(husband); session.save(wife); // 保存妻子的时候级联保存丈夫 session.getTransaction().commit(); session.close(); } }

测试以上方法，一切正常