Java日志框架(二):log4j

简介

Log4j是Apache的一个开放源代码项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件、甚至是套接口服务 器、NT的事件记录器、UNIX Syslog守护进程等;我们也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。最令人感兴趣的就 是，这些可以通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。

通过在项目中使用 Log4J，我们可以控制日志信息输出到控
制台、文件、甚至是数据库中。我们可以控制每一条日志的输出格式，通过定义日志的输出级别，可以
更灵活的控制日志的输出过程。

官方网址

http://logging.apache.org/log4j/1.2/index.html

手册地址

http://logging.apache.org/log4j/1.2/manual.html

使用

maven依赖

    <dependencies>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
    </dependencies>

Java使用代码

        // 初始化系统配置，不需要配置文件
        BasicConfigurator.configure();
        // 创建日志记录器对象
        Logger logger = Logger.getLogger(Log4jTest.class);
        // 日志记录输出 
        /logger.info("hello log4j");
        // 日志级别
        logger.fatal("fatal"); // 严重错误，一般会造成系统崩溃和终止运行
        logger.error("error"); // 错误信息，但不会影响系统运行 
        logger.warn("warn"); // 警告信息，可能会发生问题 
        logger.info("info"); // 程序运行信息，数据库的连接、网络、IO操作等 
        logger.debug("debug"); // 调试信息，一般在开发阶段使用，记录程序的变量、参 数等 
        logger.trace("trace"); // 追踪信息，记录程序的所有流程信息    

log4j日志级别

日志级别在org.apache.log4j.Level 中定义
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/Level.html

OFF 关闭所有级别日志
ALL 打印所有级别日志

打开日志调试信息

	LogLog.setInternalDebugging(true);

log4j组件

Log4J 主要由 Loggers (日志记录器)、Appenders（输出端）和 Layout（日志格式化器）组成。其中
Loggers 控制日志的输出级别与日志是否输出；
Appenders 指定日志的输出方式（输出到控制台、文件等）；
Layout 控制日志信息的输出格式。

但是，自log4j 1.2版以来， Logger 类已经取代了 Category 类。对于熟悉早期版本的log4j的人来说，
Logger 类可以被视为 Category 类的别名。

Loggers

日志记录器，负责收集处理日志记录，实例的命名就是类“XX”的full quailied name（类的全限定名），
Logger的名字大小写敏感，其命名有继承机制：例如：name为org.apache.commons的logger会继承name为org.apache的logger。
Log4J中有一个特殊的logger叫做“root”，他是所有logger的根，也就意味着其他所有的logger都会直接或者间接地继承自root。
root logger可以用Logger.getRootLogger()方法获取。

Appenders

Appender 用来指定日志输出到哪个地方，可以同时指定日志的输出目的地。Log4j 常用的输出目的地
有以下几种：

输出端类型	作用
ConsoleAppender	将日志输出到控制台
FileAppender	将日志输出到文件中
DailyRollingFileAppender	将日志输出到一个日志文件，并且每天输出到一个新的文件
RollingFileAppender	将日志信息输出到一个日志文件，并且指定文件的尺寸，当文件大小达到指定尺寸时，会自动把文件改名，同时产生一个新的文件
JDBCAppender	把日志信息保存到数据库中

Layouts

布局器 Layouts用于控制日志输出内容的格式，让我们可以使用各种需要的格式输出日志。Log4j常用的Layouts:

格式化器类型	作用
HTMLLayout	格式化日志输出为HTML表格形式
SimpleLayout	简单的日志输出格式化，打印的日志格式为（info - message）
PatternLayout	最强大的格式化期，可以根据自定义格式输出日志，如果没有指定转换格式，就是用默认的转换格式

配置文件

文件目录

配置文件默认放在类路径下
在LogManager中定义, 加载文件名为 log4j.xml 或 log4j.properties

package org.apache.log4j;

public class LogManager {
    public static final String DEFAULT_CONFIGURATION_FILE = "log4j.properties";
    static final String DEFAULT_XML_CONFIGURATION_FILE = "log4j.xml";


       static {
          ...
            String configurationOptionStr = OptionConverter.getSystemProperty("log4j.configuration", (String)null);
            String configuratorClassName = OptionConverter.getSystemProperty("log4j.configuratorClass", (String)null);
            URL url = null;
            if (configurationOptionStr == null) {
                url = Loader.getResource("log4j.xml");
                if (url == null) {
                    url = Loader.getResource("log4j.properties");
                }
            } else {
                try {
                    url = new URL(configurationOptionStr);
                } catch (MalformedURLException var7) {
                    url = Loader.getResource(configurationOptionStr);
                }
            }

Layout的格式

在 log4j.properties 配置文件中，我们定义了日志输出级别与输出端，在输出端中分别配置日志的输出格式。

* log4j 采用类似 C 语言的 printf 函数的打印格式格式化日志信息，具体的占位符及其含义如下：
 %m 输出代码中指定的日志信息 
 %p 输出优先级，及 DEBUG、INFO 等 
 %n 换行符（Windows平台的换行符为 "\n"，Unix 平台为 "\n"） 
 %r 输出自应用启动到输出该 log 信息耗费的毫秒数 
 %c 输出打印语句所属的类的全名 
 %t 输出产生该日志的线程全名 
 %d 输出服务器当前时间，默认为 ISO8601，也可以指定格式，如：%d{yyyy年MM月dd日 HH:mm:ss}
 %l 输出日志时间发生的位置，包括类名、线程、及在代码中的行数。如： Test.main(Test.java:10) 
 %F 输出日志消息产生时所在的文件名称 
 %L 输出代码中的行号 
 %% 输出一个 "%" 字符 

 * 可以在 % 与字符之间加上修饰符来控制最小宽度、最大宽度和文本的对其方式。如： 
   %5c 输出category名称，最小宽度是5，category<5，默认的情况下右对齐
   %-5c 输出category名称，最小宽度是5，category<5，"-"号指定左对齐,会有空格 
   %.5c 输出category名称，最大宽度是5，category>5，就会将左边多出的字符截掉，<5不 会有空格
   %20.30c category名称<20补空格，并且右对齐，>30字符，就从左边交远销出的字符截掉
   

Appender的输出

#指定日志的输出级别与输出端 
log4j.rootLogger=INFO,Console 

# 控制台输出配置 
log4j.appender.Console=org.apache.log4j.ConsoleAppender 
log4j.appender.Console.layout=org.apache.log4j.PatternLayout 
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n 

# 文件输出配置
log4j.appender.A = org.apache.log4j.DailyRollingFileAppender 
#指定日志的输出路径 
log4j.appender.A.File = /logs/log.txt 
log4j.appender.A.Append = true
#使用自定义日志格式化器 
log4j.appender.A.layout = org.apache.log4j.PatternLayout
#指定日志的输出格式 
log4j.appender.A.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [%t:%r] - [%p] %m%n 
#指定日志的文件编码 
log4j.appender.A.encoding=UTF-8 

#mysql 
log4j.appender.logDB=org.apache.log4j.jdbc.JDBCAppender 
log4j.appender.logDB.layout=org.apache.log4j.PatternLayout 
log4j.appender.logDB.Driver=com.mysql.jdbc.Driver 
log4j.appender.logDB.URL=jdbc:mysql://localhost:3306/test 
log4j.appender.logDB.User=root 
log4j.appender.logDB.Password=root 
log4j.appender.logDB.Sql=INSERT INTO log(project_name,create_date,level,category,file_name,thread_name,line,all_categ ory,message) values('itcast','%d{yyyy-MM-dd HH:mm:ss}','%p','%c','%F','%t','%L','%l','%m')

Mysql建表语句：

CREATE TABLE `log` ( `log_id` int(11) NOT NULL AUTO_INCREMENT, 
 `project_name` varchar(255) DEFAULT NULL COMMENT '目项名', 
 `create_date` varchar(255) DEFAULT NULL COMMENT '创建时间',
 `level` varchar(255) DEFAULT NULL COMMENT '优先级', 
 `category` varchar(255) DEFAULT NULL COMMENT '所在类的全名', 
 `file_name` varchar(255) DEFAULT NULL COMMENT '输出日志消息产生时所在的文件名称 ', 
 `thread_name` varchar(255) DEFAULT NULL COMMENT '日志事件的线程名', 
 `line` varchar(255) DEFAULT NULL COMMENT '号行', 
 `all_category` varchar(255) DEFAULT NULL COMMENT '日志事件的发生位置', 
 `message` varchar(4000) DEFAULT NULL COMMENT '输出代码中指定的消息', 
 PRIMARY KEY (`log_id`) );

自定义Logger

针对单个类或包，自定义Logger

# RootLogger配置 
log4j.rootLogger = trace,console 

# 自定义Logger 
log4j.logger.com.yg = info,file 
log4j.logger.org.apache = error