日志信息 · 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日志記錄為其他支持的方法。