Servlet技术简介之 Servlet常用接口的使用

Servlet的类接口可以从以下几个方面进行分类。

●Servlet实现相关:  定义了用于实现Servlet相关的类和方法。

●Servlet配置相关:  主要包括ServletConfig接口。

●Servlet异常相关:  Servlet API有两个异常：ServletException 和 UnavailableException。

●请求和响应相关 :   用于接收客户端的请求，并且做出对应的响应

●会话跟踪         :   用于跟踪和客户端的会话。

●Servlet上下文  :   通过这个接口可以在多个web应用程序中共享数据。

●Servlet协作     :   主要是RequestDispatcher接口，用于进行视图派发。

●过滤               :  Cookie和HttpUtils类。

 

Ⅰ.Servlet实现相关

下面介绍和Servlet实现相关的类和接口。

1.Servlet

声明： public interface Servlet

这个接口是所有Servlet必须直接或间接实现的接口。它定义了以下方法。

●init（ServletConfig config）: 用于初始化Servlet。

●destroy（）: 销毁Servlet。

●getServletInfo :  获得Servlet的信息。

●getServletConfig：获得Servlet配置相关信息。

●Service（ServletRequest req，ServletResponse res）:  运行应用程序逻辑的入口点，它接收2个参数，ServletRequest 表示客户端请求信息。ServletResponse 表示对客户端的响应。

 

2.GenericServlet

声明：public abstract class GenericServlet implements Servlet,ServletConfig,java.io.Serializable

GenericServlet提供了对Servlet接口的基本实现。它是一个抽象类，它的service（）方法是一个抽象方法，GenericServlet的派生类必须直接或间接实现这个方法。

 

 

3.HttpServlet

声明:

public abstract class HttpServlet extends GenericServlet implements java.io.Serializable

HttpServlet类是针对使用Http协议的Web服务器的Servlet类。HttpServlet类通过执行Servlet接口，能够提供Http协议的功能。

 

HttpServlet的子类必须实现以下方法中的一个。

●doGet: 支持Http Get请求。

●doPost: 支持Http Post请求。

●doPut: 支持Http Put请求。

●doDelete: 支持Http Delete请求。

●init 和 destroy: 管理Servlet占用的资源。

●getServletInfo: 获得Servlet自身的信息。

 

 

Ⅱ.Servlet配置相关

javax.servlet.ServletConfig接口代表了Servlet的配置，Servlet的配置包括Servlet的名字，Servlet的初始化参数和Servlet上下文。

下图代表了一个Servlet的配置。

 

<servlet> <servlet-name>HelloWorld</servlet-name> <servlet-class>jp.co.xiehl.servlet.ch7.HelloWorldServlet</servlet-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>HelloWorld</servlet-name> <url-pattern>/hello</url-pattern> </servlet-mapping>

 

ServletConfig：

声明：public interface ServletConfig

主要方法如下：

●getInitParameter（String name）：返回特定名字的初始化参数。如上配置中getInitParameter（"encoding"）,那么将返回”UTF-8“字符串。

●getInitParameterNames（）：返回所有的初始化参数的名字。

●getServletContext（）：返回Servlet的上下文对象的引用。

 

Ⅲ．Servlet异常相关

1.ServletException

声明：public class ServletException extends Exception

它包含几个构造方法和一个获得异常原因的方法，这个方法如下：

getRootCause（）：返回造成这个异常的原因。

 

2.UnavailableException

声明：public class UnavailableException ServletException

当Servlet或者Filter暂时或永久不可用时，抛出该异常。

 

 

Ⅳ．请求和响应相关

主要有以下几种：

●ServletRequest:代表了Servlet的请求，它是一个高层接口，HttpServletRequest是它的子接口。

●ServletResponse:代表了Servlet的响应，它是一个高层接口，HttpServletResponse是它的子接口。

●ServletInputStream:Servlet的输入流。

●ServletOutputStream:Servlet的输出流。

●ServletRequestWrapper:它是ServletRequest的实现。

●ServletResponseWrapper:它是ServletResponse的实现。

 

●HttpServletRequest:代表了Http的请求，继承了ServletRequest接口。

●HttpServletResponse:代表了Http的响应，继承了ServletResponse接口。

●HttpServletRequestWrapper:它是HttpServletRequest的实现。

●HttpServletResponseWrapper:它是HttpServletResponse的实现。

 

 

 重点介绍HttpServletRequest和HttpServletResponse接口。

 

HttpServletRequest

这个接口中最常用的方法就是获得请求中的参数，这个参数是客户端表单中的数据。此接口可以获取客户端传送的阐述名称，也可以获取客户端正在使用的通信协议，可以获取远端主机名和其IP地址等。

 

一些重要方法：

getCookies（）：获得客户端发送的Cookie。

getSession（）：返回和客户端关联的Session，如果没有给客户端分配Session，返回null。

getSession（boolean create）：和上一方法类似，不同的是，如果没有给客户端分配，则创建一个新的Session并返回。

getParameter（String name）：获得请求中名为name的参数的值，如果没有该参数，返回null。

getParameterValues（String name）：获得请求中名为name的参数的值，这个值往往是checkbox或者select控件提交的，获得的值是一个String数组。

 

 

HttpServletResponse

声明：public interface HttpServletResponse extends ServletResponse

它代表了对客户端的响应。

常用方法：

addCookie（Cookie cookie）：在响应中增加一个Cookie。

encodeURL（String url）：使用url和一个SessionId重写这个URl。

sendRedirect（String location）：把响应发送到另一个页面或者servlet进行处理。

setContentType（String type）：设置响应的MIME类型。

setCharacterEncoding（String charset）：设置响应的字符编码类型。

 

 

Ⅴ．会话跟踪

和会话跟踪有关的类和接口有：HttpSession。

HttpSession

声明:public interface HttpSession

 

这个接口被Servlet引擎用来实现Http客户端和Http会话之间的关联。这种关联可能在多处连接和请求中持续一段给定的时间。Session用来在无状态的Http协议下越过多个请求页面来维持状态和识别用户。

一个Session可以通过Cookie或重写URl来维持。

 

常用方法：

getCreationTime（）：返回创建Session的时间。

getId（）：返回分配给这个Session的标识符。一个Http Session的标识符是一个有服务器来建立和维持的唯一的字符串。

getLastAccessedTime():返回客户端最后一次发出与这个Session有关的请求的时间，如果这个Session是新建立的就返回-1.

getMaxInactiveInterval（）：返回一个秒数，这个秒数表示客户端在不发出请求时，Session被Servlet引擎维持的最长时间。在这个时间之后，Session可能被Servlet引擎终止。如果这个Session不会被终止，则返回-1.

getValue（String name）：返回一个以给定名字绑定到Session上的对象。如果不存在这样的绑定，返回空值。

getValueNames（）：以一个数组返回绑定到Session上的所有数据的名称。

invalidate（）：这个方法会终止这个Session。所有绑定在Session上的数据都会被清除。

isNew():返回一个布尔值以判断这个Session是不是新的。如果一个Session已经被服务器建立但还没有收到相应的客户端的请求，这个Session将被认为是新的。这意味着，这个客户端还没有加入会话或没有被会话公认。在它发出下一个请求时还不能返回适当的Session认证信息。当Session无效后，在调用这个方法会抛出一个IllegalStateException异常。

putValue（String name，Object value）：以给定的名字绑定给定的对象到Session中。以存在的同名的绑定会被重置，这时会调用HttpSessionBindingListerer接口的valueBound方法。

removeValue（String name）：取消绑定。如果未找到给定名字的绑定什么也不做。这时会调用HttpSessionBindingListerer接口的valueBound方法。

setMaxInactiveInterval(int interval):设置一个秒数，表示客户端在不发出请求时，Session被Servlet引擎维持的最长时间。

 

Ⅵ．Servlet上下文

和servlet上下文相关的接口有ServletContext。

 

ServletContext

声明：public interface ServletContext

在服务器上使用Session对象来维持同单个客户相关的状态，而当为多个用户的web应用维持一个状态时，则应使用Servlet环境（Context）。

ServletContext对象表示一组Servlet共享的资源，在Servlet API的1.0和2.0中，ServletContext对象仅仅提供了访问有关Servlet环境信息的方法。例如提供了访问服务器名称，MIME类型映射等方法和可以将信息写入服务器日志文件的log（）方法。

常用方法：

●getAttribute（String name）：获得ServletContext中名称为name的属性。

●getAttribute（String uripath）：返回给定的uripath的应用的Servlet上下文。

●removeAttribute（String name）：删除ServletContext中名称为name的属性。

●setAttribute（String name，Object obj）：在ServletContext中设置一个属性。名称为name，值为obj。

 

 

 

Ⅶ．Servlet协作

Servlet协作主要是RequestDispatcher接口，它可以把一个请求转发到另一个Servlet。

声明：

public interface RequestDispatcher

 

它包含两个方法

forward（ServletRequest req，ServletResponse res）：把请求转发到服务器上的另一个资源（Servlet，Jsp，Html）。

include（ServletRequest req，ServletResponse res）：把服务器上的另一个资源（Servlet，Jsp，Html）包含到响应中。

 

Ⅷ．过滤

在web应用中实施过滤是我们常使用的技术，通过过滤，可以对请求进行统一编码，对请求进行认证等。每个Filter可能只担任很少的任务，多个Filter可以互相协作，通过这种协作，可以完成一个复杂的功能。

①Filter

声明：public interface Filter

它是Filter必须实现的接口，它包含以下方法。

●init（FilterConfig fc）：这个方法初始化Filter。

●doFilter(ServletRequest req,ServletResponse res,FilterChain chain):Filter的业务方法就在这里实现。

●destroy（）：释放Filter占用的资源。

 

②FilterChain

声明：public interface FilterChain

它是代码的过滤链，通过这个接口把过滤的任务在不同的Filter之间转移。

它包含了一个方法：

     doFileter（ServletRequest req,ServletResponse res）

通过这个方法来调用下一个Filter，如果没有下一个Filter，那么将调用目标的资源。

 

③FilterConfig

声明：public interface FilterConfig

代表了Filter的配置，和Servlet一样，Filter也有一些配置信息，比如Filter的名字和初始化参数等。

它包含了一下方法：

●getFilterName（）：返回Filter的名字。

●getInitParameter（String name）：获得名字为name的初始化参数。

●getServletContext（）：返回这个Filter所在的Servlet上下文对象。

●getInitParameterNames（）：获得Filter配置中的所有初始化参数的名字。