Servlet之Servlet API

一、在哪里

Java Servlet 中所有用的类和接口都位于这两个包下：

    1、javax.servlet
    2、javax.servlet.http

前者包含了支持通用的、不依赖某个具体协议的类和接口。
后者继承扩展了 javax.servlet 包中的类，包含只针对 http 协议的类和接口的实现（理论上还支持其它协议的实现，http协议只是其中一种）。

包名使用 javax 开头而不是 java。   x 表示：extention （ex发音：x）意为：扩展
表明 servlet 不属于 Java Standard Edition（Java SE），
而是属于 Java Enterprise Edition（Java EE）


使用 servlet 时，需要引用类库： servlet-api.jar
可以到 oracle 或 maven 的网站上去找相应版本的类库。


二、 javax.servlet.Servlet 接口

每一个 servlet 类必须实现 javax.servlet.Servlet 接口。


Java为我们提供了两个部分实现了 javax.servlet.Servlet 接口的类，我们只需要继承它们其中之一即可：

    1、javax.servlet.GenericServlet
    2、javax.servlet.http.HttpServlet

照例，
前者是通用的、不依赖于某个具体协议
后者是专门用于http协议的对 servlet 的实现


三、Servlet 是如何运行的

1、servlet 是什么
不像一般可以直接运行的具有 main() 方法的 Java 程序，
servlet 没有 main() 方法，像一个没有图形界面的 Java Applet。

2、servlet 的主要方法：service()
servlet 不能独立运行，servlet 依赖于 web 容器执行。
当有请求到达 web 容器时，web 容器会调用 servlet 中的特定的方法： service()
来完成相应的操作。

3、service() 方法的参数
service() 方法有两个参数对象：一个代表请求，一个是代表响应。
这两个对象由 web 容器在请求到来时创建，并在调用 service() 方法时，传递进来。

请求对象：
     包含了与请求相关的信息和对应方法，如请求头、请求类型（get, post）、请求参数、请求编码等

响应对象：
     包含了与响应相关的信息和对应方法，如响应内容，响应内容的类型，响应内容的编码等。


4、说明
前面提到过，要写一个 servlet ，需要继承两个类中的任意一个：

    1、javax.servlet.GenericServlet
    2、javax.servlet.http.HttpServlet

如果继承了前者，只需要重写其 service() 方法即可。
如果继承了后者，当然也可以只重写其 service() 方法。但是，它还提供了针对请求类型的方法：doGet()，doPost()。


javax.servlet.http.HttpServlet 源码分析

    在javax.servlet.http.HttpServlet.java 源码中可以看到，在其 service() 方法中，先获取请求的类型（req.getMethod()），然后根据不同的请求类型（get,post,update,delete），调用自己相应的方法（doGet(),doPost(),...）。而这些方法可能已经被我们重写。
    所以也可以直接重写其 service() 方法，以处理所有类型的请求。




四、其它类

在 javax.servlet 和 javax.servlet.http 包下其它的类大部分都是辅助类。

例如：

1、
ServletRequest, ServletResponse 接口：
HttpServletRequest, HttpServletResponse 接口：提供了代表请求和响应的对象类。

2、
HttpSession 接口：提供了对 session 的跟踪和管理。

3、
Cookie 类：提供了对 Http Cookie 的创建和处理。

4、
ServletRequestWrapper, ServletResponseWrapper 类：
HttpServletRequestWrapper, HttpServletResponseWrapper 类： 允许开发者对 web 容器要生成的请求对象类和响应对象类进行重写，添加某些逻辑。例如：设置请求对象的参数编码。（需要继承该类，然后借助 Filter 实现 ）

// wrapper class
public class EnCodingRequestWrapper extends HttpServletRequestWrapper {   
  
    private String charset = "UTF-8";   
  
    public EnCodingRequestWrapper(HttpServletRequest request) {   
        super(request);   
    }   
    public EnCodingRequestWrapper(HttpServletRequest request, 
                                  String charset){            
        super(request);   
        this.charset = charset;   
    }   
  
    // override its getParameter() method.
    @override
    public String getParameter(String name) {   
        String value = super.getParameter(name);   
        value = value == null ? null : convert(value);   
        return value;   
    }   
  
    private String convert(String target) {   
        System.out.println("before convert: " + target);   
        try {   
            return new String(target.trim().getBytes("ISO-8859-1"), charset);   
        } catch (UnsupportedEncodingException e) {   
            return target;   
        }   
    }   
  
} 


// filter class
public class ContentTypeFilter implements Filter {   
  
    private String charset = "UTF-8";  // default
   
    @override   
    public void init(FilterConfig config) throws ServletException {
        String charset = config.getServletContext().getInitParameter("charset");     
        if( charset != null && charset.trim().length() != 0){           
            this.charset = charset;   
        }   
    }   
        
        
    @override
    public void doFilter(ServletRequest request, ServletResponse response,   
                FilterChain chain) throws IOException, ServletException {
        // set character encoding for request, response objects in the filter.
        request.setCharacterEncoding(charset);   
        response.setCharacterEncoding(charset);
        
        // if the request type is "GET", 
        // then replace the request object with our wrapped one.
        HttpServletRequest req = (HttpServletRequest)request;
        if(req.getMethod().equalsIgnoreCase("GET")){
            req = new EnCodingRequestWrapper(req,charset);   
        }   
        
        // pass the request, response objects to next filter.
        System.out.println("Request is filtered by: " 
                            + config.getFilterName()); 
        chain.doFilter(req, response);
        System.out.println("Response is filtered by: " 
                            + config.getFilterName()); 
      
    }
}

/*

<context-param>  
    <param-name>charset</param-name>  
    <param-value>UTF-8</param-value>  
</context-param>  

<filter>  
    <filter-name>ContentTypeFilter</filter-name>  
    <filter-class>filter.ContentTypeFilter</filter-class>  
</filter>  

<filter-mapping>  
    <filter-name>ContentTypeFilter</filter-name>  
    <url-pattern>/*</url-pattern>  
</filter-mapping> 

*/

引用：
http://docstore.mik.ua/orelly/java-ent/servlet/ch02_02.htm
http://www.oracle.com/technetwork/java/index-jsp-135475.html





-
转载请注明
原文出处：http://lixh1986.iteye.com/blog/2324239









-