Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kklldog/agilehttp

An aglie http client .
https://github.com/kklldog/agilehttp

Last synced: 3 months ago
JSON representation

An aglie http client .

Awesome Lists containing this project

README 

        
# AgileHttp

An aglie http client .    

![Nuget](https://img.shields.io/nuget/v/AgileHttp?color=green) ![Nuget](https://img.shields.io/nuget/dt/Agilehttp?color=green)

## 依赖 

Newtonsoft.Json 12.0.3 

## 安装 

Install-Package AgileHttp 

## 示例 

### 使用HTTP.Send方法 

使用HTTP.Send / HTTP.SendAsync方法可以直接发送一个请求   

```

HTTP.Send("http://www.baidu.com") // 默认为Get方法 

HTTP.Send("http://www.baidu.com", "POST")  

HTTP.Send("http://www.baidu.com", "POST", new { name = "mjzhou" })  

HTTP.Send("http://www.baidu.com", "POST", new { name = "mjzhou" }, new RequestOptions { ContentType = "application/json" }) 



ResponseInfo response = HTTP.Send("http://localhost:5000/api/user/1");

string content = response.GetResponseContent(); //获取http响应返回值的文本内容

```

HTTP.SendAsync方法是HTTP.Send方法的异步版本   

### 使用HttpClient类    

如果不喜欢手写"GET","POST","PUT"等HTTP方法，可以是使用HttpClient类。HttpClient类内置了GET,POST,PUT,DELETE,OPTIONS几个常用的方法。   

```

var client = new HttpClient("http://www.baidu.com");

client.Get();//使用HttpClient发送Get请求



var client = new HttpClient("http://www.baidu.com");

client.Config(new RequestOptions { ContentType = "application/json" });

client.Post(new { name = "mjzhou" }); //使用HttpClient发送Post请求



ResponseInfo response = new HttpClient("http://localhost:5000/api/user/1").Get();

string content = response.GetResponseContent(); //获取http响应返回值的文本内容

User user1 = new HttpClient("http://localhost:5000/api/user/1").Get(); //泛型方法可以直接反序列化成对象。

```

Get,Post等方法都有异步版本GetAsync,PostAsync

### 使用扩展方法   

C#强大的扩展方法可以让写代码行云流水。AgileHttp提供了几个扩展方法，让使用更人性化。   

```

var result = "http://localhost:5000/api/user"

    .AppendQueryString("name", "kklldog")

    .AsHttpClient()

    .Get()

    .GetResponseContent();



var user = "http://localhost:5000/api/user"

    .AppendQueryString("name", "kklldog")

    .AsHttpClient()

    .Get();

```

1. String.AppendQueryString   

给一个字符串添加查询参数

```

"http://localhost:5000/api/user".AppendQueryString("name", "mjzhou") // 返回结果为"http://localhost:5000/api/user?name=mjzhou"

```

2. String.AppendQueryStrings   

给一个字符串添加多个查询参数

```

var qs = new Dictionary();

qs.Add("a", "1");

qs.Add("b", "2");

"http://localhost:5000/api/user".AppendQueryStrings(qs) // 返回结果为"http://localhost:5000/api/user?a=1&b=2"

```

3. String.AsHttp   

以当前字符串为URL创建一个HttpRequest

```

"http://www.baidu.com".AsHttp().Send(); //默认为Get

"http://localhost:5000/api/user".AsHttp("POST", new { name = "mjzhou" }).Send();

```

4. String.AsHttpClient   

以当前字符串为URL创建一个HttpClient

```

"http://www.baidu.com".AsHttpClient().Get();

"http://localhost:5000/api/user".AsHttpClient().Post(new { name = "mjzhou" });

```

5. ResponseInfo.Deserialize T    

ResponseInfo是请求结果的包装类，使用Deserialize方法可以直接反序列化成对象。如果没有配置RequestOptions则使用默认SerializeProvider。

```

HTTP.Send("http://www.baidu.com").Deserialize();

```

### RequestOptions    

使用RequestOptions可以对每个请求进行配置，比如设置ContentType，设置Headers，设置代理等等。   



| 属性 | 说明 |   

| ---- | ---- |   

| SerializeProvider | 获取序列化器 |   

| Encoding | 获取编码方式 |

| Headers | 获取或设置HttpHeaders |

| ContentType | 获取或设置Http ContentType属性 |

| Host | 获取或设置Http Host属性 |

| Connection | 获取或设置Http Connection属性 |

| UserAgent | 获取或设置Http UserAgent属性 | 

| Accept | 获取或设置Http Accept属性 |

| Referer | 获取或设置Http Referer属性 |

| Certificate | 获取或设置X509证书信息 |

| Proxy | 获取或设置代理信息 |

### 关于序列化/反序列化   

当你使用Post，Put（不限于这2个方法）方法提交一个对象的时候AgileHttp会自动就行序列化。使用泛型Get T, Post T方法会自动进行反序列化。默认使用JsonSerializeProvider来进行序列化及反序列化。JsonSerializeProvider使用著名的Newtonsoft.Json实现了ISerializeProvider接口，如果你喜欢你也可以自己实现自己的Provider，比如实现一个XMLSerializeProvider。

```

 public interface ISerializeProvider

  {

      T Deserialize(string content);

      string Serialize(object obj);

  }

```

AgileHttp提供2个地方来修改SerializeProvider：   

1. 通过RequestOptions为单个Http请求配置序列化器

```

var xmlSerializeProvider = new xmlSerializeProvider();

var client = new HttpClient("http://www.baidu.com");

client.Config(new RequestOptions(xmlSerializeProvider));

```

2. 通过HTTP.SetDefaultSerializeProvider(ISerializeProvider provider)更改全局默认序列化器

```

var xmlSerializeProvider = new xmlSerializeProvider();

HTTP.SetDefaultSerializeProvider(xmlSerializeProvider);

```

注意！：如果提交的body参数的类型为String或者byte[]不会进行再次序列化。