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









-










猜你喜欢

转载自lixh1986.iteye.com/blog/2324239