Hibernate（一）——入门

1. 前言

Hibernate是一个开放源代码的ORM持久化框架，它对JDBC进行了非常轻量级的对象封装，使得Java程序员可以随心所欲的使用对象编程思维来操纵数据库。所谓ORM，即Object-Relational Mapping，它的作用就是在关系型数据库和对象之间做了一个映射。从对象（Object）映射到关系（Relation），再从关系映射到对象。这样，我们在操作数据库的时候，不需要再去和复杂SQL打交道，只要像操作对象一样操作它就可以了持久化，即把数据（如内存中的对象）保存到可永久保存的存储设备中（如磁盘）。持久化的主要应用是将内存中的对象存储在关系型的数据库中，当然也可以存储在磁盘文件中、XML数据文件中等等。

2. 入门

（1）jar包引入：

       

除了sqljdbc.jar可根据自己的数据库驱动换成其他jar包，其他包都是必须的。下载地址：http://hibernate.org/orm/。因为本例中我们需要使用注解，所以请下载3.0版本以上的包。

（2）数据表准备

CREATE TABLE tbUser (
    userID VARCHAR(50),
    loginName VARCHAR(200),
    userName VARCHAR(200),
    passWord VARCHAR(200)
)

（3）创建表tbUser对应的对象

所谓的ORM就是要将关系型数据库的数据表映射为JAVA对象，所以理所应当的我们需要为tbUser表建立一个JAVA对象与其相对应。

package com.luych.hibernate.study.entity;

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Table;

@Entity
@Table(name="tbUser")
public class UserEntity {

    @Id
    private String userID;
    private String loginName;
    private String userName;
    private String passWord;

    public String getUserID() {
        return userID;
    }
    public void setUserID(String userID) {
        this.userID = userID;
    }
    public String getLoginName() {
        return loginName;
    }
    public void setLoginName(String loginName) {
        this.loginName = loginName;
    }
    public String getUserName() {
        return userName;
    }
    public void setUserName(String userName) {
        this.userName = userName;
    }
    public String getPassWord() {
        return passWord;
    }
    public void setPassWord(String passWord) {
        this.passWord = passWord;
    }
    @Override
    public String toString() {
        return loginName+", "+userName+", "+passWord+", "+userID;
    }


}

@Entity： 此注解来通知Hibernate，该对象为ORM对象。

@Table(name="tbUser")：此注解来通知Hibernate，该对象对应的数据表为tbUser，将来针对此对象的新增、修改、删除、查询等操作都会映射到tbUSer数据表中。

@id：此注解表示userID为主键，是对象的唯一标识，一般数据库设计时候也会将userID字段设置为主键。Hibernage的对象缓存会根据@id标识的主键来进行处理。

@Column：此注解在本例中没有出现。当数据库中字段名和JAVA对象属性名称不一致的时候，可以用此注解来描述其对应关系。如下例（数据库字段为LOGIN_NAME，对象属性为loginName）：

@Column(name="LOGIN_NAME")
private String loginName;

 @Transient：此注解在本例中也没有出现。如果JAVA对象中的某个属性，并没有数据表的字段与其相对应，那么就用此注解标注该属性。Hibernate针对此对象进行增删改查的时候回忽略此属性。例如：我们要为UserEntity对象增加一个登陆次数（由其他数据表统计而来），那么处理如下：

@Transient
private int loginCnt;

另外，我们改造了toString方法，后面的测试代码中将要用到。

（4）配置Hibernate文件

建立Hibernate的配置文件，路径和文件名任意。本例为：hibernate-config.xml。内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration PUBLIC
    "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
    "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
    <session-factory>
        <!-- 设置数据库驱动 -->
        <property name="hibernate.connection.driver_class">
                com.microsoft.sqlserver.jdbc.SQLServerDriver
        </property>
        <!-- 设置数据库URL -->
        <property name="hibernate.connection.url">
                jdbc:sqlserver://192.168.9.23:14433;databaseName=tempdb
        </property>
        <!-- 数据库用户名 -->
        <property name="hibernate.connection.username">sa</property>
        <!-- 数据库密码 -->
        <property name="hibernate.connection.password">123@abcd</property>
        <!-- beans -->
        <mapping class="com.luych.hibernate.study.entity.UserEntity"/>
    </session-factory>
</hibernate-configuration>

该配置文件中，我们为Hibernate设置了数据库连接信息（驱动、URL、用户名以及密码，这些信息请根据自己实际情况来做相应变更），并通知Hibernate我们刚刚创建的UserEntity对象(mapping class="com.luych.hibernate.study.entity.UserEntity")。

(5)测试运行

package com.luych.hibernate.study.main;

import java.util.List;
import java.util.UUID;

import org.hibernate.Query;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.Configuration;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;

import com.luych.hibernate.study.entity.UserEntity;

@SuppressWarnings("unchecked")
public class TestMain {

    private Session session;

    @Before
    public void getSession(){
        //请根据自己在第三部中创建的xml文件路径及名称调整configure参数值
        Configuration config = new Configuration().configure("hibernate-config.xml");
        SessionFactory sessionFactory = config.buildSessionFactory();
        session = sessionFactory.openSession();
    }

    @After
    public void freeSession(){
        session.close();
    }

    public void sel() {
        Query query = session.createQuery("FROM UserEntity WHERE 1=1");
        List<UserEntity> userList = query.list();
        for (UserEntity userEntity : userList) {
            System.out.println(userEntity.toString());
        }
    }

    public void add() {
        session.beginTransaction();
        UserEntity user  = new UserEntity();
        user.setLoginName("luych");
        user.setUserName("卢艳超");
        user.setPassWord("12333");
        user.setUserID(UUID.randomUUID().toString());
        session.save(user);
        session.getTransaction().commit();
    }

    public void edt(){
        session.beginTransaction();
        Query query = session.createQuery("FROM UserEntity WHERE 1=1");
        List<UserEntity> userList = query.list();
        for (UserEntity userEntity : userList) {
            userEntity.setPassWord("45666");
            session.update(userEntity);
        }
        session.getTransaction().commit();
    }

    public void del(){
        session.beginTransaction();
        Query query = session.createQuery("FROM UserEntity WHERE 1=1");
        List<UserEntity> userList = query.list();
        for (UserEntity userEntity : userList) {
            session.delete(userEntity);
        }
        session.getTransaction().commit();
    }

    @Test
    public void test(){
        System.out.println("当前已有数据：");
        sel();
        del();
        System.out.println("执行删除后：");
        sel();
        add();
        add();
        System.out.println("执行新增后");
        sel();
        edt();
        System.out.println("执行修改后");
        sel();
    }
}

以上代码里，getSession方法用来根据hibernate-config.xml配置文件来获取。freeSession方法用来关闭不再使用的Session。sel方法用来查询当前数据库中的所有数据并打印到控制台；add方法即要新增一条数据；edt方法将所有的passWord都改为45666；del方法将删除所有的数据。大家看一下test方法，然后我们右键，Run As JUnit Test，控制台输出结果为：

当前已有数据：
luych, 卢艳超, 45666, 50420e9c-e751-41c3-a33d-0b6d09924da8
luych, 卢艳超, 45666, 58bd812c-4e43-4248-b0c9-9c3576c6d47c
执行删除后：
执行新增后
luych, 卢艳超, 12333, 9660637e-5447-42c0-bcfb-2b24786bc0e8
luych, 卢艳超, 12333, c0631818-cc91-4691-93fc-159c2cabe37d
执行修改后
luych, 卢艳超, 45666, 9660637e-5447-42c0-bcfb-2b24786bc0e8
luych, 卢艳超, 45666, c0631818-cc91-4691-93fc-159c2cabe37d

可以看到我们的增删改查操作都成功的完成了。以上就是Hibernate的入门基本操作，后续还会有其他探究。本文仅当是抛砖引玉吧，愿大家共勉。