org.picocontainer.web
Class PicoServletContainerListener

java.lang.Object
  org.picocontainer.web.PicoServletContainerListener

All Implemented Interfaces:

Serializable, EventListener, javax.servlet.http.HttpSessionListener, javax.servlet.ServletContextListener

Direct Known Subclasses:

SystemPropertiesPicoServletContainerListener

public class PicoServletContainerListener
extends Object
implements javax.servlet.ServletContextListener, javax.servlet.http.HttpSessionListener, Serializable

Servlet listener class that hooks into the underlying servlet container and instantiates, assembles, starts, stores and disposes the appropriate pico containers when applications/sessions start/stop.

To use, simply add as a listener to the web.xml the listener-class

 <listener>
  <listener-class>org.picocontainer.web.PicoServletContainerListener</listener-class>
 </listener> 
 

The listener also requires a the class name of the WebappComposer as a context-param in web.xml:

  <context-param>
   <param-name>webapp-composer-class</param-name>
   <param-value>com.company.MyWebappComposer</param-value>
  </context-param>
 

The composer will be used to compose the components for the different webapp scopes after the context has been initialised.

Author:

Joe Walnes, Aslak Hellesøy, Philipp Meier, Paul Hammant, Mauro Talevi, Konstantin Pribluda

See Also:

Serialized Form

Field Summary

static String

WEBAPP_COMPOSER_CLASS

Constructor Summary

PicoServletContainerListener()
Default constructor used in webapp containers

PicoServletContainerListener(org.picocontainer.DefaultPicoContainer applicationContainer, org.picocontainer.DefaultPicoContainer sessionContainer, org.picocontainer.DefaultPicoContainer requestContainer, org.picocontainer.behaviors.Storing sessionStoring, org.picocontainer.behaviors.Storing requestStoring)
Creates a PicoServletContainerListener with dependencies injected

Method Summary

protected void	compose(WebappComposer composer)
void	contextDestroyed(javax.servlet.ServletContextEvent event)
void	contextInitialized(javax.servlet.ServletContextEvent event)
protected WebappComposer	loadComposer(javax.servlet.ServletContext context)
protected org.picocontainer.PicoContainer	makeParentContainer()
void	sessionCreated(javax.servlet.http.HttpSessionEvent event)
void	sessionDestroyed(javax.servlet.http.HttpSessionEvent event)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

WEBAPP_COMPOSER_CLASS

public static final String WEBAPP_COMPOSER_CLASS

See Also:

Constant Field Values

Constructor Detail

PicoServletContainerListener

public PicoServletContainerListener()

Default constructor used in webapp containers

PicoServletContainerListener

public PicoServletContainerListener(org.picocontainer.DefaultPicoContainer applicationContainer,
                                    org.picocontainer.DefaultPicoContainer sessionContainer,
                                    org.picocontainer.DefaultPicoContainer requestContainer,
                                    org.picocontainer.behaviors.Storing sessionStoring,
                                    org.picocontainer.behaviors.Storing requestStoring)

Creates a PicoServletContainerListener with dependencies injected

Parameters:

applicationContainer - the application-scoped container

sessionContainer - the session-scoped container

requestContainer - the request-scoped container

sessionStoring - the session storing behaviour

requestStoring - the request storing behaviour

Method Detail

makeParentContainer

protected org.picocontainer.PicoContainer makeParentContainer()

contextInitialized

public void contextInitialized(javax.servlet.ServletContextEvent event)

Specified by:

contextInitialized in interface javax.servlet.ServletContextListener

loadComposer

protected WebappComposer loadComposer(javax.servlet.ServletContext context)

compose

protected void compose(WebappComposer composer)

contextDestroyed

public void contextDestroyed(javax.servlet.ServletContextEvent event)

Specified by:

contextDestroyed in interface javax.servlet.ServletContextListener

sessionCreated

public void sessionCreated(javax.servlet.http.HttpSessionEvent event)

Specified by:

sessionCreated in interface javax.servlet.http.HttpSessionListener

sessionDestroyed

public void sessionDestroyed(javax.servlet.http.HttpSessionEvent event)

Specified by:

sessionDestroyed in interface javax.servlet.http.HttpSessionListener