javax.faces.webapp
Class FacesServlet

java.lang.Object
  javax.faces.webapp.FacesServlet

All Implemented Interfaces:

Servlet

public final class FacesServlet

extends java.lang.Object

implements Servlet

FacesServlet is a servlet that manages the request processing lifecycle for web applications that are utilizing JavaServer Faces to construct the user interface.

This servlet recognizes the following context initialization parameters:

• javax.faces.lifecycle.LIFECYCLE_ID - Lifecycle identifier of the Lifecycle instance to be used when processing JSF requests in this web application. If not specified, the default instance, identified by LifecycleFactory.DEFAULT_LIFECYCLE, will be used.

Constructor Summary

FacesServlet()

Method Summary

void	destroy() Release all resources acquired at startup time.
ServletConfig	getServletConfig() Return the ServletConfig instance for this servlet.
java.lang.String	getServletInfo() Return information about this Servlet.
void	init(ServletConfig servletConfig) Acquire the factory instances we will require.
void	service(ServletRequest request, ServletResponse response) Process an incoming request, and create the corresponding response, by executing the request processing lifecycle.

Methods inherited from class java.lang.Object

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

Constructor Detail

FacesServlet

public FacesServlet()

Method Detail

destroy

public void destroy()

Release all resources acquired at startup time.

Specified by:

destroy in interface Servlet

getServletConfig

public ServletConfig getServletConfig()

Return the ServletConfig instance for this servlet.

Specified by:

getServletConfig in interface Servlet

Returns:

the ServletConfig object that initializes this servlet

See Also:

Servlet.init(javax.servlet.ServletConfig)

getServletInfo

public java.lang.String getServletInfo()

Return information about this Servlet.

Specified by:

getServletInfo in interface Servlet

Returns:

a String containing servlet information

init

public void init(ServletConfig servletConfig)
          throws ServletException

Acquire the factory instances we will require.

Specified by:

init in interface Servlet

Parameters:

servletConfig - a ServletConfig object containing the servlet's configuration and initialization parameters

Throws:

ServletException - if an exception has occurred that interferes with the servlet's normal operation

See Also:

UnavailableException, Servlet.getServletConfig()

service

public void service(ServletRequest request,
                    ServletResponse response)
             throws java.io.IOException,
                    ServletException

Process an incoming request, and create the corresponding response, by executing the request processing lifecycle.

Specified by:

service in interface Servlet

Parameters:

request - The servlet request we are processing

response - The servlet response we are creating

Throws:

java.io.IOException - if an input/output error occurs during processing

ServletException - if a servlet error occurs during processing