前言:本系列文章适合有初/中级.NET知识的同学阅读(请在电脑上打开页面,获取更好的阅读效果)。
(1)本系列文章,旨在讲述研发一个中大型项目所需要了解的一系列“基本构件”,并提供这些“基本构件”在全网的【最简单】、【最快速】使用方法!!(并不深究技术原理)
(2)通过阅读本系列文章,能让你在正规“项目研发”方面快速入门+进阶,并能达成“小团队构建大网站”的目的。
(3)本系列文章采用的技术,已成功应用到人工智能、产业互联网、社区电商、游戏、金融风控、智慧医疗、等项目上。
支持.Net/.Net Core/.Net Framework,可以部署在Docker, Windows, Linux, Mac。
http请求调用是开发中经常会用到的功能。在内,调用自有项目的Web Api等形式接口时会用到;在外,调用一些第三方功能接口时,也会用到,因为,这些第三方功能往往是通过http地址的形式提供的,比如:短信服务、在线翻译、地图服务、语音智能、等…
http请求调用,又分为Post与Get两种形式。
Post形式的请求相对复杂一些,也更常用,一旦弄明白它, Get形式一看便懂,故我们首先来看看Post形式的请求调用。
使用Post调用http,往往有四个参数需要设置:
(1) 调用地址
(2) 需要发送过去的参数
(3) http请求头(如果有设置)
(4) 编码格式。常用的为:application/json
下面给出一个使用第三方链接“发送短信”的代码示例:
using DeveloperSharp.Framework.CoreUtility; //从NuGet引用DeveloperSharp包 using Newtonsoft.Json; //从NuGet引用Newtonsoft.Json包 -------------------------- public static object SendMessage(string mobile, string code, string name) { //创建DeveloperSharp中的IUtility工具 IUtility IU = new Utility(); //调用地址 string requestUrl = "https://prekaka.rainfn.com/kaka/api/v1/activity/uploadUserData"; //需要发送的参数 Dictionary<string, object> data = new Dictionary<string, object> { { "mobile",mobile }, { "code",code}, { "name",name} }; //Post形式发送请求调用 var responsesStr = IU.HttpPost(requestUrl, JsonConvert.SerializeObject(data), null, "application/json"); object reData = JsonConvert.DeserializeObject<object>(responsesStr); return reData; }
上例因为没有设置“http请求头”,故HttpPost方法的第三个参数传值为null。
HttpPost方法的详细说明如下:
HttpPost(Async) 声明:string HttpPost(string Url, string ParamData = "", Dictionary<string, string> HeaderDic = null, string ContentType = "application/x-www-form-urlencoded"); 用途:调用Http-Post请求 参数:(1)string Url -- 调用请求的url地址 (2)string ParamData -- 提交的参数 (3)Dictionary<string, string> HeaderDic -- 存放http头的键值对 (4)string ContentType -- 请求的编码格式,通常有application/x-www-form-urlencoded(默认设置)、multipart/form-data、application/json三种形式 返回:String -- 请求结果(-107开头表示出错)
最后,我们来说说Get形式的请求调用。
Get形式往往用于url后带问号“?N1=V1&N2=V2&N3=V3”这类的调用。这类调用的特点是:“需要发送的参数”直接挂在了“调用地址”后面。下面直接给出一个示例,你一看便知:
using DeveloperSharp.Framework.CoreUtility; //从NuGet引用DeveloperSharp包 -------------------------- IUtility ui = new Utility(); string r = ui.HttpGet("http://localhost:1416/Handler1.ashx?name=kyyk&age=100");
☆与其它工具的比较
(1)有人可能会说,http调用还有Put、Delete、等类型。但实际开发中,我们只用Post/Get两种就够了。
(2)正是由于http请求调用是项目开发中如此重要的一环,市面上产生了很多相关工具,比:FlurXXX、RestSharXXX、HttpClieXXX、等等...
但本文的方案其实可以算得上是上述这些方案的理论基础/底层。
上述一些工具,更多的是把本文方案中的“编码格式”与“json序列化/反序列化”两步给简化包装+集成,成为了PostJson、GetUrl、之类方法。但本文前面提到过,“编码格式”Content-Type常用的有Json、x-www-form-urlencoded、form-data三种,它们只是常用的三种,事实上不止这三种(这是问题的核心所在!!)。
你现在能包装成PostJson、PostUrl,PostData,后续更多的种类作者都包装了么?答案是:没有!!
所以,从这个意义上说,上述那些工具在功能上是有缺陷的,遇到特殊情况它们处理不了!!
为了使功能完善+能处理所有情况的http请求调用,最好的方法,就是像本文方案那样,把“编码格式”Content-Type作为一个string参数显露出来,让开发者根据情况自己去填写....(本文完)
【附注】:下载示例均已成功运行通过。但有些辅助设置需要自己调整。技术支持+获取更多宝贵资源:请微信扫描文末二维码,备注“进群”!