Log4j详细使用教程_动力节点Java学院整理

日志是应用软件中不可缺少的部分，Apache的开源项目Log4j是一个功能强大的日志组件,提供方便的日志记录。在apache网站：jakarta.apache.org/log4j 可以免费下载到Log4j最新版本的软件包。

一、入门实例

1.新建一个JAva工程，导入包log4j-1.2.17.jar，整个工程最终目录如下

2、src同级创建并设置log4j.properties

 ### 设置### 
log4j.rootLogger = debug,stdout,D,E 
 
### 输出信息到控制抬 ### 
log4j.appender.stdout = org.apache.log4j.ConsoleAppender 
log4j.appender.stdout.Target = System.out 
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout 
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n 
 
### 输出DEBUG 级别以上的日志到=E://logs/error.log ### 
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender 
log4j.appender.D.File = E://logs/log.log 
log4j.appender.D.Append = true 
log4j.appender.D.Threshold = DEBUG 
log4j.appender.D.layout = org.apache.log4j.PatternLayout 
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n 
 
### 输出ERROR 级别以上的日志到=E://logs/error.log ### 
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender 
log4j.appender.E.File =E://logs/error.log 
log4j.appender.E.Append = true 
log4j.appender.E.Threshold = ERROR 
log4j.appender.E.layout = org.apache.log4j.PatternLayout 
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n 

3、设置日志内容

import org.apache.log4j.Logger; 
/** 
 *@author linbingwen 
 *@2015年5月18日9:14:21 
 */ 
public class Test { 
 private static Logger logger = Logger.getLogger(Test.class); 
 
 /** 
 * @param args 
 */ 
 public static void main(String[] args) { 
 // System.out.println("This is println message."); 
  
 // 记录debug级别的信息 
 logger.debug("This is debug message."); 
 // 记录info级别的信息 
 logger.info("This is info message."); 
 // 记录error级别的信息 
 logger.error("This is error message."); 
 } 
 
} 

4、输出结果

（1）首先是控制台的信息

（2）再来看输出的文件

内容如下，发现已按照要求输出到对应的文档中去了。

二、Log4j基本使用方法

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

2.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就是指B日志信息输出到哪个地方。您可以同时指定多个输出目的地。

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有以e几种：

org.apache.log4j.HTMLLayout（以HTML表格形式布局）， 
org.apache.log4j.PatternLayout（可以灵活地指定布局模式）， 
org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串）， 
org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息） 

　　Log4J采用类似C语言中的printf函数的打印格式格式化日志信息，打印参数如下： %m 输出代码中指定的消息

%p 输出优先级，即DEBUG，INFO，WARN，ERROR，FATAL 
%r 输出自应用启动到输出该log信息耗费的毫秒数 
%c 输出所属的类目，通常就是所在类的全名 
%t 输出产生该日志事件的线程名 
%n 输出一个回车换行符，Windows平台为“rn”，Unix平台为“n” 
%d 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，输出类似：2002年10月18日 22：10：28，921 
%l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。举例：Testlog4.main(TestLog4.java:10) 

2.2、在代码中使用Log4j

1.得到记录器

　　使用Log4j，第一步就是获取日志记录器，这个记录器将负责控制日志信息。其语法为：
　　public static Logger getLogger( String name)
　　通过指定的名字获得记录器，如果必要的话，则为这个名字创建一个新的记录器。Name一般取本类的名字，比如：
　　static Logger logger = Logger.getLogger ( ServerWithLog4j.class.getName () )

2.读取配置文件

　　当获得了日志记录器之后，第二步将配置Log4j环境，其语法为：
BasicConfigurator.configure ()： 自动快速地使用缺省Log4j环境。 
PropertyConfigurator.configure ( String configFilename) ：读取使用Java的特性文件编写的配置文件。 
DOMConfigurator.configure ( String filename ) ：读取XML形式的配置文件。 

3.插入记录信息（格式化日志信息）

当上两个必要步骤执行完毕，您就可以轻松地使用不同优先级别的日志记录语句插入到您想记录日志的任何地方，其语法如下：

Logger.debug ( Object message ) ; 
Logger.info ( Object message ) ; 
Logger.warn ( Object message ) ; 
Logger.error ( Object message ) ; 

2.3、日志级别

每个Logger都被了一个日志级别（log level），用来控制日志信息的输出。日志级别从高到低分为：
A：off 最高等级，用于关闭所有日志记录。
B：fatal 指出每个严重的错误事件将会导致应用程序的退出。
C：error 指出虽然发生错误事件，但仍然不影响系统的继续运行。
D：warm 表明会出现潜在的错误情形。
E：info 一般和在粗粒度级别上，强调应用程序的运行全程。
F：debug 一般用于细粒度级别上，对调试应用程序非常有帮助。
G：all 最低等级，用于打开所有日志记录。

上面这些级别是定义在org.apache.log4j.Level类中。Log4j只建议使用4个级别，优先级从高到低分别是error,warn,info和debug。通过使用日志级别，可以控制应用程序中相应级别日志信息的输出。例如，如果使用b了info级别，则应用程序中所有低于info级别的日志信息(如debug)将不会被打印出来。

三、Web项目中使用Log4j实例

    上面代码描述了Log4j的简单应用，其实使用Log4j也就是这样简单方便。当然除了上面的配置方法，还有其它，比如做一个J2EE应用，在J2EE应用使用Log4j，必须先在启动服务时加载Log4j的配置文件进行初始化，可以在web.xml中进行。

1、web应用的log4j使用基本上都采用：新建一个servlet，这个servlet在init函数中为log4j执行配置。一般就是读入配置文件。所以需要在web.xml中为这个servlet配置，同时设定load-on-startup为1。
2、这个servlet配置log4j就是读出配置文件，然后调用configure函数。这里有两个问题：一、需要知道文件在哪里；二、需要正确的文件类型
3、配置文件位置在web.xml中配置一个param即可，路径一般是相对于web的root目录
4、文件类型一般有两种，一个是Java的property文件，另一种是xml文件
配置文件的大致内容：log4j可以指定输出的log级别的最低等级，以及log的输出配置格式，每个log可以指定多个输出方式

（1）创建Web工程，整个工程最后目录如下

（2）web.xml配置如下：

<?xml version="1.0" encoding="UTF-8"?> 
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xmlns="http://java.sun.com/xml/ns/javaee" 
 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" 
 id="WebApp_ID" version="3.0"> 
 <display-name>LogLearning</display-name> 
 
 <servlet> 
 <servlet-name>Log4JTestServlet</servlet-name> 
 <servlet-class>com.mucfc.Log4JTestServlet</servlet-class> 
 </servlet> 
 
 <!--用来启动 log4jConfigLocation的servlet --> 
 <servlet> 
 <servlet-name>Log4JInitServlet</servlet-name> 
 <servlet-class>com.mucfc.Log4JInitServlet</servlet-class> 
 <init-param> 
  <param-name>log4j-properties-location</param-name> 
  <param-value>/WEB-INF/classes/log4j.properties</param-value> 
 </init-param> 
 <load-on-startup>1</load-on-startup> 
 </servlet> 
 
 <servlet-mapping> 
 <servlet-name>Log4JTestServlet</servlet-name> 
 <url-pattern>/test</url-pattern> 
 </servlet-mapping> 
 
</web-app> 

（3）配置文件log4j.properties

 ### set log levels ### 
log4j.rootLogger = debug,stdout,D,E 
 
 
log4j.appender.stdout = org.apache.log4j.ConsoleAppender 
log4j.appender.stdout.Target = System.out 
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout 
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n 
 
 
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender 
log4j.appender.D.File = F://logs/log.log 
log4j.appender.D.Append = true 
log4j.appender.D.Threshold = DEBUG 
log4j.appender.D.layout = org.apache.log4j.PatternLayout 
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n 
 
 
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender 
log4j.appender.E.File =F://logs/error.log 
log4j.appender.E.Append = true 
log4j.appender.E.Threshold = ERROR 
log4j.appender.E.layout = org.apache.log4j.PatternLayout 
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n 

（4）web容器一来就初始化的servlet

Log4JInitServlet.java

import java.io.File; 
import java.io.IOException; 
 
import javax.servlet.ServletConfig; 
import javax.servlet.ServletContext; 
import javax.servlet.ServletException; 
import javax.servlet.annotation.WebServlet; 
import javax.servlet.http.HttpServlet; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
 
import org.apache.log4j.BasicConfigurator; 
import org.apache.log4j.PropertyConfigurator; 
 
/** 
 * Servlet implementation class Log4JInitServlet 
 */ 
@WebServlet("/Log4JInitServlet") 
public class Log4JInitServlet extends HttpServlet { 
 private static final long serialVersionUID = 1L; 
  
 /** 
 * @see HttpServlet#HttpServlet() 
 */ 
 public Log4JInitServlet() { 
 super(); 
 // TODO Auto-generated constructor stub 
 } 
 
 /** 
 * @see Servlet#init(ServletConfig) 
 */ 
 public void init(ServletConfig config) throws ServletException { 
 System.out.println("Log4JInitServlet 正在初始化 log4j日志设置信息"); 
 String log4jLocation = config.getInitParameter("log4j-properties-location"); 
 
 ServletContext sc = config.getServletContext(); 
 
 if (log4jLocation == null) { 
  System.err.println("*** 没有 log4j-properties-location 初始化的文件, 所以使用 BasicConfigurator初始化"); 
  BasicConfigurator.configure(); 
 } else { 
  String webAppPath = sc.getRealPath("/"); 
  String log4jProp = webAppPath + log4jLocation; 
  File yoMamaYesThisSaysYoMama = new File(log4jProp); 
  if (yoMamaYesThisSaysYoMama.exists()) { 
  System.out.println("使用: " + log4jProp+"初始化日志设置信息"); 
  PropertyConfigurator.configure(log4jProp); 
  } else { 
  System.err.println("*** " + log4jProp + " 文件没有找到， 所以使用 BasicConfigurator初始化"); 
  BasicConfigurator.configure(); 
  } 
 } 
 super.init(config); 
 } 
 
 /** 
 * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response) 
 */ 
 protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { 
 // TODO Auto-generated method stub 
 } 
 
 /** 
 * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response) 
 */ 
 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { 
 // TODO Auto-generated method stub 
 } 
 
} 

调用日志Log4JTestServlet,java

import java.io.IOException; 
 
import javax.servlet.ServletConfig; 
import javax.servlet.ServletException; 
import javax.servlet.annotation.WebServlet; 
import javax.servlet.http.HttpServlet; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
 
import org.apache.log4j.Logger; 
 
/** 
 * Servlet implementation class Log4JTestServlet 
 */ 
@WebServlet("/Log4JTestServlet") 
public class Log4JTestServlet extends HttpServlet { 
 private static final long serialVersionUID = 1L; 
 private static Logger logger = Logger.getLogger(Log4JTestServlet.class); 
  
 /** 
 * @see HttpServlet#HttpServlet() 
 */ 
 public Log4JTestServlet() { 
 super(); 
 // TODO Auto-generated constructor stub 
 } 
 
 /** 
 * @see Servlet#init(ServletConfig) 
 */ 
 public void init(ServletConfig config) throws ServletException { 
 // TODO Auto-generated method stub 
 } 
 
 /** 
 * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response) 
 */ 
 protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { 
 // 记录debug级别的信息 
 logger.debug("This is debug message."); 
 // 记录info级别的信息 
 logger.info("This is info message."); 
 // 记录error级别的信息 
 logger.error("This is error message."); 
 } 
 
 /** 
 * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response) 
 */ 
 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { 
 doGet(request,response); 
 } 
 
} 

接下来就是运行了，来看看结果：

输出结果：

四、Spring中使用Log4j

这里要实现web项目中利用Spring来使用Log4j

（1）接上面的工程，然后再导入Spring的包
（2）web.xml增加

<!-- 设置根目录 --> 
 <context-param> 
 <param-name>webAppRootKey</param-name> 
 <param-value>webapp.root</param-value> 
 </context-param> 
 
 <context-param> 
 <param-name>log4jConfigLocation</param-name> 
 <param-value>/WEB-INF/classes/log4j.properties</param-value> 
</context-param> 
<!-- 3000表示 开一条watchdog线程每60秒扫描一下配置文件的变化;这样便于日志存放位置的改变 --> 
<context-param> 
 <param-name>log4jRefreshInterval</param-name> 
 <param-value>3000</param-value> 
 </context-param> 
<listener> 
 <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class> 
</listener> 

整个内容如下：

<?xml version="1.0" encoding="UTF-8"?> 
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xmlns="http://java.sun.com/xml/ns/javaee" 
 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" 
 id="WebApp_ID" version="3.0"> 
 <display-name>LogLearning</display-name> 
 
 <servlet> 
 <servlet-name>Log4JTestServlet</servlet-name> 
 <servlet-class>com.mucfc.Log4JTestServlet</servlet-class> 
 </servlet> 
 
 <!--用来启动 log4jConfigLocation的servlet --> 
<!-- <servlet> 
 <servlet-name>Log4JInitServlet</servlet-name> 
 <servlet-class>com.mucfc.Log4JInitServlet</servlet-class> 
 <init-param> 
  <param-name>log4j-properties-location</param-name> 
  <param-value>/WEB-INF/classes/log4j.properties</param-value> 
 </init-param> 
 <load-on-startup>1</load-on-startup> 
 </servlet>--> 
 
 <servlet-mapping> 
 <servlet-name>Log4JTestServlet</servlet-name> 
 <url-pattern>/test</url-pattern> 
 </servlet-mapping> 
 
 <!-- Spring 容器加载 --> 
 <listener> 
 <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> 
 </listener> 
 <context-param> 
 <param-name>contextConfigLocation</param-name> 
 <param-value>classpath:applicationContext.xml</param-value> 
 </context-param> 
 
 <!-- 设置根目录 --> 
 <context-param> 
 <param-name>webAppRootKey</param-name> 
 <param-value>webapp.root</param-value> 
 </context-param> 
 
 <context-param> 
 <param-name>log4jConfigLocation</param-name> 
 <param-value>/WEB-INF/classes/log4j.properties</param-value> 
 </context-param> 
 <!-- 3000表示 开一条watchdog线程每60秒扫描一下配置文件的变化;这样便于日志存放位置的改变 --> 
 <context-param> 
  <param-name>log4jRefreshInterval</param-name> 
  <param-value>3000</param-value> 
 </context-param> 
 <listener> 
 <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class> 
 </listener> 
 
</web-app> 

这里Log4JInitServlet.java就相当于没用到了。

（2）applicationContext.xml
没有内容：

<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" 
 xmlns:aop="http://www.springframework.org/schema/aop" 
 xsi:schemaLocation=" 
  http://www.springframework.org/schema/beans 
  http://www.springframework.org/schema/beans/spring-beans-3.2.xsd 
  http://www.springframework.org/schema/aop 
  http://www.springframework.org/schema/aop/spring-aop-3.2.xsd 
  http://www.springframework.org/schema/context 
  http://www.springframework.org/schema/context/spring-context-3.2.xsd"> 
</beans> 

（3）这样日志就跟随Spring窗口启动而启动了

程序一运行，就会自动把日志打印

log.log

error.log为空，因为它只打印error级别以上的信息

浏览器输入http://localhost:8080/LogLearning2/test

然后打开文件

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

# Log4j  # 教程  # Java中 log4j日志级别配置详解  # 浅谈在JAVA项目中LOG4J的使用  # 在Java下利用log4j记录日志的方法  # Log4j定时打印日志及添加模块名配置的Java代码实例  # Java日志软件Log4j的基本使用教程  # 深入浅析java web log4j 配置及在web项目中配置Log4j的技巧  # Java log4j详细教程  # java自定义日志输出文件(log4j日志文件输出多个自定义日志文件)  # 浅谈log4j 不打印异常堆栈  # 配置文件  # 记录器  # 应用程序  # 到低  # 在这里  # 多个  # 您可以  # 几种  # 中为  # 则应  # 新建一个  # 类目  # 打印出来  # 是一个  # 您的  # 加载  # 就会  # 是在  # 去了  # 也就 

相关文章： 如何在宝塔面板中修改默认建站目录？  javascript中对象的定义、使用以及对象和原型链操作小结  个人网站制作流程图片大全,个人网站如何注销？    个人摄影网站制作流程,摄影爱好者都去什么网站？  如何选择高效可靠的多用户建站源码资源？  网站专业制作公司,网站编辑是做什么的？好做吗？工作前景如何？  c++ stringstream用法详解_c++字符串与数字转换利器  如何快速上传自定义模板至建站之星？  手机网站制作平台,手机靓号代理商怎么制作属于自己的手机靓号网站？  网站企业制作流程,用什么语言做企业网站比较好？  如何高效完成独享虚拟主机建站？  如何做网站制作流程,*游戏网站怎么搭建？  网站制作公司排行榜,抖音怎样做个人官方网站  西安制作网站公司有哪些,西安货运司机用的最多的app或者网站是什么？  网站制作大概要多少钱一个,做一个平台网站大概多少钱？  如何在Golang中使用replace替换模块_指定本地或远程路径  香港服务器WordPress建站指南：SEO优化与高效部署策略  C#怎么创建控制台应用 C# Console App项目创建方法  建站之星会员如何解锁更多建站功能？  如何在阿里云通过域名搭建网站？  建站DNS解析失败？如何正确配置域名服务器？  微信网站制作公司有哪些,民生银行办理公司开户怎么在微信网页上查询进度？  如何通过老薛主机一键快速建站？  公司门户网站制作公司有哪些,怎样使用wordpress制作一个企业网站？  如何在腾讯云服务器快速搭建个人网站？  广州网站建站公司选择指南：建站流程与SEO优化关键词解析  宁波免费建站如何选择可靠模板与平台？  郑州企业网站制作公司,郑州招聘网站有哪些？  建站之星伪静态规则如何设置？  建站之星ASP如何实现CMS高效搭建与安全管理？  利用JavaScript实现拖拽改变元素大小  制作ppt免费网站有哪些,有哪些比较好的ppt模板下载网站？  黑客入侵网站服务器的常见手法有哪些？  XML的“混合内容”是什么 怎么用DTD或XSD定义  如何通过多用户协作模板快速搭建高效企业网站？  专业商城网站制作公司有哪些,pi商城官网是哪个？  韩国网站服务器搭建指南：VPS选购、域名解析与DNS配置推荐  如何访问已购建站主机并解决登录问题？  视频网站制作教程,怎么样制作优酷网的小视频？  小型网站制作HTML,*游戏网站怎么搭建？  C++中的Pimpl idiom是什么，有什么好处？（隐藏实现）  西安大型网站制作公司,西安招聘网站最好的是哪个？  建站之星云端配置指南：模板选择与SEO优化一键生成  枣阳网站制作,阳新火车站打的到仙岛湖多少钱？  黑客如何通过漏洞一步步攻陷网站服务器？  建站之星代理如何获取技术支持？  建站之星客服服务时间及联系方式如何？  建站上市公司网站建设方案与SEO优化服务定制指南  宝塔建站后网页无法访问如何解决？