Hibernate JPA 配置

最新推荐文章于 2024-08-09 18:28:03 发布

dream8062

最新推荐文章于 2024-08-09 18:28:03 发布

阅读量8.3k

点赞数

分类专栏： java 文章标签： hibernate jpa jdbc annotations sql class

本文链接：https://blog.csdn.net/dream8062/article/details/5943569

版权

java 专栏收录该内容

99 篇文章 1 订阅

订阅专栏

第14章 JPA实现框架

本章将讲述与JPA实现框架相关的知识，主要包括常用的开源JPA实现框架Hibernate 、OpenJPA 和Toplink。JPA作为Java EE的规范，它只是提供了一种标准的API。程序员若要使用JPA，仍需要选择JPA的实现框架。通过本章的学习，读者将能够了解与不同的JPA实现框架相关的知识，以便在实际的项目中做出合适的选择。

14.1 Hibernate JPA

Hibernate是最流行的ORM框架之一，也是最早实现JPA的规范框架之一。它被JBoss收购后，目前作为JBoss的一个开源框架，它遵循LGPL v2.1开源许可协议，官方主页是http://www.hibernate.org/。

14.1.1 Hibernate 与JPA

Hibernate 3.2以及以后的版本开始支持JPA，如图14-1所示为Hibernate框架包含的所有子项目。其中，涉及JPA的子项目有三个，它们分别是：

— Hibernate Core：Hibernate框架的核心实现。

— Hibernate Annotations：支持JDK 5.0的注释。

— Hibernate EntityManager：支持JPA的实现。

图14-1 Hibernate框架

14.1.2 Hibernate下载

如果使用JBoss应用服务器，由于JBoss中已经集成了Hibernate，所以不需要额外下载Hibernate类包。若在其他的环境中使用Hibernate实现，则需要下载其使用的类包。

目前最新版本为Hibernate Core 3.2.5.GA、Hibernate Annotations 3.3.0 GA和Hibernate EntityManager 3.3.1 GA。使用浏览器打开http://hibernate.org/30.html，进入到Hibernate的下载页面，如图14-2所示。

分别下载后找到hibernate3.jar、 hibernate-entitymanager.jar和hibernate-annotations.jar三个JAR包文件，这三个JAR包文件是 Hibernate 实现JPA所必需的类包。运行时还要导入运行Hibernate所依赖的第三方类库，请参阅Hibernate官方手册。

若下载了旧版本的Hibernate Core，要注意下载兼容的Hibernate EntityManager版本和Hibernate Annotations版本。如图14-3所示为Hibernate各个模块不同版本的兼容性。

图14-2 Hibernate下载页面

图14-3 Hibernate不同版本的兼容性比较

14.1.3 配置方式

Hibernate JPA自定义配置可以通过多种方式进行配置，如下面列举的几种方法。

方法一：在 persistence.xml文件中配置，如下所示。

<persistence-unit name="jpaUnit" transaction-type="RESOURCE_LOCAL">

<provider>org.hibernate.ejb.HibernatePersistence</provider>

<property name="hibernate.connection.driver_class"

value="com.mysql.jdbc.Driver" />

<property name="hibernate.connection.url"

value="jdbc:mysql://localhost:3306/jpademo" />

</properties>

</persistence-unit>

</persistence>

其中，“hibernate.show_sql ”为可配置的属性，Hibernate JPA还提供很多不同属性的配置。

— 方法二：通过代码，在创建EntityManagerFactory时指定，如下所示。

Map configOverrides = new HashMap();

configOverrides.put("hibernate.format_sql ", true);

EntityManagerFactory programmaticEmf =

Persistence.createEntityManagerFactory("jpaUnit", configOverrides);

当同时使用方法一和方法二设置时，方法二的方式为有效的配置。

— 方法三：使用Hibernate 专有的配置文件来配置，但首先要在persistence.xml文件中配置“hibernate.ejb.cfgfile”指定配置文件的位置，如下所示。

<persistence-unit name="jpaUnit" transaction-type="RESOURCE_LOCAL">

<provider>org.hibernate.ejb.HibernatePersistence</provider>

<property name="hibernate.connection.driver_class"

value="com.mysql.jdbc.Driver" />

<property name="hibernate.connection.url"

value="jdbc:mysql://localhost:3306/jpademo" />

<!—可选，配置Hibernate配置文件-->

< property name="hibernate.ejb.cfgfile"

value="/com/fengmanfei/jpa/hibernate.cfg.xml"/ >

</properties>

</persistence-unit>

</persistence>

其中，“/com /fengmanfei/jpa/hibernate.cfg.xml”为Hibernate配置文件的保存位置。使用这种方式，适用于将现有 Hibernate应用移植到JPA应用中来。但要注意，方法三的优先级最低，如果与方法一和方法二冲突，则方法一或方法二中的配置有效。

14.1.4 基本配置

方法一和方法二是JPA的标准配置，方法三是 Hibernate特有的配置。并不是所有的属性都可以通过这三种方式配置，其中一些属性必须通过方法一和方法二来配置，这些属性的详细说明如下所示。

— 属性名：hibernate.ejb.classcache.<classname>

描述：指定缓存实体对象，<classname>为缓存类的全名，值为缓存类型，以逗号分隔。

示例如下：

<property name="hibernate.ejb.classcache. com.fengmanfei.jpa.entity.Customer"

value="read-write"/>

— 属性名：hibernate.ejb.collectioncache.<collectionrole>

描述：指定集合实体类缓存，设置同上。<collectionrole>为集合类的全名，值为缓存类型，以逗号分隔。

示例如下：

<property name="hibernate.ejb.collectioncache.com.fengmanfei.jpa.entity.Customer. orders"

value="read-write , RegionName "/>

★ 提示 ★

读者若想了解更多的缓存设置，请参阅JBoss Cache的相关文档。

— 属性名：hibernate.ejb.cfgfile

描述：指定使用Hibernate配置文件中的配置。

示例如下：

< property name="hibernate.ejb.cfgfile" value="/com/fengmanfei/jpa/hibernate.cfg.xml"/ >

— 属性名：hibernate.archieve.autodetection

描述：创建Entity Manager时搜索文件的类型，多个值之间用逗号分隔。

可选值：

— class：.class类文件。

— hbm：Hibernate 配置文件。

默认两个都搜索。

示例如下：

— 属性名：hibernate.ejb.interceptor

描述：自定义拦截器类名，拦截器必须实现了 org.hibernate.Interceptor接口，并且有无参的构造方法。

示例如下：

<property name=" hibernate.ejb.interceptor "

value="com.fengmanfei.jpa.interceptor.MyInterceptor"/>

— 属性名：hibernate.ejb.naming_strategy

描述：设置注释命名策略。

可选值：

— EJB3NamingStrategy（默认）：EJB3规范的命名实现。

— DefaultComponentSafeNamingStrategy：在默认的EJB3NamingStrategy上进行了扩展，允许在同一实体中使用两个同类型的嵌入对象而无须额外的声明。

示例如下：

<property name=" hibernate.ejb.naming_strategy "

value=" DefaultComponentSafeNamingStrategy "/>

— 属性名：hibernate.ejb.event.<eventtype>

描述：配置事件监听器，其中<eventtype>为监听的事件类型，事件类型如表14-1中列举所示。而值则为具体监听器类的全名，如果有多个则使用逗号分隔。自定义拦截器类，拦截器必须实现了org.hibernate.Interceptor接口，并且有无参的构造方法，在JPA的环境中，尽量继承表14-1中的时间监听器类。

表14-1 可选的监听事件类型

^{事件类型}	^{监听器类}
^flush	^{org.hibernate.ejb.event.EJB3FlushEventListener}
^auto-flush	^{org.hibernate.ejb.event.EJB3AutoFlushEventListener}
^delete	^{org.hibernate.ejb.event.EJB3DeleteEventListener}
^flush-entity	^{org.hibernate.ejb.event.EJB3FlushEntityEventListener}
^merge	^{org.hibernate.ejb.event.EJB3MergeEventListener}
^create	^{org.hibernate.ejb.event.EJB3PersistEventListener}
^{create-onflush}	^{org.hibernate.ejb.event.EJB3PersistOnFlushEventListener}
^save	^{org.hibernate.ejb.event.EJB3SaveEventListener}
^save-update	^{org.hibernate.ejb.event.EJB3SaveOrUpdateEventListener}

续表

^{事件类型}	^监听器类
^pre-insert	^{org.hibernate.secure.JACCPreInsertEventListener,org.hibernate.valitator.event.ValidateEventListener}
^pre-update	^{org.hibernate.secure.JACCPreUpdateEventListener,org.hibernate.valitator.event.ValidateEventListener}
^pre-delete	^{org.hibernate.secure.JACCPreDeleteEventListener}
^pre-load	^{org.hibernate.secure.JACCPreLoadEventListener}
^post-delete	^{org.hibernate.ejb.event.EJB3PostDeleteEventListener}
^post-insert	^{org.hibernate.ejb.event.EJB3PostInsertEventListener}
^post-load	^{org.hibernate.ejb.event.EJB3PostLoadEventListener}
^post-update	^{org.hibernate.ejb.event.EJB3PostUpdateEventListener}

示例如下：

其中，CreateListener继承org.hibernate.ejb.event.EJB3PersistEventListener类，代码如下所示。

package com.fengmanfei.listener;

import org.hibernate.HibernateException;

import org.hibernate.ejb.event.EJB3PersistEventListener;

import org.hibernate.event.PersistEvent;

public class CreateListener extends EJB3PersistEventListener {

// 覆盖父类中的方法

@Override

public void onPersist(PersistEvent event) throws HibernateException {

super.onPersist(event);

//代码处理

}

— 属性名：hibernate.ejb.use_class_enhancer

描述：是否启用应用服务器扩展类。

可选值：

— true：启用扩展类。

— false（默认）：禁用扩展类。

示例如下：

— 属性名：hibernate.ejb.discard_pc_on_close

描述：是否在执行clear()时脱离持久化上下文。

可选值：

— true：执行clear()时脱离持久化上下文。

— false（默认）：执行clear()时不脱离持久化上下文。

示例如下：

14.1.5 配置日志

Hibernate使用Apache commons-logging来为各种事件记录日志。commons-logging将直接将日志输出到Apache Log4j（如果在类路径中包括log4j.jar）或 JDK1.4 logging （如果运行在JDK1.4或以上的环境下）。

如果使用Log4j，需要将 log4j.properties文件保存在类路径中。Hibernate根据对日志进行了详细的分类，以便能够控制日志的的输出信息，这些日志类别如表 14-2所示。

表14-2 Hibernate JPA实现日志类别

^{属性名}	^描 ^述
^{org.hibernate.SQL}	^记录 ^{SQL DML} ^语句
^{org.hibernate.type}	^记录 ^JDBC ^参数
^{org.hibernate.tool.hbm2ddl}	^记录 ^{SQL DDL} ^语句
^{org.hibernate.pretty}	^{记录提交实体时，相关联的} ²⁰ ^{个实体的状态}
^{org.hibernate.cache}	^{记录所有二级缓存}
^{org.hibernate.transaction}	^{记录事务相关的操作}
^{org.hibernate.jdbc}	^记录获取 ^JDBC ^{资源的操作}
^{org.hibernate.hql.ast.AST}	^记录 ^HQL ^和 ^{SQL AST} ^{的查询语句}
^{org.hibernate.secure}	^记录 ^JAAS ^认证请求
^{org.hibernate}	^{记录所有信息，建议在调试开发阶段设置}

例如，下面为 log4j.properties配置日志的示例代码。

### log4j基本配置 ###

log4j.appender.file=org.apache.log4j.FileAppender

log4j.appender.file.File=hibernate.log

log4j.appender.file.layout=org.apache.log4j.PatternLayout

log4j.appender.file.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n

### 设置日志级别###

log4j.rootLogger=info, stdout

###输出hibernate调试过程中的错误日志

log4j.logger.org.hibernate=debug

###输出HQL查询调试日志

log4j.logger.org.hibernate.hql.ast.AST=debug

### 输出SQL语句调试日志

log4j.logger.org.hibernate.SQL=debug

### 输出 JDBC参数查询的日志 ###

log4j.logger.org.hibernate.type=info

### 输出缓存日志 ###

log4j.logger.org.hibernate.cache=debug

### 输出事务日志###

log4j.logger.org.hibernate.transaction=debug

###输出获取JDBC资源日志###

log4j.logger.org.hibernate.jdbc=debug

14.1.6 配置缓存

Hibernate除了自动对Session级别的事务进行一级缓存外，二级缓存的优化是Hibernate实现的一个亮点之一，有关二级缓存的属性如下所示。

— 属性名：hibernate.cache.provider_class

描述：二级缓存实现的类全名，所使用的缓存都需要实现org.hibernate.cache. CacheProvider接口，Hibernate已经实现了一些缓存，开发人员可以直接配置使用，同时要启用二级缓存，配置 hibernate.cache.use_second_level_cache为true。

可选值：

org.hibernate.cache.HashtableCacheProvide、 org.hibernate.cache.EhCacheProvider、org.hibernate.

cache.OSCacheProvider、 org.hibernate.cache.SwarmCacheProvider和org.hibernate. cache.Tree CacheProvider等。

示例如下：

<property name=" hibernate.cache.provider_class "

value=" org.hibernate.cache.HashtableCacheProvide "/>

★ 提示 ★

有关各种缓存实现的详细区别，读者可以参阅Hiberante Core的相关文档。

— 属性名：hibernate.cache.use_minimal_puts

描述：是否优化二级缓存来最小化读写操作，集群时的缓存优化。

可选值：

— true（默认）：启用最小化读写操作。

— false：禁用最小化读写操作。

示例如下：

— 属性名：hibernate.cache.use_query_cache

描述：是否缓存查询结果。

可选值：

— true：缓存查询结果。

— false：不缓存查询结果。

示例如下：

— 属性名：hibernate.cache.use_second_level_cache

描述：是否启用二级缓存。

可选值：

— true：启用二级缓存。

— false：不使用二级缓存。

示例如下：

— 属性名：hibernate.cache.query_cache_factory

描述：设置自定义的查询缓存类全名，缓存类必须实现 org.hibernate.cache.QueryCache接口。

可选值：

— org.hibernate.cache.StandardQueryCache（默认）。

— 自定义缓存实现类。

示例如下：

<property name=" hibernate.cache.query_cache_factory "

value=" com.fengmanfei.cache.MyCache”/>

— 属性名：hibernate.cache.region_prefix

描述：二级缓存的前缀名称。

示例如下：

— 属性名：hibernate.cache.use_structured_entries

描述：是否使用结构化的方式缓存对象。

可选值：

— true：结构化方式缓存对象。

— false：不使用结构化的方式缓存对象。

示例如下：

14.1.7 配置JDBC和数据库

Hibernate自定义JDBC和数据库配置属性如下所示。

— 属性名：hibernate.jdbc.fetch_size

描述：JDBC抓取记录的大小，相当于设置 Statement.setFetchSize()，默认值为25。

示例如下：

— 属性名：hibernate.jdbc.batch_size

描述：JDBC2批量更新的大小，建议设置为 5～30之间的值，默认为5。

示例如下：

— 属性名：hibernate.jdbc.batch_versioned_data

描述：JDBC执行批量操作时，是否同时更新版本数据。

可选值：

— true（默认）：执行批量操作executeBatch()返回成功的记录数，并且更新版本数据。

— false：批量操作后不更新版本数据。

示例如下：

— 属性名：hibernate.jdbc.batch_versioned_data

描述：JDBC执行批量操作时，是否同时更新版本数据。

可选值：

— true（默认）：执行批量操作executeBatch()返回成功的记录数，并且更新版本数据。

— false：批量操作后不更新版本数据。

示例如下：

— 属性名：hibernate.jdbc.use_scrollable_resultset

描述：是否允许Hibernate使用JDBC2的可滚动结果集。

可选值：

— true（默认）：可使用可滚动结果集，只有在使用用户提供的JDBC连接时，才需要设置为启用。

— false：不可使用滚动结果集。

示例如下：

— 属性名：hibernate.jdbc.use_streams_for_binary

描述：是否JDBC以二进制方式读取。

可选值：

— true（默认）：以二进制方式读取。

— false：以二进制方式读取，而以序列化方式读取。

示例如下：

— 属性名：hibernate.jdbc.use_get_generated_keys

描述：是否使用JDBC3插入记录时使用 PreparedStatement.getGeneratedKeys()生成主键。

可选值：

— true：使用PreparedStatement.getGeneratedKeys()生成主键。

— false（默认）：使用Hibernate自定义的生成策略。

示例如下：

— 属性名：hibernate.connection.isolation

描述：JDBC事务隔离级别，请读者查阅 java.sql.Connection文档了解各个级别的类型，例如1、2、4（默认）、8。

示例如下：

— 属性名：hibernate.connection.autocommit

描述：是否使用JDBC自动提交。

可选值：

— true（默认）：自动提交。

— false：不自动提交。

示例如下：

— 属性名：hibernate.connection.driver_class

描述：数据连接的驱动类的全称，不同的数据库实现类不同。

示例如下：

— 属性名：hibernate.connection.url

描述：数据连接的URL。

示例如下：

— 属性名：hibernate.connection.username

描述：数据连接的用户名。

示例如下：

— 属性名：hibernate.connection.password

描述：数据连接的密码。

示例如下：

— 属性名：hibernate.dialect

描述：指定不同的数据库，Hibernate底层会根据不同的数据库生成的SQL进行优化，取值如表14-3所示。

表14-3 Hibernate JPA实现不同数据库相关配置的属性

^{属性名}	^描 ^述
^DB2	^{org.hibernate.dialect.DB2Dialect}
^{DB2 AS/400}	^{org.hibernate.dialect.DB2400Dialect}
^{DB2 OS390}	^{org.hibernate.dialect.DB2390Dialect}
^PostgreSQL	^{org.hibernate.dialect.PostgreSQLDialect}
^MySQL	^{org.hibernate.dialect.MySQLDialect}
^{MySQL InnoDB}	^{org.hibernate.dialect.MySQLInnoDBDialect}
^{MySQL with MyISAM}	^{org.hibernate.dialect.MySQLMyISAMDialect}
^Oracle	^{org.hibernate.dialect.OracleDialect}
^{Oracle 9i/10g}	^{org.hibernate.dialect.Oracle9Dialect}
^Sybase	^{org.hibernate.dialect.SybaseDialect}
^{Sybase Anywhere}	^{org.hibernate.dialect.SybaseAnywhereDialect}
^{Microsoft SQL Server}	^{org.hibernate.dialect.SQLServerDialect}
^{SAP DB}	^{org.hibernate.dialect.SAPDBDialect}
^Informix	^{org.hibernate.dialect.InformixDialect}
^{HypersonicSQL}	^{org.hibernate.dialect.HSQLDialect}

续表

^{属性名}	^描 ^述
^Ingres	^{org.hibernate.dialect.IngresDialect}
^Progress	^{org.hibernate.dialect.ProgressDialect}
^{Mckoi SQL}	^{org.hibernate.dialect.MckoiDialect}
^Interbase	^{org.hibernate.dialect.InterbaseDialect}
^Pointbase	^{org.hibernate.dialect.PointbaseDialect}