上一篇对FSLib.Network库进行了简单的介绍和演示。从本篇开始介绍相关的使用。

1.基本运行机制介绍

FSLib.Network.Http 命名空间下的类是本网络库中用于HTTP处理的相关类型集中存放的地方。由于类库是基于HttpWebRequest以及HttpWebResponse的，所以很多行为表现和逻辑和它们几乎保持一致。

在此基础之上，本类库进行了抽象和总结，并提炼出一整套流程和运行框架。以下分别介绍。

2.相关模型介绍

2.1 HttpClient

HttpClient是开始HTTP处理请求的工厂。它是用来维护、创建、跟踪HTTP请求的一个基本类。可以理解为它是一个容器，维护了所有的Cookies以及全局设置，然后通过它可以创建出不同的HTTP请求实例。

HttpClient的类视图如下。

这其中，Create方法是最为重要的方法。它提供了两个重载，用于创建所有的HttpContext上下文。

下面的方法几乎都是用来支撑它的辅助方法。相关的事件也是全局性的事件，也就是说，只要是通过这个HttpClient实例创建出的HttpContext，也会引发这里的事件。一般用于全局性处理。

2.2 IHttpHandler

IHttpHandler是用于创建相关对象（如HttpContext、HttpWebRequest、HttpWebResponse）的工厂对象，同时也负责一些逻辑性操作（如解析具体地址、解析Cookies等）。

它定义了一个接口，而本类库里已经提供了一个默认实现，大部分情况下够用。如果需要自定义，可以自己完整实现 IHttpHandler接口，或继承默认实现的HttpHandler并改写。

相关类视图如下。

要使用自己的HttpHandler，在新建HttpClient的时候直接传递新的5对象即可，如下所示。

new HttpClient(new HttpSetting(), new HttpHandler());

2.3 HttpSetting

HttpSetting对象为HttpClient所用，用于保存HTTP相关的各项设置。默认情况下，HttpClient有自己默认的HttpSetting实例，一般也够用。如果需要显式设置，可通过在之前章节中类似的方法设置。

HttpSetting类视图如下。

HttpSetting提供的设置都是默认设置。一些内容（如请求头等）可以在相关的请求中直接改写。

2.4 HttpRequestMessage/HttpResponseMessage

HttpRequestMessage/HttpResponseMessage是将HTTP请求/响应的相关信息（如请求头、请求方式、地址、数据、状态码、标头、ContentType等等）进行封装后的数据类，HttpContext使用它来保存所有和请求或响应相关的内容。

由于这两个类包含成员过多，而且大多都是比较直接的数据存储属性，在此不展示视图。

2.5 HttpRequestContent

当使用POST或PUT等方法发送请求时，往往Request有正文，需要发送一定的数据。而HttpRequestContent即是用来承载实际发送数据的一个数据类。

HttpRequestContent本身是个抽象类，根据实际发送的数据不同，需要使用不同的具象类来执行实际的任务。在本类库中，其相关的类视图如下：

类库已经内置了大部分用于发送数据的具象类，一般可以直接使用。如果有新增的必要，则可以自定义自己的承载类型。已经内置的操作类如下表所示（加粗行为常用类）。

2.7 HttpResponseContent

每一个请求都会收到服务器发回的响应，HttpResponseContent即是用来存储实际服务器发来数据并进行转换操作的数据类。

HttpResponseContent本身是个抽象类，只规定了数据接收操作的定义，实际的数据类需要另外实现。本库内置七个常用的数据存储类，相关视图如下。

如果以上类型均不符合需求，可以另外编写。内置类的详细说明如下表所示（加粗的为常用类）。

2.8 HttpContext

HttpContext是请求上下文，维护着一个HTTP请求的完整逻辑以及与之相关的数据和状态。它是最终请求的实际执行单元。

请求可以通过Send()、SendAsync()或SendTask() 来执行，执行的结果不一样，分别是同步执行（阻塞线程）、异步执行（事件通知）以及任务执行。

同时，它负责所有的相关逻辑，如Cookies处理、状态维护、事件通知等。

HttpContext拥有一个强类型的泛型版本 HttpContext<T>，此类型的泛型参数声明了期望的返回结果类型。当服务器返回错误或网络出现错误时，结果可能不能正确返回，此时需要访问 HttpContext.ResponseContent 来获得对应的错误对象。

由于此类型成员过多，在此不做展示。

3.使用模型介绍

这里介绍的是一个通用的创建请求对象的流程。

3.1 创建客户端

直接用new方法创建一个新的客户端。

var client = new HttpClient();

3.2 创建请求上下文

使用 client.Create() 函数创建一个新的HttpContext。

var context = client.Create<string>(HttpMethod.Get, "http://www.baidu.com/");

此函数有大量的参数可供选择，其中绝大部分是可选参数（optional），只有地址(url)和请求方法(method)是必须的。此函数原型如下。

		/// <summary>
		/// 创建网络请求
		/// </summary>
		/// <param name="url">请求地址</param>
		/// <param name="method">方法</param>
		/// <param name="data">写入的数据</param>
		/// <param name="refer">引用页</param>
		/// <param name="saveToFile">保存文件地址</param>
		/// <param name="streamInvoker">流读取对象，仅当返回结果为流时可用</param>
		/// <param name="async">是否是异步发送</param>
		/// <param name="result">预先设置结果类型</param>
		/// <param name="isXhr">是否增加AJAX请求头标记</param>
		/// <param name="contextData">关联的上下文数据</param>
		/// <param name="payloadType">设置当发送对象类型时，设置发送类型。不设置或传递null值将会自动判断</param>
		/// <typeparam name="TResult">结果类型</typeparam>
		/// <returns></returns>
		public HttpContext<TResult> Create<TResult>(
			HttpMethod method,
			string url,
			string refer = null,
			object data = null,
			TResult result = null,
			string saveToFile = null,
			Action<Stream> streamInvoker = null,
			bool async = false,
			bool isXhr = false,
			Dictionary<string, object> contextData = null,
			WebHeaderCollection headers = null,
			RequestPayloadType? payloadType = null,
			bool allowAutoRedirect = false
			) where TResult : class
		{
		}

通过此函数的可选参数，可以直接设置是否是异步发送、是否添加XmlHttpRequest头、上下文数据、引用页、需要定义的请求头等等。

值得一提的是ContextData。每个请求（HttpContext）都附带了一个字典类型的上下文数据（Dictionary<string, object>）用来保存额外的与请求相关的数据。

在此设置的值只是第一步，在之后请求发送之前可以修改。通过此函数创建后，对应的HttpContext状态为未发送，可进行额外的二次设置。设置完成后，通过Send（或相关）方法将其发送出去。 

3.3 发送请求并等待结果

在HttpContext发送之后，可以通过Send相关方法发送出去。

Send有三种模式：Send()， SendAsync()，SendTask()，区别和联系如下。

3.4 错误处理

本类库的原则是摒弃用try...catch来捕捉错误。

当请求完成后，HttpContext有 IsSuccess 属性来表示当前的请求是否成功（成功的标准是请求状态码<400）。

除此以外，还有 IsValid() 扩展方法用来辅助判断是否成功，此方法除了会判断 IsSuccess属性之外，还会额外判断返回的具体对象是否为空。

如果响应失败，那么可以通过 HttpContext.ResponseContent 获得此时的服务器响应。

4.扩展

4.1 扩展HttpHandler

默认的HttpHandler提供了IHttpHandler的默认实现，但是可以继承它并扩展。可以进行的操作包含但不局限于装饰相关流、自定义处理HttpWebRequest、自定义处理HttpContext、验证请求等。

4.2 扩展HttpClient

一般来说不需要处理。如果有特异化的需求，可以继承它，并重写相关方法，或添加自己的方法。

4.3 使用事件

使用异步模式时，必须通过相关事件来获得结果。通过事件也可以获得更详细的HTTP请求结果。

4.4 Cookies相关设置

默认情况下，Cookies是自动处理的，策略是全部维护。此默认行为可以修改，可以通过HttpSetting修改全局设置，或通过HttpContext的Request.CookiesHandleMethod来针对请求进行设置。

可设置的范围是：全部忽略；仅发送不接收；默认处理（发送并接收）。

其它内容请参见 原创FSLib.Network库（目前专注于HTTP的高性能高易用性网络库）。

感谢阅读本文，欢迎扫描下方二维码关注鱼的公众号（微信内长按识别哦）