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:禁用日志。 示例:禁用日志 <property name=" openjpa.Log " value="none "/> (2)日志类别 同Hibernate的日志处理相似,OpenJPA也将日志的信息进行了分类,这些类别如表14-4所示。 表14-4 OpenJPA实现日志类别
示例:打印SQL日志 <property name="openjpa.Log" value="SQL=TRACE"/> 其中,TRACE为日志的级别,OpenJPA的日志级别从低到高分别是TRACE、INFO(默认)、WARN、ERROR和FATAL。 如果要打印出格式化后的SQL,可以对属性“openjpa.ConnectionFactoryProperties”进行配置,代码如下: <property name="openjpa.Log" value="SQL=TRACE"/> <property name="openjpa.ConnectionFactoryProperties" value="PrettyPrint=true, PrettyPrintLineLength=72"/> 其中,PrettyPrint=true表示格式化输出SQL,PrettyPrintLineLength=72表示默认的一行为72个字符长度。 (3)openjpa.Log的值可以由以下4部分组成,配置的每个部分用逗号分隔。 — File:可以指定日志保存的文件。 — DefaultLevel:日志默认的级别。 — DiagnosticContext:在所输出的日志前增加诊断信息。 — <channel>:日志类别,如表14-4所示。 示例一:标准的日志配置 <property name="openjpa.Log" value="DefaultLevel=WARN, Runtime=INFO, Tool=INFO"/> 示例二:标准的日志配置和所有的SQL日志 <property name="openjpa.Log" value="DefaultLevel=WARN, Runtime=INFO, Tool=INFO, SQL=TRACE"/> 示例三:标准的日志配置同时保存到指定文件中 <property name="openjpa.Log" value="File=/tmp/org.apache.openjpa.log,DefaultLevel=WARN,Runtime=INFO, Tool=INFO"/> (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(默认):不使用缓存。
示例一:启用缓存
<property name="openjpa.DataCache" value="true"/>
示例二:启用缓存,并且设置缓存的容量为5000,并且禁用软引用容量
<property name="openjpa.DataCache" value="true(CacheSize=5000, SoftReferenceSize=0)"/>
— 属性名:openjpa.QueryCache
描述:是否缓存查询结果,对应配置的API为org.apache.openjpa.conf.OpenJPAConfiguration. getQueryCache。
可选值:
— true(默认):启用查询结果缓存,同时openjpa.DataCache设置为true。
— false:禁用启用查询结果缓存。
示例一:启用查询结果缓存,缓存的容量为1000,并且软引用的容量为100
<property name="openjpa.QueryCache" value="CacheSize=1000, SoftReferenceSize=100"/>
示例二:禁用查询结果缓存
<property name="openjpa.QueryCache" value=" false"/>
— 属性名:openjpa.QueryCompilationCache
描述:缓存的数据存储类型。
可选值:
— true(默认):将使用org.apache.openjpa.util.CacheMap缓存数据。CacheMap缓存固定容量和一些软引用的数据,这种方式能够保证缓存的容量在一定的范围内。
— all:将使用org.apache.openjpa.lib.util.ConcurrentHashMap缓存数据。缓存效率高,但数据永远不会自动清空,如果频繁地动态查询,将会占用大量的内存。但如果只是涉及参数查询,则可以选中该方式。
— false:禁用缓存。
示例:启用查询结果缓存,缓存的容量为1000,并且软引用的容量为100
<property name=" openjpa.QueryCompilationCache " value="true "/>
— 属性名:openjpa.ConnectionDriverName
描述:数据连接的驱动类的全称,不同的数据库实现类不同。
示例如下:
<property name=" openjpa.ConnectionDriverName " value=" com.mysql.jdbc.Driver "/>
— 属性名:openjpa.ConnectionURL
描述:数据连接的URL。
示例如下:
<property name="openjpa.ConnectionURL" value=" jdbc:mysql://localhost:3306/jpademo"/>
— 属性名:openjpa.ConnectionUserName
描述:数据连接的用户名。
示例如下:
<property name="openjpa.ConnectionUserName" value="root"/>
— 属性名:openjpa.ConnectionPassword
描述:数据连接的密码。
示例如下:
<property name="openjpa.ConnectionPassword" value="123"/>
— 属性名:openjpa.ConnectionProperties
描述:数据库连接的属性,相当于JDBC连接数据库时Driver.connect(String url, Properties props)方法中的属性设置。
— 属性名:openjpa.ConnectionFactoryProperties
描述:配置数据库连接工厂时的属性。
可选值:
— QueryTimeout:JDBC驱动执行查询超时的时间,以秒为单位。
— PrettyPrint:是否格式化输出SQL语句。
— PrettyPrintLineLength:SQL每行输出的最大长度。
示例如下:
<property name="openjpa.ConnectionFactoryProperties"
value="PrettyPrint=true, PrettyPrintLineLength=80"/>
— 属性名:openjpa.jdbc.DBDictionary
描述:配置数据库类型,默认情况下OpenJPA会自动根据驱动器匹配对应的数据库类型。
可选值:
access、db2、derby、empress、foxpro、hsql、informix、jdatastore、mysql、oracle、pointbase、postgres、sqlserver和sybase等。
示例如下:
<property name="openjpa.jdbc.DBDictionary" value=" mysql "/>
— 属性名:openjpa.FetchBatchSize
描述:查询结果一次转化为对象的最多个数,相当于JDBC的结果集对象Statement.set FetchSize。默认为-1,表示所有的查询对象立即初始化;0表示使用JDBC驱动默认的数值。
示例如下:
<property name="openjpa.FetchBatchSize" value="20"/>
— 属性名:openjpa.jdbc.ResultSetType
描述:执行查询时返回的查询结果集类型,相当于设置java.sql.ResultSet中的返回类型。
可选值:
— forward-only(默认):仅向前型。
— scroll-sensitive:滚动敏感型。
— scroll-insensitive:滚动不敏感型。
示例如下:
<property name="openjpa.jdbc.ResultSetType" value="scroll-insensitive"/>
— 属性名:openjpa.jdbc.FetchDirection
描述:访问查询结果时的顺序。
可选值:
— forward(默认):向前型。
— reverse:倒转型。
— unknown:未知型。
示例如下:
<property name="openjpa.jdbc.FetchDirection" value="reverse"/>
— 属性名:openjpa.jdbc.LRSSize
描述:由OpenJPA决定查询结果的大小,但此时需配置openjpa.FetchBatchSize属性为-1。
可选值:
— query(默认):根据SELECT COUNT(*)查询结果的数值设置。
— last:通过游标移动到查询结果的最后一行ResultSet.last来设置数值。
— unknown:每个查询的设置值为Integer.MAX_VALUE。
示例如下:
<property name="openjpa.jdbc.LRSSize" value="last"/>