OpenJPA配置日志

转自：http://hi.baidu.com/f1jee/blog/item/6ef95df497efe965dcc4744c.html

 

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的日志还可以使用JDK自带的日志实现和自定义的日志，这里不详细介绍，请读者参阅相关的文档。