[转]如何初始化 Java Web 应用程序的 log4j

原文:http://www.codejava.net/coding/how-to-initialize-log4j-for-java-web-application

---

通常，对于Java Web应用程序，我们可以将log4j.properties文件或log4j.xml文件放在类路径（WEB-INF \ classes目录）的根目录下，在servlet类中立即使用log4j，如下所示：

Logger logger = Logger.getLogger(MyServlet.class);
logger.debug("this is a debug log message");

但是，如果将log4j配置文件放在另一个位置而不是类路径的根目录下呢？在这种情况下，我们需要明确地初始化log4j：

String log4jConfigFile = "some/path/log4j.properties";
PropertyConfigurator.configure(log4jConfigFile);

但是，当应用程序启动时，这个初始化代码只能执行一次。为此，建议声明ServletContextListener接口的实现，以监听在应用程序启动时发生的contextInitialized（）事件，然后再提供客户端的请求。例如：

public class ContextListener implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent event) {
        // code to initialize log4j here...
    }
}

以下是在Java Web应用程序中初始化和使用log4j的步骤：

1.创建log4j属性文件

创建一个名为log4j.properties的log4j配置文件，其中包含以下内容：

# LOG4J configuration
log4j.rootLogger=DEBUG, Appender1,Appender2

log4j.appender.Appender1=org.apache.log4j.ConsoleAppender
log4j.appender.Appender1.layout=org.apache.log4j.PatternLayout
log4j.appender.Appender1.layout.ConversionPattern=%-7p %d [%t] %c %x - %m%n

log4j.appender.Appender2=org.apache.log4j.FileAppender
log4j.appender.Appender2.File=D:/Logs/Log4jWebDemo.log
log4j.appender.Appender2.layout=org.apache.log4j.PatternLayout
log4j.appender.Appender2.layout.ConversionPattern=%-7p %d [%t] %c %x - %m%n

此配置基本上创建两个appender：第一个用于控制台日志记录，第二个用于文件记录（日志文件将在D：/Logs/Log4jWebDemo.log下创建）。
将log4j.properties文件放在Web应用程序的WEB-INF目录下。

2.在web.xml中配置log4j属性文件的位置

还建议通过web.xml文件配置log4j.properties文件的位置，如下所示：

    
    Log4jWebDemo1
    
    
        log4j-config-location
        WEB-INF/log4j.properties
    
    

这里我们在WEB-INF目录下配置log4j.properties文件。

3.实现ServletContextListener接口

创建一个使用以下代码实现ServletContextListener接口的ContextListener类：

package net.codejava.servlet;

import java.io.File;

import javax.servlet.ServletContext;
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.annotation.WebListener;

import org.apache.log4j.PropertyConfigurator;

@WebListener("application context listener")
public class ContextListener implements ServletContextListener {

    /**
     * Initialize log4j when the application is being started
     */
    @Override
    public void contextInitialized(ServletContextEvent event) {
        // initialize log4j here
        ServletContext context = event.getServletContext();
        String log4jConfigFile = context.getInitParameter("log4j-config-location");
        String fullPath = context.getRealPath("") + File.separator + log4jConfigFile;
        
        PropertyConfigurator.configure(fullPath);
        
    }
    
    @Override
    public void contextDestroyed(ServletContextEvent event) {
        // do nothing
    }   
}

在contextInitialized（）方法中，我们读取log4j属性文件的位置，并构造一个完整的绝对路径，然后传递给PropertyConfigurator类的静态configure（）方法。这就是log4j用给定的属性文件初始化。
请注意，@WebListener注释（Servlet 3.0）放置在类声明之前，以告知servlet容器将此类注册为侦听器。如果您使用Servlet 2.5，请在web.xml文件中使用以下等效的XML ：

    net.codejava.servlet.ContextListener

4.写一个测试servlet

现在创建一个简单的servlet来测试log4j。创建一个包含以下内容的TestLog4jServlet.java类：

package net.codejava.servlet;
 
import java.io.IOException;
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;
 
@WebServlet("/test")
public class TestLog4jServlet extends HttpServlet {
 
    static final Logger LOGGER = Logger.getLogger(TestLog4jServlet.class);
             
    protected void doGet(HttpServletRequest request,
            HttpServletResponse response) throws ServletException, IOException {
         
        LOGGER.info("This is a logging statement from log4j");
         
        String html = "
Log4j has been initialized successfully!
";
        response.getWriter().println(html);
    }
 
}

这个servlet只是将一个日志条目写入记录器，并向客户端发送一个简短的HTML文本。
由于我们使用@WebServlet注解（Servlet 3.0），因此无需在web.xml文件中配置此servlet 。如果您使用Servlet 2.5，请将以下XML代码段添加到web.xml文件中：

    TestServlet
    TestServlet
    net.codejava.servlet.TestLog4jServlet

 

    TestServlet
    /test

5.测试应用程序

如果您在Eclipse IDE中执行了上述步骤，您将具有以下项目结构：

记住在WEB-INF \ lib目录下添加log4j的库jar文件（可以在这里下载log4j ），并创建一个目录D：/ Logs，其中将创建一个日志文件（在log4j.properties文件中配置）。

在Tomcat等servlet容器上部署应用程序，在浏览器的地址栏中输入以下URL来测试servlet和log4j：
HTTP：//本地主机：8080 / Log4jWebDemo1 /测试

在浏览器中输出：

看看服务器的控制台日志，我们将看到一个log4j样式的日志条目，如下所示：

并检查Log4jWebDemo.log文件将在D：/ Logs目录下创建（您应该首先创建此目录）。