`
liumiao2011
  • 浏览: 52791 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

[转]使用Log4j进行日志操作

 
阅读更多

概述

             

1.1. 背景

             

在应用程序中添加日志记录总的来说基于三个目的:监视代码中变量的变化情况,周期性的记录到文件中供其他应用进行统计分析工作;跟踪代码运行时轨迹,作为日后审计的依据;担当集成开发环境中的调试器的作用,向文件或控制台打印代码的调试信息。

      

最普通的做法就是在代码中嵌入许多的打印语句,这些打印语句可以输出到控制台或文件中,比较好的做法就是构造一个日志操作类来封装此类操作,而不是让一系列的打印语句充斥了代码的主体。

      

1.2. Log4j简介

             

在强调可重用组件开发的今天,除了自己从头到尾开发一个可重用的日志操作类外,Apache为我们提供了一个强有力的日志操作包-Log4j。

      

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

      

此外,通过Log4j其他语言接口,您可以在C、C++、.Net、PL/SQL程序中使用Log4j,其语法和用法与在Java程序中一样,使得多语言分布式系统得到一个统一一致的日志组件模块。而且,通过使用各种第三方扩展,您可以很方便地将Log4j集成到J2EE、JINI甚至是SNMP应用中。

      

本文介绍的Log4j版本是1.2.3。作者试图通过一个简单的客户/服务器Java程序例子对比使用与不使用Log4j 1.2.3的差别,并详细讲解了在实践中最常使用Log4j的方法和步骤。在强调可重用组件开发的今天,相信Log4j将会给广大的设计开发人员带来方便。加入到Log4j的队伍来吧!

一个简单的例子

             

我们先来看一个简单的例子,它是一个用Java实现的客户/服务器网络程序。刚开始我们不使用Log4j,而是使用了一系列的打印语句,然后我们将使用Log4j来实现它的日志功能。这样,大家就可以清楚地比较出前后两个代码的差别。

      

2.1. 不使用Log4j

             

        2.1.1. 客户程序       

package log4j;

import java.io.*;
import java.net.*;

/**
 * <p> Client Without Log4j </p> <p> Description: a sample with log4j</p>
 * 
 * @version 1.0
 */
public class ClientWithoutLog4j
{
	/**
	 * @param args
	 */
	public static void main(String args[])
	{
		String welcome = null;
		String response = null;
		BufferedReader reader = null;
		PrintWriter writer = null;
		InputStream in = null;
		OutputStream out = null;
		Socket client = null;
		try
		{
			client = new Socket("localhost", 8001);
			System.out.println("info: Client socket: " + client);
			in = client.getInputStream();
			out = client.getOutputStream();
		}
		catch (IOException e)
		{
			System.out.println("error: IOException : " + e);
			System.exit(0);
		}
		try
		{
			reader = new BufferedReader(new InputStreamReader(in));
			writer = new PrintWriter(new OutputStreamWriter(out), true);
			welcome = reader.readLine();
			System.out.println("debug: Server says: '" + welcome + "'");
			System.out.println("debug: HELLO");
			writer.println("HELLO");
			response = reader.readLine();
			System.out.println("debug: Server responds: '" + response + "'");
			System.out.println("debug: HELP");
			writer.println("HELP");
			response = reader.readLine();
			System.out.println("debug: Server responds: '" + response + "'");
			System.out.println("debug: QUIT");
			writer.println("QUIT");
		}
		catch (IOException e)
		{
			System.out.println("warn: IOException in client.in.readln()");
			System.out.println(e);
		}
		try
		{
			Thread.sleep(2000);
		}
		catch (Exception ignored)
		{
		}
	}
}

 

 2.1.2. 服务器程序

package log4j;

import java.util.*;
import java.io.*;
import java.net.*;

/**
 * <p> Server Without Log4j </p> <p> Description: a sample with log4j</p>
 * 
 * @version 1.0
 */
public class ServerWithoutLog4j
{
	final static int SERVER_PORT = 8001; // this server's port

	/**
	 * @param args
	 */
	public static void main(String args[])
	{
		String clientRequest = null;
		BufferedReader reader = null;
		PrintWriter writer = null;
		ServerSocket server = null;
		Socket socket = null;
		InputStream in = null;
		OutputStream out = null;
		try
		{
			server = new ServerSocket(SERVER_PORT);
			System.out.println("info: ServerSocket before accept: " + server);
			System.out.println("info: Java server without log4j, on-line!");
			// wait for client's connection
			socket = server.accept();
			System.out.println("info: ServerSocket after accept: " + server);
			in = socket.getInputStream();
			out = socket.getOutputStream();
		}
		catch (IOException e)
		{
			System.out.println("error: Server constructor IOException: " + e);
			System.exit(0);
		}
		reader = new BufferedReader(new InputStreamReader(in));
		writer = new PrintWriter(new OutputStreamWriter(out), true);
		// send welcome string to client
		writer.println("Java server without log4j, " + new Date());
		while (true)
		{
			try
			{
				// read from client
				clientRequest = reader.readLine();
				System.out.println("debug: Client says: " + clientRequest);
				if (clientRequest.startsWith("HELP"))
				{
					System.out.println("debug: OK!");
					writer.println("Vocabulary: HELP QUIT");
				}
				else
				{
					if (clientRequest.startsWith("QUIT"))
					{
						System.out.println("debug: OK!");
						System.exit(0);
					}
					else
					{
						System.out.println("warn: Command '" + clientRequest
								+ "' not understood.");
						writer.println("Command '" + clientRequest
								+ "' not understood.");
					}
				}
			}
			catch (IOException e)
			{
				System.out.println("error: IOException in Server " + e);
				System.exit(0);
			}
		}
	}
}

 

2.2. 迁移到Log4j

  2.2.1. 客户程序

package log4j;

import java.io.*;
import java.net.*; // add for log4j: import some package
import org.apache.log4j.PropertyConfigurator;
import org.apache.log4j.Logger;
import org.apache.log4j.Level;

/**
 * <p> Client With Log4j </p> <p> Description: a sample with log4j</p>
 * 
 * @version 1.0
 */
public class ClientWithLog4j
{
	/*
	 * add for log4j: class Logger is the central class in the log4j package. we
	 * can do most logging operations by Logger except configuration.
	 * getLogger(...): retrieve a logger by name, if not then create for it.
	 */
	static Logger logger = Logger.getLogger(ClientWithLog4j.class.getName());

	/**
	 * @param args :
	 *            configuration file name
	 */
	public static void main(String args[])
	{
		String welcome = null;
		String response = null;
		BufferedReader reader = null;
		PrintWriter writer = null;
		InputStream in = null;
		OutputStream out = null;
		Socket client = null;
		/*
		 * add for log4j: class BasicConfigurator can quickly configure the
		 * package. print the information to console.
		 */
		PropertyConfigurator.configure("ClientWithLog4j.properties");
		// add for log4j: set the level
		// logger.setLevel ( ( Level ) Level.DEBUG ) ;
		try
		{
			client = new Socket("localhost", 8001);
			// add for log4j: log a message with the info level
			logger.info("Client socket: " + client);
			in = client.getInputStream();
			out = client.getOutputStream();
		}
		catch (IOException e)
		{
			// add for log4j: log a message with the error level
			logger.error("IOException : " + e);
			System.exit(0);
		}
		try
		{
			reader = new BufferedReader(new InputStreamReader(in));
			writer = new PrintWriter(new OutputStreamWriter(out), true);
			welcome = reader.readLine();
			// add for log4j: log a message with the debug level
			logger.debug("Server says: '" + welcome + "'");
			// add for log4j: log a message with the debug level
			logger.debug("HELLO");
			writer.println("HELLO");
			response = reader.readLine();
			// add for log4j: log a message with the debug level
			logger.debug("Server responds: '" + response + "'");
			// add for log4j: log a message with the debug level
			logger.debug("HELP");
			writer.println("HELP");
			response = reader.readLine();
			// add for log4j: log a message with the debug level
			logger.debug("Server responds: '" + response + "'");
			// add for log4j: log a message with the debug level
			logger.debug("QUIT");
			writer.println("QUIT");
		}
		catch (IOException e)
		{
			// add for log4j: log a message with the warn level
			logger.warn("IOException in client.in.readln()");
			System.out.println(e);
		}
		try
		{
			Thread.sleep(2000);
		}
		catch (Exception ignored)
		{
		}
	}
}

 2.2.2. 服务器程序

package log4j;

import java.util.*;
import java.io.*;
import java.net.*; // add for log4j: import some package
import org.apache.log4j.PropertyConfigurator;
import org.apache.log4j.Logger;
import org.apache.log4j.Level;

/**
 * <p> Server With Log4j </p> <p> Description: a sample with log4j</p>
 * 
 * @version 1.0
 */
public class ServerWithLog4j
{
	final static int SERVER_PORT = 8001; // this server's port

	/*
	 * add for log4j: class Logger is the central class in the log4j package. we
	 * can do most logging operations by Logger except configuration.
	 * getLogger(...): retrieve a logger by name, if not then create for it.
	 */
	static Logger logger = Logger.getLogger(ServerWithLog4j.class.getName());

	/**
	 * @param args
	 */
	public static void main(String args[])
	{
		String clientRequest = null;
		BufferedReader reader = null;
		PrintWriter writer = null;
		ServerSocket server = null;
		Socket socket = null;
		InputStream in = null;
		OutputStream out = null;
		/*
		 * add for log4j: class BasicConfigurator can quickly configure the
		 * package. print the information to console.
		 */
		PropertyConfigurator.configure("ServerWithLog4j.properties");
		// add for log4j: set the level
		// logger.setLevel ( ( Level ) Level.DEBUG ) ;
		try
		{
			server = new ServerSocket(SERVER_PORT);
			// add for log4j: log a message with the info level
			logger.info("ServerSocket before accept: " + server);
			// add for log4j: log a message with the info level
			logger.info("Java server with log4j, on-line!");
			// wait for client's connection
			socket = server.accept();
			// add for log4j: log a message with the info level
			logger.info("ServerSocket after accept: " + server);
			in = socket.getInputStream();
			out = socket.getOutputStream();
		}
		catch (IOException e)
		{
			// add for log4j: log a message with the error level
			logger.error("Server constructor IOException: " + e);
			System.exit(0);
		}
		reader = new BufferedReader(new InputStreamReader(in));
		writer = new PrintWriter(new OutputStreamWriter(out), true);
		// send welcome string to client
		writer.println("Java server with log4j, " + new Date());
		while (true)
		{
			try
			{
				// read from client
				clientRequest = reader.readLine();
				// add for log4j: log a message with the debug level
				logger.debug("Client says: " + clientRequest);
				if (clientRequest.startsWith("HELP"))
				{
					// add for log4j: log a message with the debug level
					logger.debug("OK!");
					writer.println("Vocabulary: HELP QUIT");
				}
				else
				{
					if (clientRequest.startsWith("QUIT"))
					{
						// add for log4j: log a message with the debug level
						logger.debug("OK!");
						System.exit(0);
					}
					else
					{
						// add for log4j: log a message with the warn level
						logger.warn("Command '" + clientRequest
								+ "' not understood.");
						writer.println("Command '" + clientRequest
								+ "' not understood.");
					}
				}
			}
			catch (IOException e)
			{
				// add for log4j: log a message with the error level
				logger.error("IOException in Server " + e);
				System.exit(0);
			}
		}
	}
}

  2.2.3. 配置文件             

2.2.3.1. 客户程序配置文件

log4j.rootLogger=INFO, A1
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%-4r %-5p [%t] %37c %3x - %m%n

 

2.2.3.2. 服务器程序配置文件

log4j.rootLogger=INFO, A1 log4j.appender.A1=org.apache.log4j.ConsoleAppender log4j.appender.A1.layout=org.apache.log4j.PatternLayout log4j.appender.A1.layout.ConversionPattern=%-4r %-5p [%t] %37c %3x - %m%n 

 

2.3. 比较

             

比较这两个应用可以看出,采用Log4j进行日志操作的整个过程相当简单明了,与直接使用System.out.println语句进行日志信息输出的方式相比,基本上没有增加代码量,同时能够清楚地理解每一条日志信息的重要程度。通过控制配置文件,我们还可以灵活地修改日志信息的格式,输出目的地等等方面,而单纯依靠System.out.println语句,显然需要做更多的工作。

      

下面我们将以前面使用Log4j的应用作为例子,详细讲解使用Log4j的主要步骤。

 

Log4j基本使用方法

             

Log4j由三个重要的组件构成:日志信息的优先级,日志信息的输出目的地,日志信息的输出格式。日志信息的优先级从高到低有 ERROR、WARN、INFO、DEBUG,分别用来指定这条日志信息的重要程度;日志信息的输出目的地指定了日志将打印到控制台还是文件中;而输出格式则控制了日志信息的显示内容。

      

3.1.定义配置文件

             

其实您也可以完全不使用配置文件,而是在代码中配置Log4j环境。但是,使用配置文件将使您的应用程序更加灵活。

      

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 ) ;       

      

参考资料

      

如果您想更深入地了解Log4j,请经常访问下面提及的相关链接。

      

Log4j项目主页------------------------------------------------------         www.log4j.org       

      

Log4j FAQ    -------------------------------------------------------         www.log4j.org/log4j/faq.html       

关于作者

葵贞祥,SCJP(Sun Certified Java 2 Programmer),具有7年国内国外知名企业工作经历,目前兴趣集中在对Java的C/S、B/S大型应用上,您可以通过         chinesemars@hotmail.com和他联系。       

分享到:
评论

相关推荐

    使用Log4j进行日志操作

    ### 使用Log4j进行日志操作 #### 一、Log4j简介与核心特性 Log4j是一款由Apache开发的开源日志框架,它为Java应用程序提供了强大的日志记录功能。借助于Log4j,开发者可以轻松控制日志信息的流向(如控制台、文件...

    使用Log4j进行日志操作.zip_java 操作日志_java 日志_log4j_系统日志

    在本文中,我们将深入探讨如何使用Log4j进行日志操作。 首先,理解Log4j的基本组件是至关重要的。Log4j包含三个主要部分:Logger(日志器)、Appender(输出目的地)和Layout(格式化器)。 1. **Logger**: 这是...

    tomcat下的log4j日志配置

    在使用 Apache Tomcat 作为服务器时,合理配置日志框架(如 Log4j)能够极大地提高开发效率和系统的可维护性。本文将详细介绍两种常见的 Log4j 配置方式:Tomcat 级别的统一日志管理和每个 web 应用分别配置 Log4j,...

    Log4j实现日志操作

    这篇博客将深入探讨如何使用Log4j进行日志操作。** 首先,我们需要理解Log4j的基本组件。Log4j由三部分组成:配置器(Configurator)、日志记录器(Logger)和输出处理器(Appender)。配置器负责设置日志行为,...

    动态设置log4j的日志级别

    要实现动态设置Log4j日志级别,通常有以下几种方法: 1. **通过配置文件**:最常见的方式是通过修改log4j.properties或log4j.xml配置文件。例如,你可以将某个类或整个包的日志级别设置为WARN: ```xml ```...

    使用log4j 记录日志到数据库

    总的来说,“使用log4j记录日志到数据库”涉及Java日志管理、数据库操作和系统监控等多个方面。理解并熟练运用Log4j的配置和定制,能够帮助开发者更有效地管理和分析系统的运行状况,提升问题定位和解决效率。

    Tomcat使用Log4j输出catalina.out日志

    这个文件是Log4j日志配置的核心,用于定义日志的输出格式、日志文件的滚动规则等。 2. 配置DailyRollingFileAppender:通过定义一个DailyRollingFileAppender,可以使得日志文件按照日期进行滚动,每天生成一个新的...

    mybatis,log4j打印日志到后台和文件

    Log4j 是一个广泛使用的日志记录工具,能够帮助开发者跟踪应用程序运行过程中的信息、警告、错误等事件。本文将深入探讨如何在 MyBatis 中配置 Log4j,实现日志同时输出到后台控制台和文件。 1. **日志框架集成** ...

    Log4j日志配置说明,Log4j日志配置说明

    ### Log4j日志配置详解 #### 一、概述 Log4j 是一个基于 Java 的开源日志记录框架,由 Apache 软件基金会维护。它允许开发人员根据等级记录日志信息,使得用户能够控制日志信息的记录级别及去向。本文将通过一份...

    log4j(二):动态配置日志输出路径

    Log4j是Apache提供的一款广泛使用的日志框架,它提供了丰富的功能和灵活的配置,使得我们可以根据需要动态地改变日志的输出路径。本文将深入探讨如何在Log4j中实现日志输出路径的动态配置。 首先,我们要理解Log4j...

    log4j日志文件乱码解决方法

    本文将详细讨论如何解决Log4j日志文件出现的乱码问题。 首先,我们要理解Log4j的工作原理。Log4j允许开发者自定义日志输出的方式,包括输出到控制台、文件、数据库等。它使用了`QuietWriter`类来写入日志,`...

    Kafka+Log4j实现日志集中管理

    本主题将深入探讨如何使用Apache Kafka和Log4j来实现日志的集中管理和处理。Kafka是一个高吞吐量、分布式的消息发布订阅系统,而Log4j则是一款广泛使用的Java日志框架,二者结合能有效提升日志处理效率和分析能力。 ...

    log4J日志.zip

    在“log4j日志.zip”压缩包中,包含的可能是Log4j的配置文件(如log4j.properties或log4j.xml)。这个文件定义了日志的级别、输出位置和格式。例如: ```properties # log4j.properties 示例 log4j.rootLogger=...

    打log4j日志-ibatis的sql输出

    这里,`logImpl`设置指定了日志实现的类型,我们将其设置为"LOG4J",表示使用Log4j进行日志记录。然后,确保你的应用已经正确地引入了Log4j的依赖,并且配置了`log4j.properties`或`log4j.xml`。 在`log4j....

    Log4J日志代码

    在"Log4J日志代码"这个主题中,我们将深入探讨Log4J的核心概念、配置以及如何在Java项目中使用。 1. **核心组件**: - **Logger**: 是日志记录的主要接口,通过它来创建和发送日志消息。开发者可以根据类名或模块...

    Log4j日志等级,具体说明了log4j中的日志记录等级,对于自己写日志有很大帮助。

    在深入探讨Log4j日志等级之前,我们首先需要了解Log4j是什么。Log4j是Apache的一个开源项目,用于Java应用程序的日志记录。它提供了一种高度灵活且功能强大的日志解决方案,允许开发者和系统管理员自定义日志级别、...

    简单java操作log4j+Mysql存储日志信息

    在这个场景中,我们使用了SLF4J(Simple Logging Facade for Java)作为日志抽象层,它为各种日志框架提供了统一的API,而SLF4J-log4j12-1.5.0.jar和slf4j-api-1.5.0.jar正是SLF4J与Log4j之间的桥梁,使得我们可以...

    Log4j2简介及与Log4j效率对比

    与Log4j 1.x相比,Log4j2在设计上进行了重大改进,并解决了Logback等其他日志框架中存在的某些体系结构问题。 #### 特性概述 1. **审计功能**:Log4j2设计时考虑到了审计需求,这意味着即使在配置更新过程中,它也...

Global site tag (gtag.js) - Google Analytics