org.gatein.wci.spi

Interface WebAppContext

All Known Implementing Classes:

CatalinaWebAppContext, SimpleWebAppContext

public interface WebAppContext

A web application context.

Version:

$Revision: 1.1 $

Author:

Julien Viet

Method Summary

Modifier and Type	Method and Description
void	fireRequestDestroyed(javax.servlet.ServletRequest servletRequest)
void	fireRequestInitialized(javax.servlet.ServletRequest servletRequest)
ClassLoader	getClassLoader() Returns the class loader of the web application.
String	getContextPath() Returns the context path of the web application.
javax.servlet.http.HttpSession	getHttpSession(String sessId) Returns Http session in case that session with sessId exists for this web application
javax.servlet.ServletContext	getServletContext() Returns the servlet context of the web application.
boolean	importFile(String parentDirRelativePath, String name, InputStream source, boolean overwrite) Import a file in the war file.
void	start() Start the web application context usage from a client point of view.
void	stop() Stop the web application context usage.

Method Detail

start

void start()
    throws Exception

Start the web application context usage from a client point of view. The life cycle is not related to the web application deployment life cycle. The invocation means that the servlet container spi framework want to start to use the web application.

Throws:

Exception - any exception that would veto the usage of the web application

stop

void stop()

Stop the web application context usage.

getServletContext

javax.servlet.ServletContext getServletContext()

Returns the servlet context of the web application.

Returns:

the servlet context

getClassLoader

ClassLoader getClassLoader()

Returns the class loader of the web application.

Returns:

the web application class loader

getContextPath

String getContextPath()

Returns the context path of the web application.

Returns:

the web application context path

importFile

boolean importFile(String parentDirRelativePath,
                   String name,
                   InputStream source,
                   boolean overwrite)
            throws IOException

Import a file in the war file. The file could not be created for some reasons which are :

• The parent dir exists and is a file
• The parent dir does not exist and its creation failed
• An underlying exception occurs when writing bytes from the source Inputstream to the target OutputStream

Parameters:

parentDirRelativePath - the parent relative path in the web app starting from the app root

name - the name the created file should have

source - the data of the target file

overwrite - if false and the file already exists nothing is done

Returns:

true if the file has been created

Throws:

IOException - if the file cannot be created

getHttpSession

javax.servlet.http.HttpSession getHttpSession(String sessId)

Returns Http session in case that session with sessId exists for this web application

Parameters:

sessId -

Returns:

session with given ID or null if session with this ID doesn't exist

fireRequestInitialized

void fireRequestInitialized(javax.servlet.ServletRequest servletRequest)

fireRequestDestroyed

void fireRequestDestroyed(javax.servlet.ServletRequest servletRequest)