EasyHttp 技术文档

2024-12-23 20:58:52作者：虞亚竹Luna

1. 安装指南

EasyHttp 是一个简单易用的 HTTP 客户端，支持多种 HTTP 方法、Cookies、认证等功能。以下是安装指南：

下载源码编译：您可以从 GitHub 下载 EasyHttp 的源码，然后进行编译。
使用 NuGet 安装：推荐使用 NuGet 包管理器进行安装。您可以在 NuGet.org 上找到 EasyHttp 包。在 NuGet 包管理器中执行以下命令：
```
Install-Package EasyHttp
```

2. 项目使用说明

EasyHttp 支持静态类型和动态类型的 HTTP 请求。以下是使用说明：

使用静态类型

发送 POST/PUT 请求

var customer = new Customer(); 
customer.Name = "Joe"; 
customer.Email = "joe@smith.com";
var http = new HttpClient();
http.Post("url", customer, HttpContentTypes.ApplicationJson);

发送 GET 请求并解析 JSON 响应

var http = new HttpClient();
http.Request.Accept = HttpContentTypes.ApplicationJson;
var response = http.Get("url");
var customer = response.StaticBody<Customer>();
Console.WriteLine("Name: {0}", customer.Name);

使用动态类型

发送 POST/PUT 请求

var customer = new ExpandoObject(); // 或任何动态类型
customer.Name = "Joe";
customer.Email = "joe@smith.com";
var http = new HttpClient();
http.Post("url", customer, HttpContentTypes.ApplicationJson);

发送 GET 请求并解析 JSON 响应

var http = new HttpClient();
http.Request.Accept = HttpContentTypes.ApplicationJson;
var response = http.Get("url");
var customer = response.DynamicBody;
Console.WriteLine("Name {0}", customer.Name);

两种类型都支持层级结构。

3. 项目 API 使用文档

以下是 EasyHttp 的一些常用 API：

Get 方法：发送 GET 请求。
```
http.Get("url");
```
Post 方法：发送 POST 请求。
```
http.Post("url", data);
```
Put 方法：发送 PUT 请求。
```
http.Put("url", data);
```
Delete 方法：发送 DELETE 请求。
```
http.Delete("url");
```
Head 方法：发送 HEAD 请求。
```
http.Head("url");
```
GetWithParams 方法：发送带参数的 GET 请求。
```
http.Get("url", parameters);
```
SetCookies 方法：设置 Cookies。
```
http.SetCookies(cookies);
```
SetAuthentication 方法：设置认证信息。
```
http.SetAuthentication(authentication);
```