|
OpenJPA最值得关注的特性就是它贯穿了插件(Plugin)的思想,这使得OpenJPA的扩展性更强。对于日志的配置,OpenJPA不仅有其自己的实现,也有Log4J、Apache Commons Logging和自定义的日志处理。
OpenJPA中配置日志的属性如下所示。
(1)属性名:openjpa.Log
描述:配置日志属性,对应配置的API为org.apache.openjpa.conf.OpenJPAConfiguration. getLog。
可选值:
— openjpa:OpenJPA默认的日志实现。
— commons:Apache Commons Logging日志实现。
— log4j:Log4J的日志实现。
— none:禁用日志。
示例:禁用日志
(2)日志类别
同Hibernate的日志处理相似,OpenJPA也将日志的信息进行了分类,这些类别如表14-4所示。
表14-4 OpenJPA实现日志类别
|
| openjpa.Tool
| 由OpenJPA命令行工具、Ant工具输出的信息
| openjpa.Enhance
| 由OpenJPA的强化机制,在转换类时输出的信息
| openjpa.MetaData
| 生成OR映射时输出的信息
| openjpa.Runtime
| 运行时输出的信息
| openjpa.Query:
| 执行查询时输出的信息
| openjpa.DataCache
| 使用缓存时输出的信息
| openjpa.jdbc.JDBC
| JDBC连接数据库时的信息
| openjpa.jdbc.SQL
| 输出的SQL信息
|
示例:打印SQL日志
其中,TRACE为日志的级别,OpenJPA的日志级别从低到高分别是TRACE、INFO(默认)、WARN、ERROR和FATAL。
如果要打印出格式化后的SQL,可以对属性“openjpa.ConnectionFactoryProperties”进行配置,代码如下:
其中,PrettyPrint=true表示格式化输出SQL,PrettyPrintLineLength=72表示默认的一行为72个字符长度。
(3)openjpa.Log的值可以由以下4部分组成,配置的每个部分用逗号分隔。
— File:可以指定日志保存的文件。
— DefaultLevel:日志默认的级别。
— DiagnosticContext:在所输出的日志前增加诊断信息。
— :日志类别,如表14-4所示。
示例一:标准的日志配置
示例二:标准的日志配置和所有的SQL日志
示例三:标准的日志配置同时保存到指定文件中
(4)配置Log4J
当日志使用Log4J时,需要在log4j.properties中配置日志,例如log4j.properties的配置如下所示。
log4j.rootCategory=WARN, console
log4j.category.openjpa.Tool=INFO
log4j.category.openjpa.Runtime=INFO
log4j.category.openjpa.Remote=WARN
log4j.category.openjpa.DataCache=WARN
log4j.category.openjpa.MetaData=WARN
log4j.category.openjpa.Enhance=WARN
log4j.category.openjpa.Query=WARN
log4j.category.openjpa.jdbc.SQL=WARN
log4j.category.openjpa.jdbc.JDBC=WARN
log4j.category.openjpa.jdbc.Schema=WARN
log4j.appender.console=org.apache.log4j.ConsoleAppender
| OpenJPA可以采用多种方式配置缓存,不仅支持多个虚拟机(Multi-JVM)缓存。常用的缓存配置属性如下所示。
— 属性名:openjpa.DataCache
描述:是否缓存数据,对应配置的API为org.apache.openjpa.conf.OpenJPAConfiguration. getDataCache。
可选值:
— true:启用缓存。
— false(默认):不使用缓存。
示例一:启用缓存
示例二:启用缓存,并且设置缓存的容量为5000,并且禁用软引用容量
— 属性名:openjpa.QueryCache
描述:是否缓存查询结果,对应配置的API为org.apache.openjpa.conf.OpenJPAConfiguration. getQueryCache。
可选值:
— true(默认):启用查询结果缓存,同时openjpa.DataCache设置为true。
— false:禁用启用查询结果缓存。
示例一:启用查询结果缓存,缓存的容量为1000,并且软引用的容量为100
示例二:禁用查询结果缓存
— 属性名:openjpa.QueryCompilationCache
描述:缓存的数据存储类型。
可选值:
— true(默认):将使用org.apache.openjpa.util.CacheMap缓存数据。CacheMap缓存固定容量和一些软引用的数据,这种方式能够保证缓存的容量在一定的范围内。
— all:将使用org.apache.openjpa.lib.util.ConcurrentHashMap缓存数据。缓存效率高,但数据永远不会自动清空,如果频繁地动态查询,将会占用大量的内存。但如果只是涉及参数查询,则可以选中该方式。
— false:禁用缓存。
示例:启用查询结果缓存,缓存的容量为1000,并且软引用的容量为100
14.2.5 配置JDBC和数据库
— 属性名:openjpa.ConnectionDriverName
描述:数据连接的驱动类的全称,不同的数据库实现类不同。
示例如下:
— 属性名:openjpa.ConnectionURL
描述:数据连接的URL。
示例如下:
— 属性名:openjpa.ConnectionUserName
描述:数据连接的用户名。
示例如下:
— 属性名:openjpa.ConnectionPassword
描述:数据连接的密码。
示例如下:
— 属性名:openjpa.ConnectionProperties
描述:数据库连接的属性,相当于JDBC连接数据库时Driver.connect(String url, Properties props)方法中的属性设置。
— 属性名:openjpa.ConnectionFactoryProperties
描述:配置数据库连接工厂时的属性。
可选值:
— QueryTimeout:JDBC驱动执行查询超时的时间,以秒为单位。
— PrettyPrint:是否格式化输出SQL语句。
— PrettyPrintLineLength:SQL每行输出的最大长度。
示例如下:
— 属性名:openjpa.jdbc.DBDictionary
描述:配置数据库类型,默认情况下OpenJPA会自动根据驱动器匹配对应的数据库类型。
可选值:
access、db2、derby、empress、foxpro、hsql、informix、jdatastore、mysql、oracle、pointbase、postgres、sqlserver和sybase等。
示例如下:
— 属性名:openjpa.FetchBatchSize
描述:查询结果一次转化为对象的最多个数,相当于JDBC的结果集对象Statement.set FetchSize。默认为-1,表示所有的查询对象立即初始化;0表示使用JDBC驱动默认的数值。
示例如下:
— 属性名:openjpa.jdbc.ResultSetType
描述:执行查询时返回的查询结果集类型,相当于设置java.sql.ResultSet中的返回类型。
可选值:
— forward-only(默认):仅向前型。
— scroll-sensitive:滚动敏感型。
— scroll-insensitive:滚动不敏感型。
示例如下:
— 属性名:openjpa.jdbc.FetchDirection
描述:访问查询结果时的顺序。
可选值:
— forward(默认):向前型。
— reverse:倒转型。
— unknown:未知型。
示例如下:
— 属性名:openjpa.jdbc.LRSSize
描述:由OpenJPA决定查询结果的大小,但此时需配置openjpa.FetchBatchSize属性为-1。
可选值:
— query(默认):根据SELECT COUNT(*)查询结果的数值设置。
— last:通过游标移动到查询结果的最后一行ResultSet.last来设置数值。
— unknown:每个查询的设置值为Integer.MAX_VALUE。
示例如下:
|
|
|
|
|
|
|