Apache OpenJpa随笔 日志，缓存

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实现日志类别 属性名 描 述 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日志 <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 "/>

14.2.5 配置JDBC和数据库

— 属性名：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"/>