Interface Log4jWebLifeCycle

All Superinterfaces:

LifeCycle, Log4jWebSupport

All Known Implementing Classes:

Log4jWebInitializerImpl

interface Log4jWebLifeCycle
extends Log4jWebSupport, LifeCycle

Specifies an interface for initializing and deinitializing Log4j in a Java EE web application. The default and only implementation is Log4jWebInitializerImpl. The initializer is based on an interface to improve testability. The methods here are contained in a package-private sub-interface because general application code should not have access to them.

Nested Class Summary

Nested classes/interfaces inherited from interface LifeCycle

LifeCycle.State

Field Summary

Fields inherited from interface Log4jWebSupport

CONTEXT_ATTRIBUTE, IS_LOG4J_AUTO_INITIALIZATION_DISABLED, IS_LOG4J_AUTO_SHUTDOWN_DISABLED, IS_LOG4J_CONTEXT_SELECTOR_NAMED, LOG4J_CONFIG_LOCATION, LOG4J_CONTEXT_NAME, SUPPORT_ATTRIBUTE

Method Summary

Modifier and Type	Method	Description
void	start()	Starts up Log4j in the web application.
void	stop()	Shuts down Log4j in the web application.

Methods inherited from interface LifeCycle

getState, initialize, isStarted, isStopped

Methods inherited from interface Log4jWebSupport

clearLoggerContext, setLoggerContext, wrapExecution

Method Details

start

void start()

Starts up Log4j in the web application. Calls Log4jWebSupport.setLoggerContext() after initialization is complete.

Specified by:

start in interface LifeCycle

Throws:

IllegalStateException - if a JNDI config location is specified but no name is specified.

stop

void stop()

Shuts down Log4j in the web application. Calls Log4jWebSupport.clearLoggerContext() immediately before deinitialization begins.

Specified by:

stop in interface LifeCycle