学习hibernate（一） -- hibernate环境搭建

1.下载hibernate

    须要到hibernate的官网下载一个hibernate。网址是：http://hibernate.org/orm/downloads/

2.解压hibernate

    下载后解压缩，获得一个hibernate-release-4.3.11.Final文件夹（我下载的hibernate版本是4.3.11），在hibernate-release-4.3.11.Final文件夹里有一个lib文件夹，里面放着hibernate的jar包。

    例子中使用了lib下的required文件夹中的全部jar包。如图：

    这些包的做用以下（待验证）：

包名	说明
antlr-2.7.7	能够接收词文法语言描述，并能产生识别这些语言的语句的程序，hibernate利用它实现hql到sql的转换。
dom4j-1.6.1	xml解析器，用来读写xml文件的。
hibernate-commons-annotations-4.0.5.Final	hibernate中支持注解开发的程序。
hibernate-core-4.3.11.Final	hibernate的核心程序。
hibernate-jpa-2.1-api-1.0.0.Final	hibernate对jap(java persistence API)规范的支持，能够理解为JAP是标准接口，hibernate是实现。
jandex-1.1.0.Final	用来检索注解(annotation)索引的程序，识别该对象是注解对象(待验证)？
javassist-3.18.1-GA	用来操做字节码的程序，可直接编辑和生成java字节码，以达到对.class文件的动态修改。
jboss-logging-3.1.3.GA	提供hibernate日志功能的程序(待验证)?
jboss-logging-annotations-1.2.0.Beta1	解析logging的注解模式程序(待验证)?
jboss-transaction-api_1.2_spec-1.0.0.Final	事务控制程序(待验证)?

3.导入hibernate的jar包

    建立一个JavaProject，引用上面图片中的jar包，这里须要另一个jar包，因为我链接的是mysql数据库，因此须要在导入一个mysql-connector-java-5.1.7-bin.jar

4.新建一个测试用的java对象

package cn.net.bysoft.lesson1;

import java.util.Date;

public class User {

    public User() {
    }

    public User(String name, Date birthday) {
        this.name = name;
        this.birthday = birthday;
    }

    @Override
    public String toString() {
        return "User [id=" + id + ", name=" + name + ", birthday=" + birthday
                + "]";
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Date getBirthday() {
        return birthday;
    }

    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }

    private int id;
    private String name;
    private Date birthday;
}

    编写的java对象须要知足以下要素：

• 须要有一个无参的构造函数，由于在session.get时须要用到反射建立java对象；

• 须要提供一个id属性，对应数据库的主键；

• 须要为对象的其余属性提供get/set方法；

• 须要定义成非final的类，以便在hibernate进行延迟加载时为类建立代理；

• 若有必要保存到集合中，须要重equals方法和hashcode方法；

5.设置java对象与数据库的映射关系

    须要建立一个User.hbm.xml文件，编辑java对象与数据库的映射关系，格式以下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping>
    <class name="cn.net.bysoft.lesson1.User" table="S_USER">
        <id name="id" type="integer" column="ID">
            <!-- 指定主键的生成方式，native是使用数据库本地的方式 -->
            <generator class="native"></generator>
        </id>
        <property name="name" type="string" column="NAME"></property>
        <property name="birthday" type="timestamp" column="BIRTHDAY"></property>
    </class>
</hibernate-mapping>

    该文件是用来配置java对象与数据表之间的映射关系的，其中须要留意的是id这个属性，generator来指定主键的生成方式，而native则表明是调用数据库本地的方式来生成主键，我使用的mysql数据库就会自动将id列设置成自增。

    主键具体有哪些生成方式，待接下来详细研究。

6.配置hibernate的配置信息

在src下建立一个hibernate.cfg.xml文件，格式以下：

<!DOCTYPE hibernate-configuration PUBLIC
    "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
    "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
    <session-factory>
        <!-- 链接数据库的基本信息 -->
        <property name="hibernate.connection.username">root</property>
        <property name="hibernate.connection.password">root</property>
        <property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
        <property name="hibernate.connection.url">jdbc:mysql://localhost:3306/hibernate4</property>
        
        <!-- hibernate使用的数据库方言
             若是不知道能够去/hibernate-release-4.3.11.Final/project/etc/hibernate.properties
             中查找 -->
        <property name="hibernate.dialect">org.hibernate.dialect.MySQL5Dialect</property>
        <!-- 是否在控制台显示sql语句 -->
        <property name="hibernate.show_sql">true</property>
        <!-- 是否格式化显示的sql语句 -->
        <property name="hibernate.format_sql">true</property>
        <!-- 是否自动生成数据表的策略,create表明每次启动程序都从新建立数据表 -->
        <property name="hibernate.hbm2ddl.auto">create</property>
        
        <!-- 须要使用到的*.hbm.xml文件 -->
        <mapping resource="cn/net/bysoft/lesson1/User.hbm.xml"/>
    </session-factory>
</hibernate-configuration>

    该文件须要注意的有两个地方，第一个是mapping属性，第二个是hibernate.hbm2ddl.auto这个属性。

    mapping属性用来配置*.hbm.xml的资源文件地址，这里须要注意的是没有用cn.net.bysoft.lession的形式，而是使用的'/'来描述目录位置。

    接下来是自动执行ddl语句的设置(也就是hibernate.hbm2ddl.auto)参数有4个，分别是：

• create

  create为每次建立sessionfactory时，会根据*.hbm.xml文件中所配置的信息来drop掉数据表，drop后从新create数据表；
  

• create-drop

  create-drop为每次建立sessionfactory时，会根据*.hbm.xml文件中所配置的信息来create数据表。而每当sessionfactory被close时，会drop掉开始时create的数据表；
  

• update

  update为每次建立sessionfactory时，若是数据库中没有对应的表，则新建。

  若已经新建过，则会判断*.hbm.xml文件的配置与创建好的数据表的结构是否相同。

  若是相同则不去进行ddl的操做。

  若是不一样，则会根据*.hbm.xml文件中有变化的配置项去更新数据表，但不会删除数据表中已建立过的任何信息。
  

• validate

  validate为每次建立sessionfactory时，将用*.hbm.xml文件中的配置信息与现有的对应的数据表结构进行比较，若发现不一样则抛出异常。
  

7.编写代码测试

package cn.net.bysoft.lesson1;

import java.util.Date;

import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.hibernate.boot.registry.StandardServiceRegistry;
import org.hibernate.boot.registry.StandardServiceRegistryBuilder;
import org.hibernate.cfg.Configuration;
import org.junit.Test;

public class UserTest {

    @Test
    public void test() {
        // 0.建立configuration对象，该对象保存着hibernate的配置信息和对象关系映射的信息。
        Configuration cfg = new Configuration().configure();
        // 1.建立sessionfactory对象
        StandardServiceRegistryBuilder builder = new StandardServiceRegistryBuilder().applySettings(cfg.getProperties());
        StandardServiceRegistry registry =  builder.build();
        SessionFactory sessionFactory = cfg.buildSessionFactory(registry); 
        // 2.建立session对象
        Session session = sessionFactory.openSession();
        // 3.开始事务
        Transaction transaction = session.beginTransaction();
        // 4.保存
        User user = new User("Jack", new Date());
        session.save(user);
        // 5.提交事务
        transaction.commit();
        // 6.关闭session对象
        session.close();
        // 7.关闭sessionfactory对象
        sessionFactory.close();
    }
}

    上面这段代码中configuration对象用来保存则hibernate的配置信息，如hibernate.cfg.xml中的配置信息，和*.hbm.xml的映射信息。

    sessionfactory为建立session的工厂，它是线程安全的。通常建议一个项目中只有一个sessionfactory，由于建立sessionfactory很是费资源。

    接下来是session对象，该对象是hibernate的核心，是一个单线程的对象，内部有session缓存。

    对须要持久化的java对象的全部操做都用到了session。

    经常使用的方法有get、load、save、update、saveorupdate、delete、begintransaction、isopen、flush、clear、evicto、close等等方法，接下来将会一个一个研究这些方法的使用。

    这是执行这段代码后，控制台输出的内容：

    建立了一张名为S_USER的数据表，并insert了一条数据。

    到此位置，一个简单的hibernate环境就搭建好了。工程的目录结构以下：