浅谈JAVA中的日志文件

hkebao

                                                                               
log4使用介绍
转载：http://www.blogjava.net/dosy/archive/2006/12/02/85100.html
log4的使用方法：
               
log4是具有日志记录功能，主要通过一个配置文件来对程序进行监测
有两种配置方式：一种程序配置，一种文件配置
有三个主要单元要了解，Logger,appender,layout.
               
logger是进行记录的主要类，appender是记录的方式，layout是记录的格式
logger七种日志级别：debug,info,warn,error,fatal,all,off
最常用的应该是debug()和info()；而warn()、error()、fatal()仅在相应事件发生后才使用
               
appender主要分三类，终端输出，文件输出，流输出
ConsoleAppender
FileAppender
WriterAppender
               
layout也分三类：简单格式，html格式，匹配格式
SimpleLayout
HTMLLayout
PatternLayout
               
输出简写：（用在PatternLayout)
%m 输出代码中指定的消息
%p 输出优先级
%r 输出自应用启动到输出该log信息耗费的毫秒数
%c 输出所属的类目，通常就是所在类的全名
%t 输出产生该日志事件的线程名
%n 输出一个回车换行符，Windows平台为“\r\n”，Unix平台为“\n”
%d 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，输出类似：2002年10月18日 22：10：28，921
%l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。一般使用了它就不需使用%c了
               
                                ［按照下面步骤来写吧！就可以得到我们所想要的日志文件哦！］
［按照顺序就可以将日志文件读出来了！］
作用实例：
程序配置一般过程：
1.得到特定名称的logger
2.得到其中一个layout
3.根据layout得到appender
4.logger添加appender
5.logger设置级别
6.logger输出有级别的日志信息
               
程序：
Logger logger = Logger.getLogger(Test.class.getName())     //取得logger
SimpleLayout simpleLayut = new SimpleLayout()              //取得layout
FileAppender fa = new FileAppender(simpleLayout,"test.log") //取得ppender
logger.addAppender(fa)                                     //添加appender
logger.set((Level)Level.DEBUG)                             //设置级别
logger.debug("hihihihih")                                  //记录信息
               
                               
文件配置过程：
1.得到特定名称的logger
2.加载配置文件      (配置文件做了２－５的工作)
3.logger输出有级别的日志信息
               
文件配置程序：
1.Logger logger = Logger.getLogger(Test.class.getName())     //取得logger
2.使用下面的配置加载
3.输出信息
               
                               
文件配置分properties,xml
读取properties：
PropertyConfigurator.configure("logTest.properties");
               
读取xml：
DOMConfigurator.configure("src/logTest.xml");
告别System.out.print()—J2SDK1.4新增Java日志框架 (一）
作为一名Java
程序员，最熟悉的、使用最多的调用恐怕莫过于System.out.print(“…”)。当你没有调试工具而要跟踪一个变量的值得时候；当你需要显示捕
获的Exception、Error的时候；当你想知道程序在运行的时候究竟发生了什么的时候，通常的做法就是调用System.out.print把他
们在终端、控制台上打印出来。这种方式对于输出信息的分类、格式化及永久保存带来诸多不便。虽然我们可以把它写入一个文件然后进行分析，但是这要需要编写
额外的程序代码，其成本不可忽视！而由此给目标系统本身增加的复杂程度不可避免的使开发、调试陷入一个深深的迷潭。
[要知道一点：如果说能不写的代码最好不要写！]

JDK1.4的推出，使得这一切即将成为历史。让我们向System.out.print()告别吧，使用Java Logging API为自己的程序构建一个完整的日志记录系统！

一、第一个实例
   先看一个简单的实例：SimpleLoggingTest.java
1 import java.util.logging.*;
2 public class SimpleLoggingTest {
3     public static void main(String args[]) {
4          //程序的其它处理
5          //使用Logger的静态方法获得一个匿名          //Logger
6          Logger logger1 = Logger.getAnonymousLogger();
7          //记录消息
8          logger1.log(Level.INFO,"第一条日志记录");
9          //程序的其它处理
10      }
11 }

              实例1

注意：编译、执行该程序需要JDK1.4及以上版本的支持。
运行该程序，可以在控制台看到程序运行结果：

2003-1-14 15:09:40 SimpleLoggingTest main
信息: 第一条日志记录
首先，程序引用java.util.Logging包（第1行）。接着，在适当的时候获得一个Logger(记录器)类的实例（第6行，获取一个匿名的Logger）。最后，在程序需要记录信息的地方调用Logger类的log方法进行记录（第8行，记录一个INFO级别的消息）。



二、Java Logging API

   Java Logging API封装在JDK1.4.0的java.util.Logging
包中。它通过产生便于最终用户、系统管理员、故障维护工程师以及软件开发团队（工程师）进行分析的日志记录为软件的开发调试和维护提供便利的手段。它捕获
操作系统平台和执行程序的安全故障、配置错误、执行瓶颈和（或）Bug等数据信息，以纯文本、XML或程序员自定的某种方式将其格式化成日志记录，然后传
递给内存、系统输出流、控制台、文件、Sockets等多种系统资源进行缓存和输出。

（一）、该软件包中的关键类。

n        Logger: 应用程序进行日志记录调用的主要实体。 Logger对象用于记录特定系统或应用程序的消息。
n        LogRecord: 用于在日志框架和单个记录处理程序之间传递记录请求。
n        Handler: 日志数据的最终输出处理器。它将LogRecord对象导出到各种目标，包括内存、输出流、控制台、文件和套接字。多种Handler子类可供用于这种用途。

                            图一

n        Level:  定义一组标准的记录级别，可用于控制记录的输出。可以把程序配置为只输出某些级别的记录，而忽略其他级别的输出。
n        Filter: 精细过滤、控制记录的内容，比记录级别所提供的控制准确得多。记录API支持通用的过滤器机制，这种机制允许应用程序代码添加任意过滤器以便控制记录的输出。
n        Formatter: 为LogRecord对象的格式化提供支持。

               图二

n        LogManager: Java Logging框架中唯一的、全局的对象，用于维护与Logger记录器及日志服务的一系列共享的数据结构及状态。它负责整个日志框架的初始化、维护一组全局性的Handle对象、维护一个树形结构的Logger的名字空间、诊测日志框架配置文件的改变从而重新读入并应用相关的参数以及负责程序停止运行时整个日志框架的清理工作。

（二）Logger

1、Logger的命名空间

在SimpleLoggingTest.java实例中，我们使用了一个匿名的（没有命名的）Logger对象。在Java Logging 框架中，Logger是可以命名的。Logger的名字空间与java类
的名字空间相同的结构相同：使用“.”间隔的字符串。Logger的名字空间体现了Logger的层次结构。例如：命名为“a.b”的Logger是命名
为“a.b.c”的“父”（上一级）Logger记录器。Logger的命名可以是任意的字符串，一般情况下，使用包或类的名字为Logger
进行命名。

Logger的名字空间由全局单列类LogManager的实例进行创建、维护。
[貌似在处理数据库的时候的DriverManage来管理数据库驱动一样了！]

匿名Logger不被存储在命名空间中。

2、创建Logger实例

Logger对象可以通过调用工厂方法getLogger或getAnonymousLogger获取。

//获取一个名为“A”的Logger对象

Logger loggerA= Logger.getLogger(“A”);

// 获取一个名为“A.B”的Logger对象，其上级记录器为loggerA。

Logger loggerAB= Logger.getLogger(“A.B”);

//获取一个匿名Logger对象

Logger loggerTmp = Logger.getAnonymousLogger();


对非匿名Logger，getLogger先在命名空间中查找同名的Logger对象，如果有，则返回该Logger对象；如果不存在，则在命名空间中创建注册一个新的Logger对象，并与其上级Logger对象相关联。
匿名Logger对象属于创建它的对象的私有对象，只能由创建它的对象使用，记录一些临时性的日志信息。而命名Logger对象使全局性的，在日志框架的生存期内，除了创建它的对象外还，可由其它对象用于记录日志信息。
匿名的Logger对象由一个全局的的root Logger “” 对象（root Logger的名字为空）。这意味着所有匿名Logger对象将从root Logger “”中继承行为。
匿名Logger对象通常用于java Applet应用中。它去掉了在运行过程中的一班性的安全检查，允许其创建类对象对Logger的控制、状态信息进行修改，如：setLevel设置Logger的日志消息记录级别；addHandle增加Logger的Handle（处理器）对象等。
一个Logger对象可以拥有有零个到多个Handler实例。当没有Handler时，如不禁止日志记录沿名字空
间向上传递，那该Logger对象的日志消息记录将有其拥有Handler实例的上级Logger进行处理。当一个Logger对象拥有多个
Handler实例对象时，其记录的日志数据将被所有的Handler逐一进行处理。

    （三）、Handler


Handler对象接收传来的日志消息将其输出。Handler可以把日志消息输出到多种目标资源，如：输出到控制台进行显示、写入日志文件、传送到网络上的远程日志服务进行处理、写入系统日志等任何物理资源

告别System.out.print()—J2SDK1.4新增Java日志框架（二）

Handler对象在创建时使用LogManager对象的相关属性的默认值（如Handler的Filter、Formatter、Level等对象属性）进行初始化。
Handler对象可通过调用setLevel(Level.OFF)暂停工作；通过调用setLevel设置适当的记录日志消息级别恢复工作。
Handler是一个抽象类。在J2SDK1.4中，其子类及它们之间的关系见图一。

1、   MemoryHandler
Handler的子类，在内存中的一个循环缓冲区用于缓存日志记录请求。通常MemoryHandler只简单的把传入的LogRecords存储到它的
内存中。这种缓存的开销非常低廉，它去掉了格式化所产生的系统消耗。当某个触发条件满足时，MemoryHandler将其缓冲的数据push(发布)到
目标Handler，由后者执行实际的输出。有三种模式触发MemoryHandler进行push操作：a、传入的LogRecords的级别高于
MemoryHandler预先定义的push级别；b、有其他对象显式的调用其push方法；c、其子类重载了log方法，逐一检索每个传入的
LogRecords，若符合特定的标准则进行push操作。

实例：假设我们需要跟踪一个生产环境中的一个很少出现的Bug。在大多数场合，
系统化产生大量的日志记录，而我们仅只关心记录中最近的几条，那么我们只需要使用MemoryHandler对日志记录进行缓存，当且仅当某个事件发生时
将最近的几条记录从内存中 dump到制定的文件中。

//MemoryHandlerTest.java
import java.util.logging.*;
import java.io.*;
public class MemoryHandlerTest {
FileHandler fhandler;
Logger logger;
MemoryHandler mhandler;

MemoryHandlerTest() {
     try {
         //构造名为my.log的日志记录文件
         fhandler = new FileHandler("my.log");
         int numRec = 5;
         //构造一个5个日志记录的MemoryHandler，
//其目标Handler为一个FileHandler
         mhandler = new MemoryHandler (fhandler, numRec, Level.OFF) ;
            //构造一个记录器
            logger = Logger.getLogger("com.mycompany");
            //为记录器添加一个MemoryHandler
         logger.addHandler(mhandler);
    } catch (IOException e) {

     }
}

public static void main(String args[]) {
     MemoryHandlerTest mt = new MemoryHandlerTest();
     int trigger = (int)(Math.random()*100);
    for (int i=1;i
        //在MemoryHandler中缓存日志记录
         mt.logger.log(Level.INFO,"日志记录"+i);
         if (i==trigger) {
            //触发事件成立，显式调用MemoryHandler的
//push方法触发目标Handler输出日志记录到
//my.log文件中
//当且仅当这个事件成立的时候就触发这个事件了！
            mt.mhandler.push();
            break;
         }
     }
}
}

                               实例2



2、         FileHandler 文件处理器。

StreamHandler流处理器将日志记录以流的形式输出。FileHandler、ConsoleHandler、SocketHandler为StreamHandler的子类。 ConsoleHandler将日志记录输出到控制终端。前面的实例（实例2除外）都将日记记录数据输出到控制台。

FileHandler将日志记录输出到特定的文件，或循环的几个日志文件中。日志文件可以设置容量大小。当日志文件达到限定的容量时将被自动清空，重头开始写入新的日志记录数据。

例：创建一个容量为1Mb的文件处理器

              int limit = 1000000; // 1 Mb

              FileHandler fh = new FileHandler("my.log", limit, 1);



对于循环的日志文件，每个文件将被指定容量限制。当当前的日志文件的长度达到制定值后该文件被关闭，新的日志文件被创建，旧的文件将在文件名模板后追加序号。如此产生多个顺序编号的日志记录文件。

例：

try {    // 创建一个拥有3个日志文件，每个容量为1Mb的文件处理器

        String pattern = "my%g.log";
int limit = 1000000; // 1 Mb
int numLogFiles = 3;
FileHandler fh = new FileHandler(pattern, limit, numLogFiles);
        …
} catch (IOException e) {
}

（四）、Level

Level对象定义了一组日志消息的级别，用于控制日志消息的输出。一个级别对应一个整型值。日志消息级别按照其整数值的大小排定优先级。在Logger对象中设定一个级别，则大于等于该级别的日志消息将会被传递到某个Handler对象进行输出处理。

J2SDK1.4的Java Logging框架中定义了以下消息级别：

   
        
            
            级别名称
            
            
            int值（Windows 2000环境）
            
        
        
            
            OFF
            
            
            2147483647
            
        
        
            
            SEVERE
            
            
            1000
            
        
        
            
            WARNING
            
            
            900
            
        
        
            
            INFO
            
            
            800
            
        
        
            
            CONFIG
            
            
            700
            
        
        
            
            FINE
            
            
            500        
            
        
        
            
            FINER
            
            
            400
            
        
        
            
            FINEST
            
            
            300
            
        
        
            
            ALL        
            
            
            -2147483648
            
        
   

                       表一

Level.OFF具有最高的级别。将Logger的Level级别设置成Level.OFF

让我们看看消息级别是怎样工作的：LoggingLevelTest.java

import java.util.logging.*;
public class LoggingLevelTest {
public static void main(String args[]) {
     //使用Logger的静态方法获得一个匿名Logger
     Logger logger1 = Logger.getAnonymousLogger();
     //设置Logger对象记录的最低日志消息级别
     logger1.setLevel(Level.FINER);
     //记录消息
     logger1.severe("SEVERE级消息");
     logger1.warning("WARNING级消息");
     logger1.config("CONFIG级消息");
     logger1.info("INFO级消息");
     logger1.fine("FINE级消息");
     logger1.finer("FINER级消息");
     logger1.finest("FINEST级消息");
}
}

                    实例3

运行结果：
2003-1-15 7:02:03 LoggingLevelTest main
服务器: SEVERE级消息
2003-1-15 7:02:04 LoggingLevelTest main
警告: WARNING级消息
2003-1-15 7:02:04 LoggingLevelTest main
   配置: CONFIG级消息

告别System.out.print()—J2SDK1.4新增Java日志框架（三）

2003-1-15 7:02:04 LoggingLevelTest main
信息: INFO级消息
可以看出，优先级低于INFO的日志消息不被记录。
Level的构造函数为protected便于程序员开发自己的消息级别类。

import java.util.logging.*;
//自定义消息级别
class myLevel extends Level{
//定义自己的消息级别SYSE
public static final Level SYSE = new myLevel("SYSE", Level.SEVERE.intValue()+10);
      public myLevel(String ln,int v) {
         super(ln,v);
}
}
public class MyLevelTest {
    public static void main(String args[]) {
      Logger logger1 = Logger.getAnonymousLogger();   
      //设置消息级别
      logger1.setLevel(myLevel.SYSE);
       //记录消息
       logger1.log(myLevel.SYSE,"SYSE消息");
       logger1.severe("SVERE消息");
}
}
                          实例4


运行结果：
           
2003-1-15 15:40:04 MyLevelTest main
SYSE: SYSE消息

只有SYSE消息被记录，SVERE消息不被记录，因为自定义级别SYSE高于SEVERE.

    （五）Formatter
Formatter负责对LogRecords进行格式化。每个记录处理器Handler同一个Formatter对象相关联。Formatter对象接收从Handler传来的LogRecord，将其格式化成字符串后返回给Handler进行输出。
Formatter是一个抽象类。在J2SDK1.4中，其子类及它们之间的关系见图二。
自定义扩展Formatter类。实例：MyFormatterTest.java

import java.util.Date;
import java.util.logging.*;

//创建每条日志记录以行的日志格式：
//时间消息级别消息ID日志信息内容
class MyFormatter extends Formatter {
        
    public String format(LogRecord rec) {
       StringBuffer buf = new StringBuffer(1000);
        buf.append(new Date().toLocaleString()); //时间
        buf.append(' ');
        buf.append(rec.getLevel()); //消息级别
        buf.append(' ');
        buf.append(rec.getMillis()); //作为消息ID
        buf.append(' ');
        buf.append(formatMessage(rec));//格式化日志记录数据
        buf.append('\n');    //换行
        return buf.toString();
    }      
}
public class MyFormatterTest {
    public static void main(String args[]){
       //创建记录器
Logger log1 = Logger.getLogger("MyLogger");
       //创建记录处理器
Handler mh = new ConsoleHandler();
//为记录处理器设置Formatter
       mh.setFormatter(new MyFormatter());
       //为记录器添加记录处理器
log1.addHandler(mh);
//禁止消息处理将日志消息上传给父级处理器
       log1.setUseParentHandlers(false);
       //记录消息
       log1.severe("消息1");
       log1.warning("消息2");
       log1.info("消息3");
       log1.config("消息4");
    }
}
                   实例5
程序运行结果：

2003-1-15 16:59:38 SEVERE 1042621178968 消息1
2003-1-15 16:59:40 WARNING 1042621178985 消息2
2003-1-15 16:59:41 INFO 1042621179105 消息3

三、配置文件
   J2SDK1.4的Java Logging框架的配置文件(Windows)：
%J2SDK1.4_HOME%/jre/lig/logging.properties
    从配置文件可以看到：
（一）自定义日志配置文件：
java -Djava.util.logging.config.file=myfile
   （二）全局Handler在Java VM启动时被加载。
（二）全局Handler默认为java.util.logging.ConsoleHandler。
handlers= java.util.logging.ConsoleHandler
所以我们的任何日志记录动作都会在控制台进行显示。
（三）缺省的消息记录级别为：INFO
.level= INFO
在缺省情况下我们在控制台看不见低于INFO级别的日志消息。
（四）缺省的Handler消息格式为java.util.logging.SimpleFormatter

四、日志框架在程序测试中的应用

    Logger类提供了两个的方法：Logger.entering()  Logger.exiting() 。这对我们调试自己的方法调用提供了便利的方式。
    例子：
    记录方法调用的输入参数和输出参数 方法myMethod将一个int 追加在一个对象之后。
运行该程序应将logging.properties的
java.util.logging.ConsoleHandler.level = INFO
改为：
java.util.logging.ConsoleHandler.level = ALL

import java.util.logging.*;
public class MyClass {
        public String myMethod(int p1, Object p2) {
           Logger logger = Logger.getLogger("com.mycompany.MyClass");
            if (logger.isLoggable(Level.FINER)) {
                logger.entering(this.getClass().getName(), "myMethod",
                                new Object[]{new Integer(p1), p2});
            }
            String tmp = p2.toString() + p1;
            if (logger.isLoggable(Level.FINER)) {
                logger.exiting(this.getClass().getName(), "myMethod", tmp);
            }
            return tmp;
        }
        public static void main(String args[]) {
          MyClass mc = new MyClass();
          String rslt = mc.myMethod(123,"Hello");
        }
}
后记
       J2SDK1.4引入的日志记录框架为构建简易的日志记录系统提供了便利的解决方案。虽然还有期它的一些专用日志包如Log4j，但从简单的打印输出到严密的、可扩展的日志记录框架，J2SDK1.4的日志系统已经足以满足一般的系统开发的要求
Log4j基本使用方法
Log4j由三个重要的组件构成：日志信息的优先级，日志信息的输出目的地，日志信息的输出格式。日志信息的优先级从高到低有ERROR、WARN、
INFO、DEBUG，分别用来指定这条日志信息的重要程度；日志信息的输出目的地指定了日志将打印到控制台还是文件中；而输出格式则控制了日志信息的显
示内容。
3.1.定义配置文件
Log4j支持两种配置文件格式，一种是XML格式的文件，一种是Java特性文件（键=值）。下面我们介绍使用Java特性文件做为配置文件的方法：
1.配置根Logger，其语法为：
log4j.rootLogger = [ level ] , appenderName, appenderName, …
其中，level
是日志记录的优先级，分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定义的级别。Log4j建议只使用四个级别，优
先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别，您可以控制到应用程序中相应级别的日志信息的开关。比如在这里定
义了INFO级别，则应用程序中所有DEBUG级别的日志信息将不被打印出来。
appenderName就是指定日志信息输出到哪个地方。您可以同时指定多个输出目的地。
        
2.配置日志信息输出目的地Appender，其语法为
          log4j.appender.appenderName = fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1 = value1
…
log4j.appender.appenderName.option = valueN
其中，Log4j提供的appender有以下几种：
         
org.apache.log4j.ConsoleAppender（控制台），
         
org.apache.log4j.FileAppender（文件），
         
org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件），org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件），
         
org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）
        
3.配置日志信息的格式（布局），其语法为：
          log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1 = value1
…
log4j.appender.appenderName.layout.option = valueN
其中，Log4j提供的layout有以下几种：
         
org.apache.log4j.HTMLLayout（以HTML表格形式布局），
         
org.apache.log4j.PatternLayout（可以灵活地指定布局模式），
         
org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
         
org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）
        
3.2.在代码中使用Log4j
      
      
下面将讲述在程序代码中怎样使用Log4j。
        3.2.1.得到记录器
      
      
使用Log4j，第一步就是获取日志记录器，这个记录器将负责控制日志信息。其语法为：
      
public static Logger getLogger( String name)，
      
通过指定的名字获得记录器，如果必要的话，则为这个名字创建一个新的记录器。Name一般取本类的名字，比如：
      
static Logger logger = Logger.getLogger ( ServerWithLog4j.class.getName () ) ;
        3.2.2.读取配置文件
      
      
当获得了日志记录器之后，第二步将配置Log4j环境，其语法为：
        
BasicConfigurator.configure ()： 自动快速地使用缺省Log4j环境。
        
PropertyConfigurator.configure ( String configFilename) ：读取使用Java的特性文件编写的配置文件。
        
DOMConfigurator.configure ( String filename ) ：读取XML形式的配置文件。
        3.2.3.插入记录信息（格式化日志信息）
      
      
当上两个必要步骤执行完毕，您就可以轻松地使用不同优先级别的日志记录语句插入到您想记录日志的任何地方，其语法如下：
      
Logger.debug ( Object message ) ;
        
Logger.info ( Object message ) ;
        
Logger.warn ( Object message ) ;
        
Logger.error ( Object message ) ;
[原来这样来插入信息啊！！！]
三、Appender组件［要将日志文件信息输出到什么 地方］
    Appender组件决定将日志信息输出到什么地方。支持以下目的地：
    . 控制台(Console);
    . 文件(File);
    . GUI组件(GUI component);
    . 套接口服务器(Remote socket server);
    . NT的事件记录器(NT Event Logger);
    . UNIX Syslog守护进程(Remote UNIX Syslog daemon);
    一个Logger可同时对应多个Appender，示例：myLogger配置二个Appender: 一个file, 一个是console：
    log4j.logger.myAppender=WARN,file,console
    log4j.appender.file=org.apache.log4j.RollingFileAppender
    log4j.appender.file.File=log.txt
    log4j.apender.console=org.apache.log4j.ConsoleAppender
四、Layout组件［以什么形式进行日志输出］
    Layout组件决定日志输出格式，有以下几种类型：
    . org.apache.log4j.HTMLLayout(以HTML表格形式布局);
    . org.apache.log4j.PatternLayout(可以灵活地指定布局模式);
    . org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串);
    . org.apache.log4j.TTCCLayout(包含日志产生的时间、线程和类别等信息);
五、Log4J的基本用法
［看看如何来定义配置文件吧！这个东西比较重要哦！］
    1. 定义配置文件
Log4J支持二种配置文件格式：XML和Java属性文件(采用“键=值”形式)。以下为Java属性文件
       格式配置文件：
      
       . 配置Logger组件
         
配置root Logger语法为：log4j.rootLogger=priority],appenderName,appenderName,...
#实例是这样来配置的：
#configure root logger
log4j.rootLogger=INFO,console
#表示级别为INFO，输出格式为控制台
配置自定义Logger组件语法为：log4j.logger.loggerName=priority],appenderName,appenderName,...
#define a logger named myLogger
log4j.logger.myLogger=WARN
#看看这个格式 与我们的标准格式是不是一样的啊呵呵！
#define a second logger that is a child to myLogger
log4j.logger.myLogger.mySonLogger=,file
#将日志内容输出到文件并且级别为WARN
其中：priority为日志级别，可选值包括FATAL、ERROR、WARN、INFO、DEBUG、ALL；
appenderName指定Appender组件，可指定多个;[可能保存到控制台也可能到文件]         
. 配置Appender组件
配置日志信息输出目的地Appender, 语法为：
         log4j.appender.appenderName=fully.ualified.name.of.appender.class
         log4j.appender.appenderName.option1=value1
         ...
         log4j.appender.appenderName.optionN=valueN
         Log4J提供的Appender有以下几种：可以取到这几种值哦！
         a. org.apache.log4j.ConsoleAppender(控制台);
         b. org.apache.log4j.FileAppender(文件);
         c. org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件);
         d. org.apache.log4j.RollingFileAppender(文件大小到指定尺寸产生一个新的文件);
         e. org.apache.log4j.WriteAppender(将日志信息以流格式发送到任意指定地方);
[配置好日志信息输出到哪个目的地方去哦！]
看实例吧：
#define an appender named console, which is set to be a ConsoleAppender
log4j.appender.console=org.apache.log4j.ConsoleAppender
#配置到控制台的配置文件是这样来写的！
# define an appender named file, which is set to be a RollingFileAppender
log4j.appender.file=org.apache.log4j.FileAppender
log4j.appender.file.File=log.txt
#配置到一个文本文件
. 配置Layout组件
配置Layout组件语法为：
［配置要输出的格式哦！］
         log4j.appender.appenderName.layout=fully.ualified.name.of.appender.class
         log4j.appender.appenderName.layout.option1=value1
         ...
         log4j.appender.appenderName.layout.optionN=valueN
来分析一下这个实例吧：
## LAYOUTS ##
# assian a SimpleLayout to console appender
log4j.appender.console.layout=org.apache.log4j.SimpleLayout
#表示是要进行简单的输出
# assian a PatternLayout to file appender
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%t%p-%m%n
#按照模式进行输出来！

下面为一配置文件示例，文件名为log4j.properties：
         ## LOGGERS ##
         #configure root logger
         log4j.rootLogger=INFO,console
         #define a logger named myLogger
         log4j.logger.myLogger=WARN
         #define a second logger that is a child to myLogger
         log4j.logger.myLogger.mySonLogger=,file
         ## APPENDERS ##
         #define an appender named console, which is set to be a ConsoleAppender
         log4j.appender.console=org.apache.log4j.ConsoleAppender
         # define an appender named file, which is set to be a RollingFileAppender
         log4j.appender.file=org.apache.log4j.FileAppender
         log4j.appender.file.File=log.txt
         ## LAYOUTS ##
         # assian a SimpleLayout to console appender
         log4j.appender.console.layout=org.apache.log4j.SimpleLayout
         # assian a PatternLayout to file appender
         log4j.appender.file.layout=org.apache.log4j.PatternLayout
         log4j.appender.file.layout.ConversionPattern=%t%p-%m%n
总结：如何来写配置文件?
1.配置Logger组件
语法如下：
#configure root logger
log4j.rootLogger=INFO,console
#表示级别为INFO，输出格式为控制台
#配置自定义Logger组件语法为：log4j.logger.loggerName=priority],appenderName,appenderName,...
#define a logger named myLogger
log4j.logger.myLogger=WARN
2.配置Appender组件
配置日志信息输出目的地Appender。就是说到底是输出到哪种格式下面去！
#define an appender named console, which is set to be a ConsoleAppender
log4j.appender.console=org.apache.log4j.ConsoleAppender
3.配置Layout组件
配置到底是以什么格式进行输出来的。可以用简单格式或XML或匹配格式等！
## LAYOUTS ##
# assian a SimpleLayout to console appender
log4j.appender.console.layout=org.apache.log4j.SimpleLayout
#表示格式为简单格式了！
OK了。就是这样一个顺序进行配置文件哦！
[好了，配置文件写好了之后如何来在程序中使用呢？]
2. 程序中使用Log4j
1. 获得日志记录器：
获得rootLogger：Logger rootLogger=Logger.getRootLogger();//根日志记录器
获得自定义Logger：
Logger myLogger =Logger.getLogger("log4j.logger.myLogger");
本程序是这样来写的：
//Get an instance of the myLogger   
Logger myLogger = Logger.getLogger("myLogger");         
//Get an instance of the childLogger   
Logger mySonLogger = Logger.getLogger("myLogger.mySonLogger");   
2.读取配置文件。配置好环境
  a. BasicConfigurator.configure(): 自动快速地使用默认Log4J环境;
  b. Property.configurator.configure(String configFilename): 读取使用Java属性格式的配置文件并配置Log4J环境；
  c. DOMConfigurator.configure(String filename): 读取XML形式的配置文件并配置LOG4J环境;
本程序是这样写的：
PropertyConfigurator.configure("test/com/log4j.properties");   
使用配置文件来读取哦！
3.输出日志信息;
  在程序代码中需要生成日志的地方，调用Logger的各种输出日志方法输出不同级别的日志，例如：
         
myLogger.debug("Thie is a log message from the " + myLogger.getName());
好了，下面就是我们的代码部分哦！
import org.apache.log4j.Logger;    import org.apache.log4j.PropertyConfigurator;        public class Test {        public static void main(String[] args) {        //Get an instance of the myLogger        Logger myLogger = Logger.getLogger("myLogger");              //Get an instance of the childLogger        Logger mySonLogger = Logger.getLogger("myLogger.mySonLogger");        //Load the proerties using the PropertyConfigurator        PropertyConfigurator.configure("log4j.properties");          //Log Messages using the Parent Logger        myLogger.debug("Thie is a log message from the " + myLogger.getName());        myLogger.info("Thie is a log message from the " + myLogger.getName());        myLogger.warn("Thie is a log message from the " +  myLogger.getName());        myLogger.error("Thie is a log message from the " + myLogger.getName());        myLogger.fatal("Thie is a log message from the " + myLogger.getName());          mySonLogger.debug("Thie is a log message from the " + mySonLogger.getName());        mySonLogger.info("Thie is a log message from the " + mySonLogger.getName());        mySonLogger.warn("Thie is a log message from the " +  mySonLogger.getName());        mySonLogger.error("Thie is a log message from the " + mySonLogger.getName());        mySonLogger.fatal("Thie is a log message from the " + mySonLogger.getName());      }   }   
六、在web应用中使用Log4J
    创建一个Servlet，在它初始化方法中读取Log4J配置文件并配置Log4J环境，这个Servlet在Web应用启动时候被加载和初始化，然后就可在其它Web组件中获取Logger对象并输出日志。
    1. 创建用于配置Log4J环境的Servlet
java 代码
import javax.servlet.*;   import javax.servlet.http.*;   import java.io.*;   import java.util.*;     import org.apache.log4j.PropertyConfigurator;     public class Log4JServlet extends HttpServlet {         public void init() throws ServletException {              String path = getServletContext().getRealPath("/");              //getInitParameter("propfile")方法从web.xml文件中读取Log4J配置文件的名字"profile"。              String propfile = path + getInitParameter("propfile");              PropertyConfigurator.configure(propfile);         }   }     
      该Servlet在web.xml中的配置如下：
xml 代码
servlet>    servlet-name>log4jServletservlet-name>    servlet-class>Log4JServletservlet-class>    init-param>      param-name>propfileparam-name>      param-value>/WEB-INF/log4j.propertiesparam-value>    init-param>    load-on-startup>1load-on-startup>  servlet>  
2. 在login.jsp中输出日志
       log4j.Logger"%>
      
         
           login
         
         
           
           
            
             username:
            
             password:
            
            
           
         
      
               
    3. 发布运行使用Log4J的web应用
       1) 将Log4J的JAR文件拷贝至目录：/WEB-INF/lib
       2) 创建Log4J的配置文件log4j.properties, 存放目录为：/WEB-INF。内容同前面配置文件示例。
       3) 编译Log4JServlet, 存放至目录： /WEB-INF/classes
       4) 修改web.xml文件，加入以下内容：
xml 代码
servlet>    servlet-name>log4jServletservlet-name>    servlet-class>Log4JServletservlet-class>    init-param>      param-name>profileparam-name>      param-value>/WEB-INF/log4j.propertiesparam-value>    init-param>    load-on-startup>1load-on-startup>  servlet>  
       5) 启动服务器，访问login.jsp页面，在服务器控制台上看到如下日志：
          WARN - Thie is a log message from the myLogger
          ERROR - Thie is a log message from the myLogger
          FATAL - Thie is a log message from the myLogger
          WARN - Thie is a log message from the myLogger.mySonLogger
          ERROR - Thie is a log message from the myLogger.mySonLogger
          FATAL - Thie is a log message from the myLogger.mySonLogger
          另在/WEB-INF目录下看到一个log.txt文件，内容如下：
          WARN - Thie is a log message from the myLogger.mySonLogger
          ERROR - Thie is a log message from the myLogger.mySonLogger
          FATAL - Thie is a log message from the myLogger.mySonLogger
                                        ［另一个专题］
   Log4j日志保存到数据库
   1. 创建日志表
CREATE TABLE [dbo].[LogInfo] (
[GUID] [int] IDENTITY (1, 1) NOT NULL , -- 流水号
[DATE] [datetime]NULL , --时间
[THREAD] [varchar] (200) COLLATE Chinese_PRC_CI_AS NULL , --当前线程
[LEVEL] [varchar] (200) COLLATE Chinese_PRC_CI_AS NULL ,--当前级别
[CLASS] [varchar] (200) COLLATE Chinese_PRC_CI_AS NULL ,--当前java程序/方法
[MESSAGES] [varchar] (2000) COLLATE Chinese_PRC_CI_AS NULL ---当前输出信息
)
2. 配置log4j.properties
log4j.rootLogger=DEBUG,CONSOLE,DATABASE
log4j.addivity.org.apache=true
# JDBC Appender
log4j.appender.DATABASE.Threshold=INFO
log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
#log4j.appender.DATABASE.BufferSize=10
log4j.appender.DATABASE.URL=jdbc:microsoft:sqlserver://localhost;DatabaseName=LogInfoTest
log4j.appender.DATABASE.driver=com.microsoft.jdbc.sqlserver.SQLServerDriver
log4j.appender.DATABASE.user= sa
log4j.appender.DATABASE.password= 1234
log4j.appender.DATABASE.sql=INSERT INTO YOU_LOG_TABLE VALUES ('%d{yyyy-MM-dd HH:mm:ss}', '%t', '%p', '%l', '%m')
log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout
%d %t %p %l %m %n 说明:
1) %d输出日志时间点的日期或时间，
2) %t 产生该日志事件的线程名；
3) %p 日志的log_level，如DEBUG、WARN或者INFO；
4) %c 输出所属的类目，通常就是所在类的全名，如“iNotes.Default”；
5) %m 日志的内容；
6) %l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。
7) %n 输出一个回车换行符，Windows平台为“ ”，Unix平台为“ ”
上面是保存到MSSQL中，那现在我们来分析一下如何保存到MYSQL中呢？
LOG4J的配置文件内容应该是：

LOG4J.ROOTLOGGER=INFO,DB
LOG4J.APPENDER.DB=ORG.APACHE.LOG4J.JDBC.JDBCAPPENDER
LOG4J.APPENDER.DB.BUFFERSIZE=10
  LOG4J.APPENDER.DB.URL=JDBC:MYSQL://LOCALHOST:3306/MANTIS?CREATEDATABASEIFNOTEXIST=TRUEAMP;USEUNICODE=TRUEAMP;CHARACTERENCODING=UTF-8
  LOG4J.APPENDER.DB.DRIVER=COM.MYSQL.JDBC.DRIVER
LOG4J.APPENDER.DB.USER=ROOT
LOG4J.APPENDER.DB.PASSWORD=EXPLOITER
LOG4J.APPENDER.DB.SQL=INSERT INTO
SYS_LOG(PRIORITY,LOG_DATE,CLASS_NAME,MSG,METHOD)
VALUES('%P','%D{YYYY-MM-DD HH:MM:SS}','%C',"%M",'%M')
LOG4J.APPENDER.DB.LAYOUT=ORG.APACHE.LOG4J.PATTERNLAYOUT


这里需要注意的问题是：

LOG4J.APPENDER.DB.SQL=INSERT
INTO SYS_LOG(PRIORITY,LOG_DATE,CLASS_NAME,MSG,METHOD)
VALUES('%P','%D{YYYY-MM-DD HH:MM:SS}','%C',"%M",'%M')
中的"%M",最好使用“”而不要使用‘’ 这样当日志内容有‘’或者（）时不会产生异常。


数据库（MYSQL）中的日志表：

DROP TABLE IF EXISTS `SYS_LOG`;
CREATE TABLE SYS_LOG (

ID INT NOT NULL AUTO_INCREMENT,
PRIORITY VARCHAR(10) ,
LOG_DATE VARCHAR(50) ,
CLASS_NAME VARCHAR(500) ,
MSG VARCHAR(10000) ,
METHOD VARCHAR(50) ,
PRIMARY KEY (ID)
) TYPE = INNODB;
[另一个好的网址]
提供了几种格式 的输出
                  
一、常用输出格式
%c   列出logger名字空间的全称，如加上{}表示出从最内层算起的指定层数的名字空间
%X  按MDC（Mapped Diagnostic Context,线程映射表）输出日志。通常用于多个客户端连接同一台服务器，方便服务器区分是那个客户端访问留下来的日志。
%p  日志信息级别
%d   %d{}:日志信息产生时间,使用ISO8601定义的日期格式
%C   日志信息所在地（全限类名）
%m   产生的日志具体信息
%n    输出日志信息换行
%F　显示调用logger的源文件名
%l     输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数
%L    显示调用logger的代码行
%M   显示调用logger的方法名
%r     显示从程序启动时到记录该条日志时已经经过的毫秒数
%t     输出产生该日志事件的线程名
%%　显示一个
二、log4j.properties
#控制包中日志输出级别
log4j.logger.org.apache.struts = debug
# 应用于控制台
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.Threshold=DEBUG
log4j.appender.CONSOLE.Target=System.out
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=[framework] %d - %-4r [%t] %-5p %c %x - %m%n
#log4j.appender.CONSOLE.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]
n%c[CATEGORY]%n%m[MESSAGE]%n%n
#应用于文件
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=file.log
log4j.appender.FILE.Append=false
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=[framework] %d - %-4r [%t] %-5p %c %x - %m%n
# Use this layout for LogFactor 5 analysis
# 应用于文件回滚
log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender
log4j.appender.ROLLING_FILE.Threshold=ERROR
log4j.appender.ROLLING_FILE.File=rolling.log
log4j.appender.ROLLING_FILE.Append=true
log4j.appender.ROLLING_FILE.MaxFileSize=100KB
log4j.appender.ROLLING_FILE.MaxBackupIndex=10
log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework] %d - %-4r [%t] %-5p %c %x - %m%n
#应用于socket
log4j.appender.SOCKET=org.apache.log4j.net.SocketAppender
log4j.appender.SOCKET.RemoteHost=localhost
log4j.appender.SOCKET.Port=5001
log4j.appender.SOCKET.LocationInfo=true
# Set up for Log Facter 5
log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout
log4j.appender.SOCET.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]%n%c[CATEGORY]%n%m[MESSAGE]%n%n
# Log Factor 5 Appender
log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender
log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000
# 发送日志给邮件
log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
log4j.appender.MAIL.Threshold=FATAL
log4j.appender.MAIL.BufferSize=10
log4j.appender.MAIL.From=web@www.wuset.com
log4j.appender.MAIL.SMTPHost=www.wusetu.com
log4j.appender.MAIL.Subject=Log4J Message
log4j.appender.MAIL.To=web@www.wusetu.com
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %-4r [%t] %-5p %c %x - %m%n
# 用于数据库
#我们现在就是要探讨一下如何保存到数据库里面去啊！
log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test
log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver
log4j.appender.DATABASE.user=root
log4j.appender.DATABASE.password=
log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES ('[framework] %d - %-4r [%t] %-5p %c %x - %m%n')
log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout
log4j.appender.DATABASE.layout.ConversionPattern=[framework] %d - %-4r [%t] %-5p %c %x - %m%n
#每日回滚日志文件
log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
log4j.appender.A1.File=SampleMessages.log4j
log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j'
log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout
#自定义Appender
log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender
log4j.appender.im.host = mail.cybercorlin.net
log4j.appender.im.username = username
log4j.appender.im.password = password
log4j.appender.im.recipient = corlin@cybercorlin.net
log4j.appender.im.layout=org.apache.log4j.PatternLayout
log4j.appender.im.layout.ConversionPattern =[framework] %d - %-4r [%t] %-5p %c %x - %m%n
                上面的内容是如何来写配置文件的哦！

               
               
               
               
               
               
               
               
               
               
               
               
               

本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u2/84280/showart_1422298.html