因为Servlet常用的版本有两个,即2.5与3.0。要在web application中使用Log4j2,还需要加入log4j-web的jar包。log4j通过web.xml中的context参数log4jConfiguration来查找配置文件。如果没有的话,那么会在WEB-INF目录下查找以“log4j2”开头命名的xml文件。如果不止一个log4j2开头的文件,那么会优先使用log4j2-name命名的文件,name为项目名称。否则会使用第一个文件。
log4j2能够在Servlet3.0下正常使用且不用配置。因为在Servlet3.0的API中加入了ServletContainerInitializer,它自动启动了Filter和ServletContextListener(这两个类在Servlet2.5中需要配置)。官方文档有一个注意事项:
Important Note! For performance reasons, containers often ignore certain JARs known not to
contain TLDs or ServletContainerInitializers and do not scan them for web-fragments andinitializers. Importantly, Tomcat 7 <7.0.43 ignores all JAR files named log4j*.jar, which prevents thisfeature from working. This has been fixed in Tomcat 7.0.43, Tomcat 8, and later. In Tomcat 7 <7.0.43you will need to change catalina.properties and remove "log4j*.jar" from the jarsToSkip property. You may need to do something similar on other containers if they skip scanning Log4j JAR files.
在tomcat版本小于7.0.43的时候,需要修改catalina.properties文件的 jarToSkip配置,把“log4j*.jar”去掉。
如果你不想让log4j2自动启动,那么可以配置isLog4jAutoInitializationDisabled参数。
12 isLog4jAutoInitializationDisabled 3true 4
在Servlet2.5中,需要我们自己配置filter和Listener。配置规则如下:
12 5org.apache.logging.log4j.web.Log4jServletContextListener 3 46 9log4jServletFilter 7org.apache.logging.log4j.web.Log4jServletFilter 810 log4jServletFilter 11/* 12REQUEST 13FORWARD 14INCLUDE 15ERROR 16ASYNC
以上两种情况都允许自定义context parameters。有3个参数可供配置:
isLog4jContextSelectorNamed:布尔类型配置,由它选择是否使用JndiContextSelector。如果它设为true的话,那么log4jContextName一定要配置或者在web.xml中指定display-name。并且log4jConfiguration也要配置一个URL,这个URL是log4j2的配置文件地址,但这个不是必须要配置的。
log4jContextName:配置display-name。
log4jConfiguration:log4j配置文件的路径。
示例如下:
12 isLog4jContextSelectorNamed 3true 4
12 log4jContextName 3myApplication 4
12 log4jConfiguration 3file:///etc/myApp/myLogging.xml 4
这里的log4jConfiguration可以写绝对地址,也可以写相对地址。