com.ibm.websphere.servlet.event
Interface ServletContextEventSource


public interface ServletContextEventSource

This event context is used to register listeners for various servlet context events. These events will be triggered by the servlet engine as appropriate during servlet processing. An implementation of this event context is available to all servlets as a ServletContext attribute by using the ServletContext.getAttribute() method.

Sample Usage (from within a servlet):

 ServletContextEventSource sces = (ServletContextEventSource)getServletContext().getAttribute(
                                 ServletContextEventSource.ATTRIBUTE_NAME);
 sces.addServletErrorListener(myErrorListener);
 


Field Summary
static java.lang.String ATTRIBUTE_NAME
          The ServletContext attribute name that the servlet context event source can be retrieved using.
 
Method Summary
 void addApplicationListener(ApplicationListener al)
          Register a listener for application events.
 void addServletErrorListener(ServletErrorListener sel)
          Register a listener for servlet error events.
 void addServletInvocationListener(ServletInvocationListener sil)
          Register a listener for servlet invocation events.
 void addServletListener(ServletListener sl)
          Register a listener for servlet events.
 void removeApplicationListener(ApplicationListener al)
          Deregister a listener for application events.
 void removeServletErrorListener(ServletErrorListener sel)
          Deregister a listener for servlet error events.
 void removeServletInvocationListener(ServletInvocationListener sil)
          Deregister a listener for servlet invocation events.
 void removeServletListener(ServletListener sl)
          Deregister a listener for servlet events.
 

Field Detail

ATTRIBUTE_NAME

public static final java.lang.String ATTRIBUTE_NAME
The ServletContext attribute name that the servlet context event source can be retrieved using.
Method Detail

addApplicationListener

public void addApplicationListener(ApplicationListener al)
Register a listener for application events.

removeApplicationListener

public void removeApplicationListener(ApplicationListener al)
Deregister a listener for application events.

addServletInvocationListener

public void addServletInvocationListener(ServletInvocationListener sil)
Register a listener for servlet invocation events.

removeServletInvocationListener

public void removeServletInvocationListener(ServletInvocationListener sil)
Deregister a listener for servlet invocation events.

addServletErrorListener

public void addServletErrorListener(ServletErrorListener sel)
Register a listener for servlet error events.

removeServletErrorListener

public void removeServletErrorListener(ServletErrorListener sel)
Deregister a listener for servlet error events.

addServletListener

public void addServletListener(ServletListener sl)
Register a listener for servlet events.

removeServletListener

public void removeServletListener(ServletListener sl)
Deregister a listener for servlet events.