spring源码分析之spring-web http详解

spring-web是spring webmvc的基础，它的功能如下：

1. 封装http协议中client端/server端的request请求和response响应及格式的转换，如json，rss，xml等。

2. 远程调用包括jaxws、caucho、httpinvoker

3. web相关的accept/bind/client/context/filter/jsf/method/multipart

先从http协议中的封装来看：

先了解一下http的基础：(来自：http://blog.csdn.net/lxzo123/article/details/6708035 HTTP协议——请求格式及方法)

一、HTTP请求格式

当浏览器向Web服务器发出请求时，它向服务器传递了一个数据块，也就是请求信息，HTTP请求信息由3部分组成：

①　请求方法 URI 协议/版本

②　请求头(Request Header)

③　请求正文

下面是一个HTTP请求的例子：

GET/sample.Jsp HTTP/1.1

Accept:image/gif.image/jpeg,*/*

Accept-Language:zh-cn

Connection:Keep-Alive

Host:localhost

User-Agent:Mozila/4.0(compatible;MSIE5.01;Window NT5.0)

Accept-Encoding:gzip,deflate

username=jinqiao&password=1234

（1）请求方法URI协议/版本

请求的第一行是“方法URL协议版本”：GET/sample.jsp HTTP/1.1

以上代码中“GET”代表请求方法，“/sample.jsp”表示URI，“HTTP/1.1代表协议和协议的版本。

根据HTTP标准，HTTP请求可以使用多种请求方法。例如：HTTP1.1支持7种请求方法：GET、POST、HEAD、OPTIONS、PUT、DELETE和TARCE。在Internet应用中，最常用的方法是GET和POST。

URL完整地指定了要访问的网络资源，通常只要给出相对于服务器的根目录的相对目录即可，因此总是以“/”开头，最后，协议版本声明了通信过程中使用HTTP的版本。

（2）请求头(Request Header)

请求头包含许多有关的客户端环境和请求正文的有用信息。例如，请求头可以声明浏览器所用的语言，请求正文的长度等。

Accept:image/gif.image/jpeg.*/*

Accept-Language:zh-cn

Connection:Keep-Alive

Host:localhost

User-Agent:Mozila/4.0(compatible:MSIE5.01:Windows NT5.0)

Accept-Encoding:gzip,deflate.

（3）　请求正文

请求头和请求正文之间是一个空行，这个行非常重要，它表示请求头已经结束，接下来的是请求正文。请求正文中可以包含客户提交的查询字符串信息：

username=jinqiao&password=1234

在以上的例子的HTTP请求中，请求的正文只有一行内容。当然，在实际应用中，HTTP请求正文可以包含更多的内容。

四、HTTP请求方法：GET POST

1）GET方法

GET方法是默认的HTTP请求方法，我们日常用GET方法来提交表单数据，然而用GET方法提交的表单数据只经过了简单的编码，同时它将作为URL的一部分向Web服务器发送，因此，如果使用GET方法来提交表单数据就存在着安全隐患上。例如

Http://127.0.0.1/login.jsp?Name=zhangshi&Age=30&Submit=%cc%E+%BD%BB

从上面的URL请求中，很容易就可以辩认出表单提交的内容。（？之后的内容）另外由于GET方法提交的数据是作为URL请求的一部分所以提交的数据量不能太大

2)POST方法

POST方法是GET方法的一个替代方法，它主要是向Web服务器提交表单数据，尤其是大批量的数据。POST方法克服了GET方法的一些缺点。通过POST方法提交表单数据时，数据不是作为URL请求的一部分而是作为标准数据传送给Web服务器，这就克服了GET方法中的信息无法保密和数据量太小的缺点。因此，出于安全的考虑以及对用户隐私的尊重，通常表单提交时采用POST方法。

从编程的角度来讲，如果用户通过GET方法提交数据，则数据存放在QUERY＿STRING环境变量中，而POST方法提交的数据则可以从标准输入流中获取。

言归正传：

http基础
1. httpRequest继承自HttpMessage定义了http请求的基本格式：header、method、url，其中httpMethod定义了http协议的所有方法：

public enum HttpMethod {

    GET, POST, HEAD, OPTIONS, PUT, PATCH, DELETE, TRACE

}

2. responseEntity继承自httpEntity定义了http响应的格式：header、body、status，其中HttpStatus是个枚举类，定义了1xx、2xx、3xx、4xx、5xx的响应状态码

3. MediaType继承自MimeType，定义了可以接受的请求文件类型。

http client

1. ClientHttpRequest是客户端请求的接口，它的抽象类是AbstractClientHttpRequest；SimpleStreamingClientHttpRequest(使用jkd自带的功能执行流处理请求)、HttpComponentsStreamingClientHttpRequest(使用apache的components组件来处理请求)、AbstractBufferingClientHttpRequest（抽象buffer）继承自AbstractClientHttpRequest抽象类；BufferingClientHttpRequestWrapper（简单的ClientRequest实现）、HttpComponentsClientHttpRequest（apache components组件的请求处理实现）、SimpleBufferingClientHttpRequest（使用jdk自带功能的http请求处理实现）继承自抽象类AbstractBufferingClientHttpRequest。

从上面的图中可以清晰的看出clientHttpRequest的族谱关系及其实现类。

2. ClientHttpResponse是客户端响应的接口，BufferingClientHttpResponseWrapper是ClientHttpResponse的简单实现，它读取request的body到内存中，因此支持多次触发getBody（）方法；ClientHttpResponse的抽象类是AbstractClientHttpResponse;该抽象类有三个实现类，其中SimpleClientHttpResponse是使用jkd自带功能实现的，可以通过SimpleBufferingClientHttpRequest的execute()方法或者SimpleStreamingClientHttpRequest的execute()方法获取到该对象；HttpComponentsClientHttpResponse是使用apache components组件中HttpComponentsClientHttpRequest请求的返回对象；HttpComponentsAsyncClientHttpResponse是使用apache componets组件中HttpComponentsAsyncClientHttpRequest请求的返回对象。

3. 异步请求AsyncClientHttpRequest是接口，SimpleStreamingAsyncClientHttpRequest使用jdk自带功能实现的异步流处理请求，可以通过org.springframework.http.client.SimpleClientHttpRequestFactory的createRequest方法获取；AbstractBufferingAsyncClientHttpRequest是AsyncClientHttpRequest接口的抽象类，它在请求发送前将之缓存到一个byte数组中；SimpleBufferingAsyncClientHttpRequest是上述抽象类的实现类，它使用jkd自定的功能来执行缓存请求。可以通过org.springframework.http.client.SimpleClientHttpRequestFactory的createRequest方法获取该对象；

HttpComponentsAsyncClientHttpRequest是上述抽象类的实现类，它使用apache httpComponents组件的httpClient去执行request，该对象可以通过org.springframework.http.client.HttpComponentsClientHttpRequestFactory的createRequest方法去获取。

4. 异步响应HttpComponentsAsyncClientHttpResponse继承自AbstractClientHttpResponse抽象类，间接继承自ClientHttpResponse接口。

注意：请求request一般由请求工厂requestFactory来产生。

http server

1. ServletServerHttpRequest继承并实现了ServerHttpRequest接口，封装了HttpServletRequest，支持异步。

2. ServletServerHttpResponse继承并实现了ServerHttpResponse接口，封装了HttpServletResponse。

3. 异步的处理由ServletServerHttpAsyncRequestControl来完成，它继承并实现了ServerHttpAsyncRequestControl接口。它在response关闭前处理以异步方式处理httq请求。

http Converter

首先看一下它的层次结构图：

默认情况下，有如下一些HttpMessageConverter：

• ByteArrayHttpMessageConverter –  转换byte数组
• StringHttpMessageConverter – 转换string类型
• ResourceHttpMessageConverter – 转换任意类型的8位字节流到org.springframework.core.io.Resource
• SourceHttpMessageConverter – 转换 javax.xml.transform.Source
• FormHttpMessageConverter – 转换表单到/从MultiValueMap<String, String>类型.
• Jaxb2RootElementHttpMessageConverter – 转换java对象到/从xml格式(仅适用在classpath文件增加JAXB2 )
• MappingJackson2HttpMessageConverter – 转换JSON类型 (仅适用于clsspath中有jackson2)
  
• MappingJacksonHttpMessageConverter –转换JSON类型 (仅适用于clsspath中有jackson)
• AtomFeedHttpMessageConverter – 转换Atom feeds (仅适用于clsspath中有Rome)
• RssChannelHttpMessageConverter – 转换RSS feeds (仅适用于clsspath中有Rome)

小结：

spring-web是spring webmvc的基础，而spring-web的基础是spring-web http模块，它包含四个模块：

1. http 封装的基础如httpRequest、httpResponse、httpStatus、httpHeader等；

2. client端的request请求及响应；

3. server端的request请求及响应；

4. 格式的转换，如json，rss，xml等。

这个模块的学习可以结合http协议及servlet来学习，可以理解spring对http的封装是如何实现的。