log4j教程及相对路径设置

log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.encoding=UTF-8
log4j.appender.R.File=/home/bae/app/ROOT/log4j.log

Log4J的配置文件(Configuration File)就是用来设置记录器的级别、存放器和布局的，它可接key=value格式的设置或xml格式的设置信息。通过配置，可以创建出Log4J的运行环境。

1. 配置文件
Log4J配置文件的基本格式如下：

#配置根Logger
log4j.rootLogger = [ level ] , appenderName1 , appenderName2 ,  …

#配置日志信息输出目的地Appender
log4j.appender.appenderName =  fully.qualified.name.of.appender.class 
　　log4j.appender.appenderName.option1 =  value1 
　　… 
　　log4j.appender.appenderName.optionN =  valueN 

#配置日志信息的格式（布局）
log4j.appender.appenderName.layout =  fully.qualified.name.of.layout.class 
　　log4j.appender.appenderName.layout.option1 =  value1 
　　… 
　　log4j.appender.appenderName.layout.optionN = valueN

其中 [level] 是日志输出级别，共有5级：

FATAL       0 
ERROR     3 
WARN      4 
INFO         6 
DEBUG     7 

Appender  为日志输出目的地，Log4j提供的appender有以下几种：

org.apache.log4j.ConsoleAppender（控制台），
org.apache.log4j.FileAppender（文件），
org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件），
org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件），
org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）

Layout：日志输出格式，Log4j提供的layout有以下几种：

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平台为“\r\n”，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. 在代码中初始化Logger: 
1）在程序中调用BasicConfigurator.configure()方法：给根记录器增加一个ConsoleAppender，输出格式通过PatternLayout设为"%-4r [%t] %-5p %c %x - %m%n"，还有根记录器的默认级别是Level.DEBUG. 
2）配置放在文件里，通过命令行参数传递文件名字，通过PropertyConfigurator.configure(args[x])解析并配置；
3）配置放在文件里，通过环境变量传递文件名等信息，利用log4j默认的初始化过程解析并配置；
4）配置放在文件里，通过应用服务器配置传递文件名等信息，利用一个特殊的servlet来完成配置。

3. 为不同的 Appender 设置日志输出级别：
当调试系统时，我们往往注意的只是异常级别的日志输出，但是通常所有级别的输出都是放在一个文件里的，如果日志输出的级别是BUG！？那就慢慢去找吧。
这时我们也许会想要是能把异常信息单独输出到一个文件里该多好啊。当然可以，Log4j已经提供了这样的功能，我们只需要在配置中修改Appender的Threshold 就能实现,比如下面的例子：

[配置文件]

  ### 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 = %d{ABSOLUTE} %5p %c{ 1  }:%L - %m%n

### 输出到日志文件 ###
log4j.appender.D =  org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File =  logs/log.log
log4j.appender.D.Append =  true
log4j.appender.D.Threshold =  DEBUG ## 输出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.D =  org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File =  logs/error.log ## 异常日志文件名
log4j.appender.D.Append =  true
log4j.appender.D.Threshold =  ERROR ## 只输出ERROR级别以上的日志!!!
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

[代码中使用] 

 public class TestLog4j  {
    public static void main(String[] args)  {
        PropertyConfigurator.configure( " D:/Code/conf/log4j.properties "  );
        Logger logger = Logger.getLogger(TestLog4j. class  );
        logger.debug( " debug "  );
        logger.error( " error "  );
    } 
}

运行一下，看看异常信息是不是保存在了一个单独的文件error.log中。

在web.xml中配置如下：

<web-app>
 <servlet>
  <servlet-name>log4j</servlet-name>
  <servlet-class>com.apache.jakarta.log4j.Log4jInit</servlet-class>
  <init-param>
  <param-name>log4j</param-name>
  <param-value>/WEB-INF/log4j.properties</param-value>
  </init-param>  
  <load-on-startup>1</load-on-startup>
 </servlet>
</web-app>

jsp页面中加入：

<%@ page import="org.apache.commons.logging.Log,org.apache.commons.logging.LogFactory" %>

以DailyRollingFileAppender 为例：假设每天一个日志文件
有以下设置：

log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender 
log4j.appender.A1.File=app.log
log4j.appender.A1.DatePattern='.'yyyy-MM-dd
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%d %5p - %c -%-4r [%t]    - %m%n

此时生成日志文件将位于tomcat的bin目录下，如要将日志文件保存在 ：根目录/web-info/logs/下，个人有以下4种解决方案：
1 绝对路径
log4j.appender.A1.File=D:\apache-tomcat-6.0.18/webapps/项目/WEB-INF/logs/app.log
但这种写法灵活性很差

以下3中使用相同的设置原理： jvm的环境变量
 2：spring的Log4jConfigListener
通过以下配置：
<context-param>
    <param-name>webAppRootKey</param-name>
    <param-value>webApp.root</param-value>
  </context-param>
 <context-param>
  <param-name>log4jConfigLocation</param-name>
    <param-value>classpath:log4j.properties</param-value>
 </context-param>
<listener>  
     <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>  
 </listener>
...
log4j.appender.logfile.File=${webApp.root}/WEB-INF/logs/app.log
...
来解决
 3:使用已有jvm变量：
例如：
    log4j.appender.logfile.File=${user.home}/logs/app.log
  日志将位于：例如windows：C:\Documents and Settings\joe\logs\app.log

4 自己设置目录，也就是在项目启动时通过System.setProperty设置
通过实现ServletContextListener来解决：例如

public class log4jlistener implements ServletContextListener {

 public static final String log4jdirkey = "log4jdir";
 public void contextDestroyed(ServletContextEvent servletcontextevent) {
  System.getProperties().remove(log4jdirkey);

 }

 public void contextInitialized(ServletContextEvent servletcontextevent) {
  String log4jdir = servletcontextevent.getServletContext().getRealPath("/");
  //System.out.println("log4jdir:"+log4jdir);
  System.setProperty(log4jdirkey, log4jdir);

 }

}
web.xml配置：

<listener>
  <listener-class>com.log4j.log4jlistener</listener-class>
 </listener>

log4j.prtperties 配置：

log4j.appender.A1.File=${log4jdir}/WEB-INF/logs/app1.log

<!-- MaxFileSize是一个LOG文件的最大的文件大小，当LOG文件超过这个 

      值时，自动转成 *.log.1的LOG文件 --> 
<param name="MaxFileSize" value="500KB"/> 
<!-- MaxBackupIndex生成自动转成 *.log.1的LOG文件的个数，设置3时最多 

      生成3个LOG备份文件，它们是[*.log.1][*.log.2][*.log.3] --> 
<param name="MaxBackupIndex" value="2"/>