建立實體類
配置好SessionFactory之后，我們就可以開始建立一對一的單表映射了。首先需要建立一個實體類，這里Getter、Setter、toString、equals等方法省略了。我們可以方便的使用IDEA或者Eclipse的生成代碼功能輕松生成。
package yitian.data;
import java.util.Date;
public class User {
private int id;
private String username;
private String password;
private String nickname;
private Gender gender;
private String address;
private Date birthday;
private Date registerTime;
}
性別是一個枚舉：
package yitian.data;
public enum Gender {
FEMALE,
MALE
}
建立映射
有兩種方法來建立實體類與數據庫之間的映射。第一種方法是建立一個映射文件，映射文件名類似于Entity.hbm.xml，也是一個xml文件，其中定義了實體類和數據表之間的關系。這是一種傳統方式，缺點是需要一個額外的配置文件，而且XML配置容易出錯，如果放置位置不對的話還會導致找不到文件。所以現在第二種方式使用的更多。
現在更流行的方式是使用JPA注解。JPA是一個Java EE標準，定義了一組注解，將注解配置到實體類上，就可以建立實體類和數據表之間的映射。下面就是一個使用注解配置的實體類：
package yitian.data;
import org.hibernate.annotations.GenericGenerator;
import org.hibernate.annotations.NaturalId;
import javax.persistence.*;
import java.util.Date;
import java.util.Objects;
@Entity
@Table(name = "user")
public class User {
private int id;
private String username;
private String password;
private String nickname;
private Gender gender;
private String address;
private Date birthday;
private Date registerTime;
public User() {
}
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
@NaturalId
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
@Column
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
@Column
public String getNickname() {
return nickname;
}
public void setNickname(String nickname) {
this.nickname = nickname;
}
@Column
@Enumerated(EnumType.STRING)
public Gender getGender() {
return gender;
}
public void setGender(Gender gender) {
this.gender = gender;
}
@Column
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
@Column
public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
@Column(name = "register_time")
@Temporal(TemporalType.DATE)
public Date getRegisterTime() {
return registerTime;
}
public void setRegisterTime(Date registerTime) {
this.registerTime = registerTime;
}
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
User user = (User) o;
return id == user.id &&
Objects.equals(username, user.username) &&
Objects.equals(password, user.password) &&
Objects.equals(nickname, user.nickname) &&
gender == user.gender &&
Objects.equals(address, user.address) &&
Objects.equals(birthday, user.birthday) &&
Objects.equals(registerTime, user.registerTime);
}
@Override
public int hashCode() {
return Objects.hash(id, username, password, nickname, gender, address, birthday, registerTime);
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", username='" + username + '\'' +
", password='" + password + '\'' +
", nickname='" + nickname + '\'' +
", gender=" + gender +
", address='" + address + '\'' +
", birthday=" + birthday +
", registerTime=" + registerTime +
'}';
}
}
使用到的注解如下：
- Entity和Table注解用來標記實體類。默認情況下表名和實體類名相同，如果希望自定義表名使用Table注解并設置相應的name屬性。
- Id注解標明了主鍵。GeneratedValue表示自動生成主鍵，生成策略默認為AUTO，表示由Hibernate根據數據庫類型自動選擇合適的策略。如果希望在不同數據庫之間有更好的可移植性，就選擇默認策略。
- NaturalId指定實體類的自然主鍵。一般情況下推薦使用無意義的數字作為主鍵，但是有時候類似于用戶名、書籍編號這樣的屬性也具有主鍵的意義。這時候我們將這些屬性定義為自然主鍵。同樣可以向主鍵使用，更為方便。
- Column將對應的實體類屬性映射到數據表的列上，可以添加name參數自定義數據表的列名。
- Temporal表示這一列數據是一個日期類型，具體的日期類型由TemporalType枚舉表示，有DATE、TIME、TIMESTAMP三個類型，表示三種日期類型。
- Enumerated用來映射枚舉類型，可以使用EnumType枚舉定義如何映射枚舉，如果是
EnumType.ORDINAL，那么就會使用枚舉對應的數字，如果使用EnumType.STRING，就會使用枚舉對應的名稱。
注解即可以放在字段上，也可以放在方法上。如果放在字段上，Hibernate就會使用字段對數據進行操作。如果放在方法上，Hibernate就使用方法操作數據。不論哪種都是可以的，但是需要注意保持一致性，不能混用。Hibernate檢索的依據是Id注解的位置，如果Id放在了方法上而其他注解放在了字段上，Hibernate就會忽略字段上的所有注解，反之亦然。推薦將注解放在方法上，因為如果方法中進行了額外的操作，我們就可以保證這些操作能夠正確的執行。
上面這個實體類基本上涵蓋了常用的類型映射和方法。我們做一個簡單的小程序完全夠用了。不過僅僅添加注解還是不夠的，我們需要向hibernate.cfg.xml中添加一句，表示我們使用注解配置了某個類。
<mapping class="yitian.data.User"/>
這樣，我們的Hibernate的單表映射就配置完成了。
CRUD
CRUD也就是英文的增刪查改的意思，我們配置好單表映射之后，就可以利用Hibernate提供的方法方便的操作數據了。
添加
Hibernate支持事務，因此在添加數據之前需要新建一個事務，添加完數據之后需要提交事務。這一點在代碼中很清楚。如果事務失敗，可以使用rollback()方法回滾事務，返回到操作之前的狀態。
添加數據使用save方法。這個方法很簡單，直接看代碼就可以了。
@Test
public void testAdd() {
User user = new User();
user.setUsername("yitian");
user.setPassword("12345678");
user.setBirthday(new Date());
user.setGender(Gender.MALE);
user.setRegisterTime(new Date());
try (Session session = factory.openSession()) {
session.beginTransaction();
session.save(user);
session.getTransaction().commit();
}
try (Session session = factory.openSession()) {
Query<User> query = session.createQuery("from User");
List<User> users = query.list();
Assert.assertNotNull(users);
}
}
查詢
Hibernate支持多種查詢操作。這里僅僅用了最簡單的HQL語句，查詢性別為男的所有人。詳細的查詢方法會在后面說明。
@Test
public void testQuery() {
try (Session session = factory.openSession()) {
Query<User> findAllMan = session.createQuery("from User u where u.gender='MALE'");
List<User> users = findAllMan.list();
Assert.assertNotNull(users);
logger.debug(users.toString());
}
}
更新
更新使用update()方法，首先需要取出一個對象，修改屬性之后在使用update方法更新到數據庫中。不要忘了提交事務。
@Test
public void testUpdate() {
try (Session session = factory.openSession()) {
session.beginTransaction();
User u = session.bySimpleNaturalId(User.class).load("zhang3");
u.setEmail("zhang3m@yitian.com");
session.update(u);
session.getTransaction().commit();
u = session.bySimpleNaturalId(User.class).load("zhang3");
Assert.assertEquals(u.getEmail(), "zhang3m@yitian.com");
}
}
刪除
刪除方法是delete()，傳輸要刪除的對象，然后提交事務即可。
@Test
public void testDelete() {
User user = new User();
user.setUsername("wuli");
user.setNickname("嗚嗚嗚");
try (Session session = factory.openSession()) {
session.beginTransaction();
session.save(user);
session.getTransaction().commit();
User u = session.bySimpleNaturalId(User.class).load("wuli");
logger.debug(u.toString());
Assert.assertNotNull(u);
session.beginTransaction();
session.delete(u);
session.getTransaction().commit();
u = session.bySimpleNaturalId(User.class).load("wuli");
Assert.assertNull(u);
}
}
這里還使用到了bySimpleNaturalId方法。如果實體類中只定義了一個自然主鍵，就可以使用這個方法然后使用load方法獲取自然主鍵對應的對象。
以上就是Hibernate單表映射的簡單例子。代碼沒有給完全，主要看一看Hibernate的運行模式即可。看到這里，大家應該對Hibernate有了大致的了解。
