Hibernate之环境搭建及demo

ORM概念

ORM即Object/Relation Mapping, 对象/关系数据库映射。ORM是一种规范，完成面向对象编程语言到关系数据库之间的映射。J2EE中的JPA就是一种ORM规范。

ORM框架有很多，例如JPA, Hibernate，iBATIS等。

Hibernate简介

Hibernate是JBoss旗下，同时也是RetHat组织的产品（JBoss加入了RetHat），是目前非常流行的ORM框架。

Hibernate中的重要概念为PO(Persistent Object), Hibernate采用低入侵的设计，这里的PO完全是一个普通的java类（POJO)，其数据库操作功能完全由Hibernate实现，不需要POJO实现任何接口或者继承任何超类。

Hibernate环境搭建（Eclipse环境）

1.下载框架

• Hibernate框架，官网下载 http://www.hibernate.org/downloads 

目前最新版是5.2.2，为了兼容和稳定起见我下载的是4.3.11版，hibernate-release-4.3.11.Final.zip ，解压后看到主要目录如下，

-project ， 这个目录下放了很多demo project

-documentation 下面放了各种文档和教程，最重要的应该是Hibernate API, 即 javadocs

-lib 下面有很多二级目录，里面放了各种jar包，Hibernate是模块化的，其中required是Hibernate框架基础jar包，其他目录是一些扩展包，例如liboptionalc3p0下面放了数据库连接池的jar包。

• 另外，还需要下载日志框架包SLF4J，Hibernate会用它来在执行时候输出日志。

我下载的是1.6.1版本，可以在官网的数据仓库中找到  http://www.slf4j.org/dist/

2. 导入各种jar包

先在Eclipse中新建一个project，然后新建一个user library，例如叫做 hibernate-4-3-11，注意不要勾选system library，否则后面在读取Hibernate配置文件时候一直会报 java.lang.NullPointerException 异常。

导入以下jar包

-hibernate下的 lib equire下的所有jar包(10个)，这是框架基本jar包

-hibernate下的liboptionalc3p0的所有jar包，这是数据库连接池jar包，为Hibernate框架提供数据源

-slf4框架下的slf4j-api-1.6.1.jar (这是api） 和 slf4j-nop-1.6.1.jar （这是具体实现） 两个包

 我将所有jar包集中放在了一个目录里方便今后迁移，所有jar包如下，

将以上15个jar都添加进user library中去。

3.创建一个实体类

New类将要用来与数据库中的一张表对应，它只是一个普通类（POJO），我们放在src/hib路径下，后面Hibernate将会根据配置文件创建数据表

package hib;

public class News {
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getTitle() {
        return title;
    }
    public void setTitle(String title) {
        this.title = title;
    }
    public String getContent() {
        return content;
    }
    public void setContent(String content) {
        this.content = content;
    }
    private int id;
    private String title;
    private String content;
    
}

4.创建表映射文件

在News类相同的路径下创建一个xml文件News.hbm.xml，这个文件与News.java对应，叫做映射文件，是一个Hibernate将依据这个文件操作数据库。

通过某些插件，可以依据实体类News.java 自动创建News.hbm.xml，不过我还是先收工创建一下。

<?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 package="hib">
    <class name="News" table="news_table">
        <id name="id" column="id">
            <generator class="identity" />
        </id>
        <property name="title" type="string" column="title" />
        <property name="content" type="string" column="content" />
    </class>
</hibernate-mapping>

News.hbm.xml的语法在Hibernate提供的手册（hibernate-release-4.3.11.Final/documentation/manual/en-US/html_single/index.html）1.1.3. The mapping file 中已经有详细描述，

每一个持久化的实体类（例如上面的News.java)，都需要有一个到数据表的映射，这里的<class>元素就是一个映射

表的主键用<id>元素表示，其他字段则用<property>元素表示，每个字段元素中可以添加name, colume, type属性，分别表示字段名称和类型

5.创建Hibernate主配置文件

Hibernate配置文件的默认名称是Hibernate.cfg.xml，我们创建这个文件并放在src根目录，文件内容如下，

<?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="connection.driver_class">com.mysql.jdbc.Driver</property>
        <property name="connection.url">jdbc:mysql://127.0.0.1:3306/think_blog?useUnicode=true&amp;characterEncoding=UTF-8</property> <!-- 指定字符集的方式-->
        <property name="connection.username">root</property>
        <property name="connection.password"></property> 

        <property name="hibernate.c3p0.max_size">20</property>
        <property name="hibernate.c3p0.min_size">1</property>
    
        <property name="hibernate.c3p0.timeout">5000</property>
    
        <property name="hibernate.c3p0.max_statements">100</property>
        <property name="hibernate.c3p0.idle_test_period">3000</property>
        <property name="hibernate.c3p0.acquire_increment">2</property>
        <property name="hibernate.c3p0.validate">true</property>
        <property name="dialect">org.hibernate.dialect.MySQLDialect</property> <!--数据库方言-->
    　　<!--自动建表及打印sql -->
        <property name="hbm2ddl.auto">update</property>
        <property name="show_sql">true</property>
        <mapping resource="hib/News.hbm.xml" />
    </session-factory>
</hibernate-configuration>

 对上面的关键点解释如下：

• 数据库连接字符串：如果要指定字符集，在url后面加上?useUnicode=true&characterEncoding=UTF-8， 但因为url要放在xml文件中，需要将&符号转义成"&amp;"
• 我也使用使用<property name="connection.charset">utf8</property> 这种方式兼容中文，但是好像并不起作用
• 数据库方言：我使用的是MySQL数据库，最开始我使用的数据库方言配置是org.hibernate.dialect.MySQLInnoDBDialect，但是发现无法通过Hibernate自动建表，后来发现换成org.hibernate.dialect.MySQLDialect就行了。
• 所有数据库方言配置可以在手册中找到 ，hibernate-release-4.3.11.Final/documentation/manual/en-US/html_single/index.html#tutorial-firstapp-mapping 的 3.4.1. SQL Dialects
• 是否根据实体类和映射文件自动建表：<property name="hbm2ddl.auto">update</property>
• 打印SQL到控制台：<property name="show_sql">true</property>

6. 创建测试类

NewsManager也放在hib路径下，在这个类中初始化Hibernate执行数据库操作

package hib;

import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.hibernate.cfg.Configuration;

public class NewsManager {
    public static void main(String[] args) {
        //实例化Configuration
        //configure()方法默认加载  /hibernate.cfg.xml
        Configuration conf = new Configuration().configure();
        //用Configuration创建SessionFactory
        SessionFactory sf = conf.buildSessionFactory();
        //用SessionFactory打开Session
        Session sess = sf.openSession();
        //开始事务
        Transaction tx = sess.beginTransaction();
        //创建消息实例
        News n = new News();
        //设置消息标题和消息内容
        n.setTitle("天王盖地虎");
        n.setContent("宝塔镇河妖");
        //保存消息
        sess.save(n);
        //提交事务
        tx.commit();
        //关闭session 和 SessionFactory
        sess.close();
        sf.close();    
        System.out.println("执行完毕");
    }
}

注意上面的Configuration().configure()方法，是从默认的路径src下加载Hibernate配置文件Hibernate.cfg.xml。

启动mysql数据库（确保存在上面配置文件中的数据库名），再在Eclipse中执行NewsManager类结果如下，可以看到在末尾答应出了SQL语句，

Dec 23, 2016 2:57:38 PM org.hibernate.annotations.common.reflection.java.JavaReflectionManager <clinit>
INFO: HCANN000001: Hibernate Commons Annotations {4.0.5.Final}
Dec 23, 2016 2:57:38 PM org.hibernate.Version logVersion
INFO: HHH000412: Hibernate Core {4.3.11.Final}
Dec 23, 2016 2:57:38 PM org.hibernate.cfg.Environment <clinit>
INFO: HHH000206: hibernate.properties not found
Dec 23, 2016 2:57:38 PM org.hibernate.cfg.Environment buildBytecodeProvider
INFO: HHH000021: Bytecode provider name : javassist
Dec 23, 2016 2:57:38 PM org.hibernate.cfg.Configuration configure
INFO: HHH000043: Configuring from resource: /hibernate.cfg.xml
Dec 23, 2016 2:57:38 PM org.hibernate.cfg.Configuration getConfigurationInputStream
INFO: HHH000040: Configuration resource: /hibernate.cfg.xml
Dec 23, 2016 2:57:38 PM org.hibernate.internal.util.xml.DTDEntityResolver resolveEntity
WARN: HHH000223: Recognized obsolete hibernate namespace http://hibernate.sourceforge.net/. Use namespace http://www.hibernate.org/dtd/ instead. Refer to Hibernate 3.6 Migration Guide!
Dec 23, 2016 2:57:38 PM org.hibernate.cfg.Configuration addResource
INFO: HHH000221: Reading mappings from resource: hib/News.hbm.xml
Dec 23, 2016 2:57:39 PM org.hibernate.internal.util.xml.DTDEntityResolver resolveEntity
WARN: HHH000223: Recognized obsolete hibernate namespace http://hibernate.sourceforge.net/. Use namespace http://www.hibernate.org/dtd/ instead. Refer to Hibernate 3.6 Migration Guide!
Dec 23, 2016 2:57:39 PM org.hibernate.cfg.Configuration doConfigure
INFO: HHH000041: Configured SessionFactory: null
Dec 23, 2016 2:57:39 PM org.hibernate.c3p0.internal.C3P0ConnectionProvider configure
INFO: HHH010002: C3P0 using driver: com.mysql.jdbc.Driver at URL: jdbc:mysql://127.0.0.1:3306/think_blog?useUnicode=true&characterEncoding=UTF-8
Dec 23, 2016 2:57:39 PM org.hibernate.c3p0.internal.C3P0ConnectionProvider configure
INFO: HHH000046: Connection properties: {user=root, password=****}
Dec 23, 2016 2:57:39 PM org.hibernate.c3p0.internal.C3P0ConnectionProvider configure
INFO: HHH000006: Autocommit mode: false
Dec 23, 2016 2:57:39 PM com.mchange.v2.log.MLog <clinit>
INFO: MLog clients using java 1.4+ standard logging.
Dec 23, 2016 2:57:39 PM com.mchange.v2.c3p0.C3P0Registry banner
INFO: Initializing c3p0-0.9.2.1 [built 20-March-2013 10:47:27 +0000; debug? true; trace: 10]
Dec 23, 2016 2:57:39 PM com.mchange.v2.c3p0.impl.AbstractPoolBackedDataSource getPoolManager
INFO: Initializing c3p0 pool... com.mchange.v2.c3p0.PoolBackedDataSource@49eb2a4c [ connectionPoolDataSource -> com.mchange.v2.c3p0.WrapperConnectionPoolDataSource@92efcc58 [ acquireIncrement -> 2, acquireRetryAttempts -> 30, acquireRetryDelay -> 1000, autoCommitOnClose -> false, automaticTestTable -> null, breakAfterAcquireFailure -> false, checkoutTimeout -> 0, connectionCustomizerClassName -> null, connectionTesterClassName -> com.mchange.v2.c3p0.impl.DefaultConnectionTester, debugUnreturnedConnectionStackTraces -> false, factoryClassLocation -> null, forceIgnoreUnresolvedTransactions -> false, identityToken -> 1hgeby99lbs898r1pl3km1|187a62fa, idleConnectionTestPeriod -> 3000, initialPoolSize -> 1, maxAdministrativeTaskTime -> 0, maxConnectionAge -> 0, maxIdleTime -> 5000, maxIdleTimeExcessConnections -> 0, maxPoolSize -> 20, maxStatements -> 100, maxStatementsPerConnection -> 0, minPoolSize -> 1, nestedDataSource -> com.mchange.v2.c3p0.DriverManagerDataSource@e332f0e7 [ description -> null, driverClass -> null, factoryClassLocation -> null, identityToken -> 1hgeby99lbs898r1pl3km1|4a84466d, jdbcUrl -> jdbc:mysql://127.0.0.1:3306/think_blog?useUnicode=true&characterEncoding=UTF-8, properties -> {user=******, password=******} ], preferredTestQuery -> null, propertyCycle -> 0, statementCacheNumDeferredCloseThreads -> 0, testConnectionOnCheckin -> false, testConnectionOnCheckout -> false, unreturnedConnectionTimeout -> 0, usesTraditionalReflectiveProxies -> false; userOverrides: {} ], dataSourceName -> null, factoryClassLocation -> null, identityToken -> 1hgeby99lbs898r1pl3km1|2c6d9d9c, numHelperThreads -> 3 ]
Dec 23, 2016 2:57:40 PM org.hibernate.dialect.Dialect <init>
INFO: HHH000400: Using dialect: org.hibernate.dialect.MySQLDialect
Dec 23, 2016 2:57:40 PM org.hibernate.engine.jdbc.internal.LobCreatorBuilder useContextualLobCreation
INFO: HHH000424: Disabling contextual LOB creation as createClob() method threw error : java.lang.reflect.InvocationTargetException
Dec 23, 2016 2:57:40 PM org.hibernate.engine.transaction.internal.TransactionFactoryInitiator initiateService
INFO: HHH000399: Using default transaction strategy (direct JDBC transactions)
Dec 23, 2016 2:57:40 PM org.hibernate.hql.internal.ast.ASTQueryTranslatorFactory <init>
INFO: HHH000397: Using ASTQueryTranslatorFactory
Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.SchemaUpdate execute
INFO: HHH000228: Running hbm2ddl schema update
Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.SchemaUpdate execute
INFO: HHH000102: Fetching database metadata
Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.SchemaUpdate execute
INFO: HHH000396: Updating schema
Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.DatabaseMetadata getTableMetadata
INFO: HHH000262: Table not found: news_table
Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.DatabaseMetadata getTableMetadata
INFO: HHH000262: Table not found: news_table
Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.DatabaseMetadata getTableMetadata
INFO: HHH000262: Table not found: news_table
Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.SchemaUpdate execute
INFO: HHH000232: Schema update complete
Hibernate: insert into news_table (title, content) values (?, ?)
执行完毕

同时我们查看mysql数据库，发现在think_blog库下多了一张表News_table，同时在表中我们插入了一条数据，

到此，我们的Hibernate环境就算是配置成功了，并且成功执行了一个基本的demo。

从测试类中可以总结Hibernate的一般步骤，

• -加载Hibernate配置文件(Hibernate.cfg.xml，默认从src目录加载)，从而获得Hibernate的Configuration实例
• -通过Configuration的实例创建Session工厂
• -通过Session工厂打开一个session
• -通过session开起一个事务
• -进行实体类的set或者get操作
• -将实体类的操作结果保存进session
• -提交事务
• -关闭session及session工厂资源

以上步骤完全是面向对象的编程方式，不直接操作数据库，但是通过Hibernate完成了数据库操作，这便是Hibernate的基本原理。