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包，其他目录是一些扩展包，例如lib\optional\c3p0下面放了数据库连接池的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\require下的所有jar包(10个)，这是框架基本jar包

-hibernate下的lib\optional\c3p0的所有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文件中，需要将&符号转义成"&"
我也使用使用<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的基本原理。