Class GenericServlet
- All Implemented Interfaces:
Serializable,Servlet,ServletConfig
- Direct Known Subclasses:
HttpServlet
HttpServlet instead.
GenericServlet implements the Servlet and ServletConfig interfaces.
GenericServlet may be directly extended by a servlet, although it's more common to extend a
protocol-specific subclass such as HttpServlet.
GenericServlet makes writing servlets easier. It provides simple versions of the lifecycle methods
init and destroy and of the methods in the ServletConfig interface.
GenericServlet also implements the log method, declared in the ServletContext
interface.
To write a generic servlet, you need only override the abstract service method.
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoiddestroy()Called by the servlet container to indicate to a servlet that the servlet is being taken out of service.getInitParameter(String name) Returns aStringcontaining the value of the named initialization parameter, ornullif the parameter does not exist.Returns the names of the servlet's initialization parameters as anEnumerationofStringobjects, or an emptyEnumerationif the servlet has no initialization parameters.Returns this servlet'sServletConfigobject.Returns a reference to theServletContextin which this servlet is running.Returns information about the servlet, such as author, version, and copyright.Returns the name of this servlet instance.voidinit()A convenience method which can be overridden so that there's no need to callsuper.init(config).voidinit(ServletConfig config) Called by the servlet container to indicate to a servlet that the servlet is being placed into service.voidWrites the specified message to a servlet log file, prepended by the servlet's name.voidWrites an explanatory message and a stack trace for a givenThrowableexception to the servlet log file, prepended by the servlet's name.abstract voidservice(ServletRequest req, ServletResponse res) Called by the servlet container to allow the servlet to respond to a request.
-
Constructor Details
-
GenericServlet
public GenericServlet()Does nothing. All of the servlet initialization is done by one of theinitmethods.
-
-
Method Details
-
destroy
public void destroy()Called by the servlet container to indicate to a servlet that the servlet is being taken out of service. SeeServlet.destroy(). -
getInitParameter
Returns aStringcontaining the value of the named initialization parameter, ornullif the parameter does not exist. SeeServletConfig.getInitParameter(java.lang.String).This method is supplied for convenience. It gets the value of the named parameter from the servlet's
ServletConfigobject.- Specified by:
getInitParameterin interfaceServletConfig- Parameters:
name- aStringspecifying the name of the initialization parameter- Returns:
- String a
Stringcontaining the value of the initialization parameter
-
getInitParameterNames
Returns the names of the servlet's initialization parameters as anEnumerationofStringobjects, or an emptyEnumerationif the servlet has no initialization parameters. SeeServletConfig.getInitParameterNames().This method is supplied for convenience. It gets the parameter names from the servlet's
ServletConfigobject.- Specified by:
getInitParameterNamesin interfaceServletConfig- Returns:
- Enumeration an enumeration of
Stringobjects containing the names of the servlet's initialization parameters
-
getServletConfig
Returns this servlet'sServletConfigobject.- Specified by:
getServletConfigin interfaceServlet- Returns:
- ServletConfig the
ServletConfigobject that initialized this servlet - See Also:
-
getServletContext
Returns a reference to theServletContextin which this servlet is running. SeeServletConfig.getServletContext().This method is supplied for convenience. It gets the context from the servlet's
ServletConfigobject.- Specified by:
getServletContextin interfaceServletConfig- Returns:
- ServletContext the
ServletContextobject passed to this servlet by theinitmethod - See Also:
-
getServletInfo
Returns information about the servlet, such as author, version, and copyright. By default, this method returns an empty string. Override this method to have it return a meaningful value. SeeServlet.getServletInfo().- Specified by:
getServletInfoin interfaceServlet- Returns:
- String information about this servlet, by default an empty string
-
init
Called by the servlet container to indicate to a servlet that the servlet is being placed into service. SeeServlet.init(javax.servlet.ServletConfig).This implementation stores the
ServletConfigobject it receives from the servlet container for later use. When overriding this form of the method, callsuper.init(config).- Specified by:
initin interfaceServlet- Parameters:
config- theServletConfigobject that contains configuration information for this servlet- Throws:
ServletException- if an exception occurs that interrupts the servlet's normal operation- See Also:
-
init
A convenience method which can be overridden so that there's no need to callsuper.init(config).Instead of overriding
init(ServletConfig), simply override this method and it will be called byGenericServlet.init(ServletConfig config). TheServletConfigobject can still be retrieved viagetServletConfig().- Throws:
ServletException- if an exception occurs that interrupts the servlet's normal operation
-
log
Writes the specified message to a servlet log file, prepended by the servlet's name. SeeServletContext.log(String).- Parameters:
message- aStringspecifying the message to be written to the log file
-
log
Writes an explanatory message and a stack trace for a givenThrowableexception to the servlet log file, prepended by the servlet's name. SeeServletContext.log(String, Throwable).- Parameters:
message- aStringthat describes the error or exceptiont- thejava.lang.Throwableerror or exception
-
service
public abstract void service(ServletRequest req, ServletResponse res) throws ServletException, IOException Called by the servlet container to allow the servlet to respond to a request. SeeServlet.service(javax.servlet.ServletRequest, javax.servlet.ServletResponse).This method is declared abstract so subclasses, such as
HttpServlet, must override it.- Specified by:
servicein interfaceServlet- Parameters:
req- theServletRequestobject that contains the client's requestres- theServletResponseobject that will contain the servlet's response- Throws:
ServletException- if an exception occurs that interferes with the servlet's normal operation occurredIOException- if an input or output exception occurs
-
getServletName
Returns the name of this servlet instance. SeeServletConfig.getServletName().- Specified by:
getServletNamein interfaceServletConfig- Returns:
- the name of this servlet instance
-