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将会根据配置文件创建数据表
1 package hib; 2 3 public class News { 4 public int getId() { 5 return id; 6 } 7 public void setId(int id) { 8 this.id = id; 9 } 10 public String getTitle() { 11 return title; 12 } 13 public void setTitle(String title) { 14 this.title = title; 15 } 16 public String getContent() { 17 return content; 18 } 19 public void setContent(String content) { 20 this.content = content; 21 } 22 private int id; 23 private String title; 24 private String content; 25 26 }
4.创建表映射文件
在News类相同的路径下创建一个xml文件News.hbm.xml,这个文件与News.java对应,叫做映射文件,是一个Hibernate将依据这个文件操作数据库。
通过某些插件,可以依据实体类News.java 自动创建News.hbm.xml,不过我还是先收工创建一下。
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" 3 "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> 4 5 <hibernate-mapping package="hib"> 6 <class name="News" table="news_table"> 7 <id name="id" column="id"> 8 <generator class="identity" /> 9 </id> 10 <property name="title" type="string" column="title" /> 11 <property name="content" type="string" column="content" /> 12 </class> 13 </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根目录,文件内容如下,
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN" 3 "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> 4 5 <hibernate-configuration> 6 <session-factory> 7 8 <property name="connection.driver_class">com.mysql.jdbc.Driver</property> 9 <property name="connection.url">jdbc:mysql://127.0.0.1:3306/think_blog?useUnicode=true&characterEncoding=UTF-8</property> <!-- 指定字符集的方式--> 10 <property name="connection.username">root</property> 11 <property name="connection.password"></property> 12 13 <property name="hibernate.c3p0.max_size">20</property> 14 <property name="hibernate.c3p0.min_size">1</property> 15 16 <property name="hibernate.c3p0.timeout">5000</property> 17 18 <property name="hibernate.c3p0.max_statements">100</property> 19 <property name="hibernate.c3p0.idle_test_period">3000</property> 20 <property name="hibernate.c3p0.acquire_increment">2</property> 21 <property name="hibernate.c3p0.validate">true</property> 22 <property name="dialect">org.hibernate.dialect.MySQLDialect</property> <!--数据库方言--> 23 <!--自动建表及打印sql --> 24 <property name="hbm2ddl.auto">update</property> 25 <property name="show_sql">true</property> 26 <mapping resource="hib/News.hbm.xml" /> 27 </session-factory> 28 </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执行数据库操作
1 package hib; 2 3 import org.hibernate.Session; 4 import org.hibernate.SessionFactory; 5 import org.hibernate.Transaction; 6 import org.hibernate.cfg.Configuration; 7 8 public class NewsManager { 9 public static void main(String[] args) { 10 //实例化Configuration 11 //configure()方法默认加载 /hibernate.cfg.xml 12 Configuration conf = new Configuration().configure(); 13 //用Configuration创建SessionFactory 14 SessionFactory sf = conf.buildSessionFactory(); 15 //用SessionFactory打开Session 16 Session sess = sf.openSession(); 17 //开始事务 18 Transaction tx = sess.beginTransaction(); 19 //创建消息实例 20 News n = new News(); 21 //设置消息标题和消息内容 22 n.setTitle("天王盖地虎"); 23 n.setContent("宝塔镇河妖"); 24 //保存消息 25 sess.save(n); 26 //提交事务 27 tx.commit(); 28 //关闭session 和 SessionFactory 29 sess.close(); 30 sf.close(); 31 System.out.println("执行完毕"); 32 } 33 }
注意上面的Configuration().configure()方法,是从默认的路径src下加载Hibernate配置文件Hibernate.cfg.xml。
启动mysql数据库(确保存在上面配置文件中的数据库名),再在Eclipse中执行NewsManager类结果如下,可以看到在末尾答应出了SQL语句,
1 Dec 23, 2016 2:57:38 PM org.hibernate.annotations.common.reflection.java.JavaReflectionManager <clinit> 2 INFO: HCANN000001: Hibernate Commons Annotations {4.0.5.Final} 3 Dec 23, 2016 2:57:38 PM org.hibernate.Version logVersion 4 INFO: HHH000412: Hibernate Core {4.3.11.Final} 5 Dec 23, 2016 2:57:38 PM org.hibernate.cfg.Environment <clinit> 6 INFO: HHH000206: hibernate.properties not found 7 Dec 23, 2016 2:57:38 PM org.hibernate.cfg.Environment buildBytecodeProvider 8 INFO: HHH000021: Bytecode provider name : javassist 9 Dec 23, 2016 2:57:38 PM org.hibernate.cfg.Configuration configure 10 INFO: HHH000043: Configuring from resource: /hibernate.cfg.xml 11 Dec 23, 2016 2:57:38 PM org.hibernate.cfg.Configuration getConfigurationInputStream 12 INFO: HHH000040: Configuration resource: /hibernate.cfg.xml 13 Dec 23, 2016 2:57:38 PM org.hibernate.internal.util.xml.DTDEntityResolver resolveEntity 14 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! 15 Dec 23, 2016 2:57:38 PM org.hibernate.cfg.Configuration addResource 16 INFO: HHH000221: Reading mappings from resource: hib/News.hbm.xml 17 Dec 23, 2016 2:57:39 PM org.hibernate.internal.util.xml.DTDEntityResolver resolveEntity 18 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! 19 Dec 23, 2016 2:57:39 PM org.hibernate.cfg.Configuration doConfigure 20 INFO: HHH000041: Configured SessionFactory: null 21 Dec 23, 2016 2:57:39 PM org.hibernate.c3p0.internal.C3P0ConnectionProvider configure 22 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 23 Dec 23, 2016 2:57:39 PM org.hibernate.c3p0.internal.C3P0ConnectionProvider configure 24 INFO: HHH000046: Connection properties: {user=root, password=****} 25 Dec 23, 2016 2:57:39 PM org.hibernate.c3p0.internal.C3P0ConnectionProvider configure 26 INFO: HHH000006: Autocommit mode: false 27 Dec 23, 2016 2:57:39 PM com.mchange.v2.log.MLog <clinit> 28 INFO: MLog clients using java 1.4+ standard logging. 29 Dec 23, 2016 2:57:39 PM com.mchange.v2.c3p0.C3P0Registry banner 30 INFO: Initializing c3p0-0.9.2.1 [built 20-March-2013 10:47:27 +0000; debug? true; trace: 10] 31 Dec 23, 2016 2:57:39 PM com.mchange.v2.c3p0.impl.AbstractPoolBackedDataSource getPoolManager 32 INFO: Initializing c3p0 pool... [email protected] [ connectionPoolDataSource -> [email protected] [ 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 -> [email protected] [ 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 ] 33 Dec 23, 2016 2:57:40 PM org.hibernate.dialect.Dialect <init> 34 INFO: HHH000400: Using dialect: org.hibernate.dialect.MySQLDialect 35 Dec 23, 2016 2:57:40 PM org.hibernate.engine.jdbc.internal.LobCreatorBuilder useContextualLobCreation 36 INFO: HHH000424: Disabling contextual LOB creation as createClob() method threw error : java.lang.reflect.InvocationTargetException 37 Dec 23, 2016 2:57:40 PM org.hibernate.engine.transaction.internal.TransactionFactoryInitiator initiateService 38 INFO: HHH000399: Using default transaction strategy (direct JDBC transactions) 39 Dec 23, 2016 2:57:40 PM org.hibernate.hql.internal.ast.ASTQueryTranslatorFactory <init> 40 INFO: HHH000397: Using ASTQueryTranslatorFactory 41 Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.SchemaUpdate execute 42 INFO: HHH000228: Running hbm2ddl schema update 43 Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.SchemaUpdate execute 44 INFO: HHH000102: Fetching database metadata 45 Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.SchemaUpdate execute 46 INFO: HHH000396: Updating schema 47 Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.DatabaseMetadata getTableMetadata 48 INFO: HHH000262: Table not found: news_table 49 Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.DatabaseMetadata getTableMetadata 50 INFO: HHH000262: Table not found: news_table 51 Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.DatabaseMetadata getTableMetadata 52 INFO: HHH000262: Table not found: news_table 53 Dec 23, 2016 2:57:40 PM org.hibernate.tool.hbm2ddl.SchemaUpdate execute 54 INFO: HHH000232: Schema update complete 55 Hibernate: insert into news_table (title, content) values (?, ?) 56 执行完毕
同时我们查看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的基本原理。