开源.NetCore通用工具库Xmtool使用连载 - HTTP请求篇

开源,netcore,通用,工具,xmtool,使用,连载,http,请求 · 浏览次数 : 230

小编点评

**内容生成步骤** 1. **获取HttpSecurity对象**:`HttpSecurity security = Xmtool.Web.Security();` 2. **接收HTTP请求返回结果**:`HttpResponseExt resp = client.Get(\"https://www.ceshi.com/person/1\");` 3. **提取响应码**:`int statusCode = resp.Headers.ContainsKey("user");` 4. **提取响应头信息**:`string header = resp.Headers.ContainsKey("Content-Type");` 5. **提取响应内容**:`string content = resp.GetContent();` 6. **验证响应内容格式**:`if (content.Length > 0 && !content.startsWith("application/json")) { throw new Exception("响应内容格式错误"); }` 7. **解析 JSON格式的内容**:`if (content.Length > 0 && content.startsWith("application/json")) { jsonContent = content.Substring(1); } else { jsonContent = null; }` 8. **处理响应结果**:根据不同的格式,进行处理和输出。例如,响应码可能包含用户名称,响应头可能包含响应内容格式,响应内容可能包含JSON格式的内容。 **示例代码** ```csharp // 获取HttpSecurity对象 HttpSecurity security = Xmtool.Web.Security(); // 接收HTTP请求返回结果 HttpResponseExt resp = client.Get("https://www.ceshi.com/person/1"); // 提取响应码 int statusCode = resp.Headers.ContainsKey("user"); // 提取响应头信息 string header = resp.Headers.ContainsKey("Content-Type"); // 提取响应内容 string content = resp.GetContent(); // 验证响应内容格式 if (content.Length > 0 && !content.startsWith("application/json")) { throw new Exception("响应内容格式错误"); } // 解析 JSON格式的内容 if (content.Length > 0 && content.startsWith("application/json")) { jsonContent = content.Substring(1); } else { jsonContent = null; } // 处理响应结果 Console.WriteLine(jsonContent); ``` **注意** * 以上代码仅展示了基本示例,实际代码中可能需要根据具体需求进行修改。 * 请确保使用正确的 HTTP 请求方法和格式。 * 数据安全可能需要进行特殊处理,例如验证 JSON 格式的内容。

正文

【Github源码】


《上一篇》 介绍了Xmtool工具库中的XML操作类库,今天我们继续为大家介绍其中的HTTP请求类库。

在现如今的软件需求场景中,HTTP网络请求几乎是开发过程中必然会使用的功能;而系统自带的HTTPClient对象使用起来并不是那么容易和友好,因此我们对其进行了二次封装成了一个Web类库。
该Web类库提供了HTTP请求和HTTP安全相关两方面的封装。HTTP请求是基于系统自带的HttpClient对象进行了二次封装,提供了更易用的方法,并且对Json类型更加友好;HTTP安全方面主要针对XSS攻击提供了字符处理方法,后续会根据需要不断添加。


HTTP请求

使用HTTP请求,首选需要获取HttpClientExt对象:

HttpClientExt client = Xmtool.Web.Client();
// 或者
HttpClientExt client = Xmtool.Web.Client("microservice-1");

根据获取Client时传入的参数不同,系统将返回不同的实例;但对相同的参数会做单例处理,也就是说相同的参数将获取到同一个实例;当不传入任何参数时,每次都会返回一个全新的实例。

根据HTTP常用请求场景类库提供了各种属性和方法:

Timeout属性

BaseAddress属性

AddDefaultHeader方法

AddRequestHeader方法

AddRequestHeaderWithoutValidation方法

SetContent方法

SetJsonContent方法

SetJsonContent方法二

Clear方法

Get方法

GetAsync方法

Post方法

PostAsync方法

Put方法

PutAsync方法

Delete方法

DeleteAsync方法

Patch方法

PatchAsync方法

Head方法

HeadAsync方法

Options方法

OptionsAsync方法

1. Timeout属性

说明:用来设置或获取HTTP请求的超时时间。

2. BaseAddress属性

说明: 用来设置或获取HTTP请求的基本地址,在后续使用相对地址发送请求时会使用该地址进行拼接。

3. AddDefaultHeader方法

public HttpClientExt AddDefaultHeader(string name, string value)
说明:为HTTP请求设置请求头信息,该头信息会在实例每次发起请求时携带。
参数:

name:请求头名称。

value:请求头内容。

HttpClientExt client = Xmtool.Web.Client();
client.AddDefaultHeader("User", "admin");

4. AddRequestHeader方法

public HttpClientExt AddRequestHeader(string name, string value)
说明:为HTTP请求设置请求头信息,该头信息仅会在实例下一次发起请求时携带。
参数:

name:请求头名称。

value:请求头内容。

5. AddRequestHeaderWithoutValidation方法

public HttpClientExt AddRequestHeaderWithoutValidation(string name, string value)
说明:为HTTP请求设置请求头信息,该头信息仅会在实例下一次发起请求时携带;该方法和AddRequestHeader的区别是不会对参数的合法性进行检查。
参数:

name:请求头名称。

value:请求头内容。

6. SetContent方法

public HttpClientExt SetContent(string content)
说明:为下一次HTTP请求(主要是提交类请求,如Post)设置提交内容。
参数:

content:请求提交内容。

HttpClientExt client = Xmtool.Web.Client();
client.SetContnent("Good Day");
// TODO

7. SetJsonContent方法

public HttpClientExt SetJsonContent(string content)
说明:为下一次请求设置提交内容,必须是JSON格式。
参数:

content:请求提交内容,JSON格式。

HttpClientExt client = Xmtool.Web.Client();
client.SetJsonContnent("{\"Author\": \"softwaiter\"}");
// TODO

8. SetJsonContent方法二

public HttpClientExt SetJsonContent(DynamicObjectExt obj)
说明:通过动态对象为下一次请求设置JSON格式的提交内容。
参数:

obj:要提交的动态对象。

DynamicObjectExt obj = new DynamicObjectExt();
obj.Author = "softwaier";

HttpClientExt client = Xmtool.Web.Client();
client.SetJsonContnent(obj);
// TODO

9. Clear方法

public HttpClientExt Clear()
说明:清除仅在下一次请求中生效的提交内容和请求头信息。

10. Get方法

public HttpResponseExt Get(string requestUri)
说明:以Get方式发起一个HTTP请求。
参数:

requestUri:HTTP请求地址,可以是相对地址或绝对地址;如果是相对地址将使用BaseAddress进行拼接。

HttpClientExt client = Xmtool.Web.Client();
HttpResponseExt rep = client.Get("https://www.baidu.com");
// TODO

11. GetAsync方法

public async Task<HttpResponseExt> GetAsync(string requestUri)
说明:Get方法的异步版本。

12. Post方法

public HttpResponseExt Post(string requestUri)
说明:以Post方式发起一个HTTP请求。
参数:

requestUri:HTTP请求地址,可以是相对地址或绝对地址;如果是相对地址将使用BaseAddress进行拼接。

// 新增一条人员信息
HttpClientExt client = Xmtool.Web.Client();
HttpResponseExt rep = client.SetJsonContent("{\"user\": \"admin", \"password\": \"Admin123\"}")
    .Post("https://www.ceshi.com/person");
// TODO

13. PostAsync方法

public async Task<HttpResponseExt> PostAsync(string requestUri)
说明:Post方法的异步版本。

14. Put方法

public HttpResponseExt Put(string requestUri)
说明:以Put方式发起一个HTTP请求。
参数:

requestUri:HTTP请求地址,可以是相对地址或绝对地址;如果是相对地址将使用BaseAddress进行拼接。

// 修改Id为1的人员住址
HttpClientExt client = Xmtool.Web.Client();
HttpResponseExt rep = client.SetJsonContent("{\"address\": \"BeiJing\"}")
    .Put("https://www.ceshi.com/person/1");
// TODO

15. PutAsync方法

public async Task<HttpResponseExt> PutAsync(string requestUri)
说明:Put方法的异步版本。

16. Delete方法

public HttpResponseExt Delete(string requestUri)
说明:以Delete方式发起一个HTTP请求。
参数:

requestUri:HTTP请求地址,可以是相对地址或绝对地址;如果是相对地址将使用BaseAddress进行拼接。

// 删除Id为1的人员信息
HttpClientExt client = Xmtool.Web.Client();
HttpResponseExt rep = client.Delete("https://www.ceshi.com/person/1");
// TODO

17. DeleteAsync方法

public async Task<HttpResponseExt> DeleteAsync(string requestUri)
说明:Delete方法的异步版本。

18. Patch方法

public HttpResponseExt Patch(string requestUri)
说明:以Patch方式发起一个HTTP请求。
参数:

requestUri:HTTP请求地址,可以是相对地址或绝对地址;如果是相对地址将使用BaseAddress进行拼接。

// 修改Id为1的人员信息
HttpClientExt client = Xmtool.Web.Client();
HttpResponseExt rep = client.SetJsonContent("{\"name\":\"wangxm\", \"age\": 18}")
    .Delete("https://www.ceshi.com/person/1");
// TODO

19. PatchAsync方法

public async Task<HttpResponseExt> PatchAsync(string requestUri)
说明:Patch方法的异步版本。

20. Head方法

public HttpResponseExt Head(string requestUri)
说明:以Head方式发起一个HTTP请求。
参数:

requestUri:HTTP请求地址,可以是相对地址或绝对地址;如果是相对地址将使用BaseAddress进行拼接。

21. HeadAsync方法

public async Task<HttpResponseExt> HeadAsync(string requestUri)
说明:Head方法的异步版本。

22. Options方法

public HttpResponseExt Options(string requestUri)
说明:以Options方式发起一个HTTP请求。
参数:

requestUri:HTTP请求地址,可以是相对地址或绝对地址;如果是相对地址将使用BaseAddress进行拼接。

23. OptionsAsync方法

public async Task<HttpResponseExt> OptionsAsync(string requestUri)
说明:Options方法的异步版本。

HTTP安全

HTTP安全在类库中目前仅提供了一个应对XSS攻击的处理方法,该方法会对传入参数进行二次,将内容中有风险部分进行处理并返回。

使用时需要首先获取HttpSecurity对象:

HttpSecurity security = Xmtool.Web.Security();

Xss方法

1. Xss方法

public string Xss(string str)
说明:对指定字符内容进行Xss风险处理并返回处理结果。
参数:

str:需要进行处理的字符串内容。

string str = "<script>alert(123);</script><div>hello world.</div>";
string str2 = Xmtool.Web.Security().Xss(str);
Console.Writeline(str2);	// 输出<div>hello world.</div>
//TODO 

附加说明

一、DynamicObjectExt对象

说明:DynamicObjectExt动态对象是Xmtool工具库中最具特色的一项功能;通过该对象可以无需事先定义就能像使用实体类一样进行数据对象的赋值和操作;且比系统自带的dynamic对象更加灵活友好。如果你熟悉Javascript的话,它就像Javascript中的变量一样可以任意使用;更加详细的说明请参考《DynamicObjectExt详细说明》

二、HttpResponseExt对象

HttpResponseExt对象用于接收HTTP请求返回结果,封装了响应码、响应头、响应内容 3 部分内容。

StatusCode属性

Headers属性

Content属性

Json属性

Xml属性

1. StatusCode属性

说明:HTTP请求的响应状态码。

2. Headers属性

说明:HTTP请求的响应头信息。
HttpClientExt client = Xmtool.Web.Client();
HttpResponseExt resp = client.Get("https://www.baidu.com");
if (resp.Headers.ContainsKey("user"))
{
    string user = resp.Headers["user"];
    // TODO
}

3. Content属性

说明:HTTP请求的响应内容。

4. Json属性

说明:HTTP请求返回的JSON格式的内容;如果返回内容不是合法的JSON格式,将返回异常。
// https://www.ceshi.com/person/1 请求返回内容
{
    "Name": "softwaiter",
    "Age": 18,
    "Address": "BeiJing"
}
HttpClientExt client = Xmtool.Web.Client();
HttpResponseExt resp = client.Get("https://www.ceshi.com/person/1");
if (resp.Json.Name == "softwaiter")
{
    // TODO
}

5. Xml属性

说明:HTTP请求返回的XML格式的内容;如果返回内容不是合法的XML格式,将返回异常。


【Github源码】

与开源.NetCore通用工具库Xmtool使用连载 - HTTP请求篇相似的内容:

开源.NetCore通用工具库Xmtool使用连载 - HTTP请求篇

### [【Github源码】](https://github.com/softwaiter/Xmtool) [《上一篇》](https://www.cnblogs.com/bcbr/p/17608881.html) 介绍了Xmtool工具库中的XML操作类库,今天我们继续为大家介绍其中的HTTP请

开源.NetCore通用工具库Xmtool使用连载 - 加密解密篇

【Github源码】 《上一篇》详细介绍了Xmtool工具库中的正则表达式类库,今天我们继续为大家介绍其中的加密解密类库。 在开发过程中我们经常会遇到需要对数据进行加密和解密的需求,例如密码的加密、接口传输数据的加密等;当前类库中只封装了Base64、AES两种加密解密方法,因为C#提供了几乎我们能

开源.NetCore通用工具库Xmtool使用连载 - 散列算法篇

【Github源码】 《上一篇》详细介绍了Xmtool工具库中的加解密类库,今天我们继续为大家介绍其中的散列算法类库。 散列算法在某些特殊场景也可以当做加密方法使用;其特点是不可逆,同一内容每次散列值绝对一致,所以也可用作对数据内容是否被篡改的校验方法;或者其他需要唯一性编码的场景;本类库提供了MD

开源.NetCore通用工具库Xmtool使用连载 - 随机值篇

【Github源码】 《上一篇》 详细介绍了Xmtool工具库中的散列算法类库,今天我们继续为大家介绍其中的随机值类库。 基于系统提供的Random获取随机值方法已经足够简单和易用,本类库只对日常开发过程中最常用到的生成随机验证码方法进行了封装,后续发现其他有价值的常用随机值需求,会陆续添加到类库中

开源.NetCore通用工具库Xmtool使用连载 - 发送邮件篇

#### [【Github源码】](https://github.com/softwaiter/Xmtool) [《上一篇》](https://www.cnblogs.com/bcbr/p/17393628.html) 介绍了Xmtool工具库中的随机值类库,今天我们继续为大家介绍其中的邮件发送类库

开源.NetCore通用工具库Xmtool使用连载 - 发送短信篇

### [【Github源码】](https://github.com/softwaiter/Xmtool) [《上一篇》](https://www.cnblogs.com/bcbr/p/17421734.html) 介绍了Xmtool工具库中的发送邮件类库,今天我们继续为大家介绍其中的发送短信类库

开源.NetCore通用工具库Xmtool使用连载 - XML操作篇

### [【Github源码】](https://github.com/softwaiter/Xmtool) [《上一篇》](https://www.cnblogs.com/bcbr/p/17447376.html) 介绍了Xmtool工具库中的发送短信类库,今天我们继续为大家介绍其中的XML操作类

开源.NetCore通用工具库Xmtool使用连载 - 图形验证码篇

### [【Github源码】](https://github.com/softwaiter/Xmtool) [《上一篇》](https://www.cnblogs.com/bcbr/p/17624230.html) 介绍了Xmtool工具库中的Web操作类库,今天我们继续为大家介绍其中的图形验证码

开源.NetCore通用工具库Xmtool使用连载 - 扩展动态对象篇

【Github源码】 《上一篇》 介绍了Xmtool工具库中的图形验证码类库,今天我们继续为大家介绍其中的扩展动态对象类库。 扩展动态对象是整个工具库中最重要的一个设计。在软件开发过程中,我们经常需要定义各种各样的数据对象;例如:用于参数传递的数据实体类、用于接口返回结果的Json对象等等。 //

MongoDB从入门到实战之.NET Core使用MongoDB开发ToDoList系统(8)-Ant Design Blazor前端框架搭建

前言 前面的章节我们介绍了一些值得推荐的Blazor UI组件库,通过该篇文章的组件库介绍最终我选用Ant Design Blazor这个UI框架作为ToDoList系统的前端框架。因为在之前的工作中有使用过Ant Design Vue、Ant Design Angular习惯并且喜欢Ant Des