General Actions:
Container Module
Last modified by Thomas Mortagne on 2012/02/22 15:09
 | Provides an abstraction of a Container (request, response, session) |
| Type | JAR |
| Developed by | |
| License | GNU Lesser General Public License 2.1 |
| Bundled With | XWiki Enterprise, XWiki Enterprise Manager |
Table of contents
Description
The notion of Container complements the notion of Environment by adding the notions of Request, Response and Session.
Similarly to the Environment, the idea is to allow using XWiki libraries that require a Container to be executed transparently in various environments such as a Servlet environment, a Portlet environment and more.
To get access to the Container implementation you'd use the following in your code:
@Inject
private Container container;
private Container container;
This will allow you to access the following API:
public interface Container
{
/**
* @deprecated starting with 3.5M1, use the notion of Environment instead
*/
@Deprecated
ApplicationContext getApplicationContext();
/**
* @deprecated starting with 3.5M1, use the notion of Environment instead
*/
@Deprecated
void setApplicationContext(ApplicationContext context);
Request getRequest();
void setRequest(Request request);
void removeRequest();
void pushRequest(Request request);
void popRequest();
Response getResponse();
void setResponse(Response response);
void removeResponse();
void pushResponse(Response response);
void popResponse();
Session getSession();
void setSession(Session session);
void removeSession();
void pushSession(Session session);
void popSession();
}
{
/**
* @deprecated starting with 3.5M1, use the notion of Environment instead
*/
@Deprecated
ApplicationContext getApplicationContext();
/**
* @deprecated starting with 3.5M1, use the notion of Environment instead
*/
@Deprecated
void setApplicationContext(ApplicationContext context);
Request getRequest();
void setRequest(Request request);
void removeRequest();
void pushRequest(Request request);
void popRequest();
Response getResponse();
void setResponse(Response response);
void removeResponse();
void pushResponse(Response response);
void popResponse();
Session getSession();
void setSession(Session session);
void removeSession();
void pushSession(Session session);
void popSession();
}
Container Initialization
It's up to the environment in which the XWiki code runs to initialize the Container component. For the Servlet Container we provide, this is done in XWikiServletContextListener which is a Servlet Listener that needs to be registered in your web.xml as follows:
<listener>
<listener-class>org.xwiki.container.servlet.XWikiServletContextListener</listener-class>
</listener>
<listener-class>org.xwiki.container.servlet.XWikiServletContextListener</listener-class>
</listener>