The Spring Framework

Class Log4jConfigServlet

  extended by javax.servlet.GenericServlet
      extended by javax.servlet.http.HttpServlet
          extended by org.springframework.web.util.Log4jConfigServlet
All Implemented Interfaces:
Serializable, Servlet, ServletConfig

public class Log4jConfigServlet
extends HttpServlet

Bootstrap servlet for custom Log4J initialization in a web environment. Delegates to Log4jWebConfigurer (see its javadoc for configuration details). WARNING: Assumes an expanded WAR file, both for loading the configuration file and for writing the log files. If you want to keep your WAR unexpanded or don't need application-specific log files within the WAR directory, don't use Log4J setup within the application (thus, don't use Log4jConfigListener or Log4jConfigServlet). Instead, use a global, VM-wide Log4J setup (for example, in JBoss) or JDK 1.4's java.util.logging (which is global too).

Note: This servlet should have a lower load-on-startup value in web.xml than ContextLoaderServlet, when using custom Log4J initialization.

Note that this class has been deprecated for containers implementing Servlet API 2.4 or higher, in favor of Log4jConfigListener.
According to Servlet 2.4, listeners must be initialized before load-on-startup servlets. Many Servlet 2.3 containers already enforce this behavior (see ContextLoaderServlet javadocs for details). If you use such a container, this servlet can be replaced with Log4jConfigListener. Else or if working with a Servlet 2.2 container, stick with this servlet.

Juergen Hoeller, Darren Davison
See Also:
Log4jWebConfigurer, Log4jConfigListener, ContextLoaderServlet, Serialized Form

Constructor Summary
Method Summary
 void destroy()
 String getServletInfo()
 void init()
 void service(HttpServletRequest request, HttpServletResponse response)
          This should never even be called since no mapping to this servlet should ever be created in web.xml.
Methods inherited from class javax.servlet.http.HttpServlet
doDelete, doGet, doHead, doOptions, doPost, doPut, doTrace, getLastModified, service
Methods inherited from class javax.servlet.GenericServlet
getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletName, init, log, log
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail


public Log4jConfigServlet()
Method Detail


public void init()
init in class GenericServlet


public void destroy()
Specified by:
destroy in interface Servlet
destroy in class GenericServlet


public void service(HttpServletRequest request,
                    HttpServletResponse response)
             throws IOException
This should never even be called since no mapping to this servlet should ever be created in web.xml. That's why a correctly invoked Servlet 2.3 listener is much more appropriate for initialization work ;-)

service in class HttpServlet


public String getServletInfo()
Specified by:
getServletInfo in interface Servlet
getServletInfo in class GenericServlet

The Spring Framework

Copyright © 2002-2007 The Spring Framework.