日志信息 · Java 开源项目中文文档

# 日志信息 MyBatis Generator（MBG）报告日志记录的几种不同的方式： * MBG每次运行的时候会记录并且显示警告信息。这些消息的目的是告诉用户需要注意可能存在的重要事件，也可能不是。例如文件正在被覆盖，或者非致命的配置错误等等。无论配置和命令行参数怎么配置，警告总是会显示。 * MBG生成器每次运行的时候可能会或者不会显示进度信息。这些信息用来告诉用户代码生成的器的进度信息。这些信息默认不显示，但是可以通过指定`-verbose`命令行参数进行显示。或者您通过Ant任务运行MBG，您可以通过设置`verbose` 属性为 `true`, 这样Ant就会运行在verbose模式。 * 最后，MBG将生成跟踪(记录)详细的调试消息。本页说明如何启用这些语句。一般来说，MBG不会重复消息。所以MBG生成警告的时候这个警告通常还没记录。在某些情况下需要启用日志记录以及要求MBG记录详细进度消息的时候可能会有用。这可能会产生大量的输出，但是仍然会提供一个MBG运行期间完整的内部事件描述。如果Log4J在运行时的类路径中，MBG就会使用Apache Log4J进行记录。查阅[http://logging.apache.org/log4j/](http://logging.apache.org/log4j/) 获取有关Log4J的详细信息。如果Log4J不在运行时的类路径中，MBG会使用标准的Java日志记录。即使运行时类路径中存在Log4J，您仍然想强制使用标准的Java日志记录，您可以在命令行参数指定`-forceJavaLogging` ，或者当您通过Java执行MBG时使用执行下面的方法： `org.mybatis.generator.logging.LogFactory.forceJavaLogging();` **重要:** 您必须将上面的方法放在任何MBG代码_之前_。 ## 提供备用的实现如果您喜欢使用不同的日志实现比Log4J的或标准的Java日志记录，您可能会提供一个备用实施的关键日志界面如下： 1. 创建`org.mybatis.generator.logging.Log`接口的实现，实现您选择的日志实现的关键日志方法。 2. 创建`org.mybatis.generator.logging.AbstractLogFactory`接口的实现，将返回您`Log`实现的实例。 3. 配置MBG通过调用方法来使用新的LogFactory `org.mybatis.generator.logging.LogFactory.setLogFactory(AbstractLogFactory)`并提供您的实例`AbstractLogFactory`实现。 ## 配置Log4J日志下面是一个log4j配置文件示例： ``` # Set root logger log4j.rootLogger=INFO, A1 # A1 is set to be a ConsoleAppender. log4j.appender.A1=org.apache.log4j.ConsoleAppender log4j.appender.A1.layout=org.apache.log4j.PatternLayout log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %c - %m%n # MBG logging configuration... log4j.logger.org.mybatis.generator=DEBUG ``` 这个文件指示Log4J将MBG所有调试信息输出到控制台。要使用此文件： 1. 运行时类路径的根目录创建一个名为`log4j.properties`的文件 2. 将上面的条目复制到新文件 3. 运行MBG时，Log4J的JAR文件也需要在运行时类路径下。您应该可以在控制台中看到很多日志信息。如果您喜欢，您也可以配置log4j任何其他支持的方法。 ## 配置Java日志记录下面是一个Java日志记录配置的示例文件: ``` # 指定root logger要创建的处理程序 # (所有的loggers都是root logger的孩子) handlers = java.util.logging.ConsoleHandler # 为 root logger 设置默认日志记录级别 .level = INFO # Set the default logging level for new ConsoleHandler instances java.util.logging.ConsoleHandler.level = ALL # Set the default formatter for new ConsoleHandler instances java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter # Set the default logging level for the logger named org.mybatis.generator org.mybatis.generator.level = FINE ``` 这个文件将指导Java写的所有MBG调试消息到控制台。要使用此文件： 1. 创建一个名为`logging.properties` （或者您喜欢的任何文件名 ??）的文件。该文件可以在文件系统中存在的任何地方（例如，在一个`\temp`目录）。 2. 将上述条目复制到新文件 3. 运行MBG时带上这个VM参数： `-Djava.util.logging.config.file=\temp\logging.properties` （指定您使用的实际的文件名 ??和目录）在控制台中您将看到许多日志信息。如果您喜欢，您还可以配置Java日志记录为其他支持的方法。