public final class FacesServlet
extends java.lang.Object
implements javax.servlet.Servlet
FacesServlet is a servlet that manages the request processing lifecycle for web applications that are utilizing JavaServer Faces to construct the user interface.
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
CONFIG_FILES_ATTR
Context initialization parameter name for a comma delimited list
of context-relative resource paths (in addition to
/WEB-INF/faces-config.xml which is loaded automatically
if it exists) containing JavaServer Faces configuration information. |
static java.lang.String |
LIFECYCLE_ID_ATTR
Context initialization parameter name for the lifecycle identifier
of the
Lifecycle instance to be utilized. |
Constructor and Description |
---|
FacesServlet() |
Modifier and Type | Method and Description |
---|---|
void |
destroy()
Release all resources acquired at startup time.
|
javax.servlet.ServletConfig |
getServletConfig()
Return the
ServletConfig instance for this servlet. |
java.lang.String |
getServletInfo()
Return information about this Servlet.
|
void |
init(javax.servlet.ServletConfig servletConfig)
Acquire the factory instances we will require.
|
void |
service(javax.servlet.ServletRequest request,
javax.servlet.ServletResponse response)
Process an incoming request, and create the corresponding
response, by executing the request processing lifecycle.
|
public static final java.lang.String CONFIG_FILES_ATTR
Context initialization parameter name for a comma delimited list
of context-relative resource paths (in addition to
/WEB-INF/faces-config.xml
which is loaded automatically
if it exists) containing JavaServer Faces configuration information.
public static final java.lang.String LIFECYCLE_ID_ATTR
Context initialization parameter name for the lifecycle identifier
of the Lifecycle
instance to be utilized.
public void destroy()
Release all resources acquired at startup time.
destroy
in interface javax.servlet.Servlet
public javax.servlet.ServletConfig getServletConfig()
Return the ServletConfig
instance for this servlet.
getServletConfig
in interface javax.servlet.Servlet
public java.lang.String getServletInfo()
Return information about this Servlet.
getServletInfo
in interface javax.servlet.Servlet
public void init(javax.servlet.ServletConfig servletConfig) throws javax.servlet.ServletException
Acquire the factory instances we will require.
init
in interface javax.servlet.Servlet
javax.servlet.ServletException
- if, for any reason, the startup of
this Faces application failed. This includes errors in the
config file that is parsed before or during the processing of
this init()
method.public void service(javax.servlet.ServletRequest request, javax.servlet.ServletResponse response) throws java.io.IOException, javax.servlet.ServletException
Process an incoming request, and create the corresponding response, by executing the request processing lifecycle.
If the request
and response
arguments to this method are not instances of
HttpServletRequest
and
HttpServletResponse
, respectively, the results of
invoking this method are undefined.
This method must respond to requests that start with the
following strings by invoking the sendError
method
on the response argument (cast to
HttpServletResponse
), passing the code
HttpServletResponse.SC_NOT_FOUND
as the
argument.
/WEB-INF/
/WEB-INF
/META-INF/
/META-INF
service
in interface javax.servlet.Servlet
request
- The servlet request we are processingresponse
- The servlet response we are creatingjava.io.IOException
- if an input/output error occurs during processingjavax.servlet.ServletException
- if a servlet error occurs during processingCopyright ? 2002-2006 Sun Microsystems, Inc. All Rights Reserved.