-
第10、11课 接口调用及数据请求 - Senparc.CO2NET
本课项目地址:
https://github.com/wechatdeveloper/WechatVideoCourse
课程目标:
- SDK 对微信请求返回结果定义了对应的类,熟悉类之间的继承、扩展;
- SDK 对微信接口的请求方法、进行了封装,参考:接口结构图示 ;
- 了解如何调用微信接口 ,使用工具类HttpUtility 调用外部接口,文件的上传、下载、保存;
- 了解Senparc.CO2NET ,它是底层公共基础库、工具类,包含Http请求、常用加密、解密方法等,Senparc SDK 官网 进行了详细的说明 :
Senparc.CO2NET 是一个支持 .NET Framework 和 .NET Core 的公共基础扩展库,包含常规开发所需要的基础帮助类。开发者可以直接使用 CO2NET 为项目提供公共基础方法,免去重复准备和维护公共代码的痛苦。您可以在几乎任何项目中使用 CO2NET。
5. 我们在调用微信接口的时候,接口方法 为什么只需要提供AppId,甚至不提供AppId 也可以正常使用 ? 是因为: TryCommonApi 内部对AppId 、AccessToken进行了检查、自动获取
一、微信返回基础类
当我们向微信服务器发出请求后,微信服务器返回请求结果,会包含errcode 、 errmsg 表明请求是否成功,如下
{"errcode":0,"errmsg":"ok"}
所以,我们需要定义微信返回结果的对应的类、基类;
在WxJsonResult的基础上,可根据需求、微信返回的结果 ,扩充包含更多字段或实体的子类。
二、CO2NET中常用的请求方法
1,封装的Get,Post 方法:
//1,Get Url Senparc.CO2NET.HttpUtility.RequestUtility.HttpGet(null, url, encoding: Encoding.UTF8); //2,Post Url with CookieContainer CookieContainer cookieContainer = new CookieContainer(); var html = Senparc.CO2NET.HttpUtility.RequestUtility.HttpGet(null, url, cookieContainer, encoding: Encoding.UTF8); //3,Post Url with form-data Dictionary<string, string> formData = new Dictionary<string, string>(); formData["checkcode"] = "318"; var html = Senparc.CO2NET.HttpUtility.RequestUtility.HttpPost(null, url, null, formData, encoding: Encoding.UTF8);
2,Get 方式,请求URL并返回T类型 ; 如以下方法获取天气预报信息
1 /// <summary> 2 /// 调用API返回的Json对象,转化为对应的实体类 3 /// </summary> 4 /// <param name="url"></param> 5 /// <returns></returns> 6 public string GetJsonResult(string url = "http://t.weather.itboy.net/api/weather/city/101030100") 7 { 8 var cityCode = Regex.Match("天气 101030100", @"(?<=天气 )(\S+)").Value; 9 10 var weather = Senparc.CO2NET.HttpUtility.Get.GetJson<Weather>(null, url); 11 12 return weather.ToJson(); 13 } 14 15 public class Weather 16 { 17 public string message { get; set; } 18 public int status { get; set; } 19 public string date { get; set; } 20 public string time { get; set; } 21 22 private DateTime AddTime { get; set; } 23 24 public Weather() 25 { 26 AddTime = DateTime.Now; 27 } 28 }
三、文件(图片)的下载、上传:
SDK对文件的上传、下载也进行了封装,提供了简单、易用的方法:
Senparc.CO2NET.HttpUtility.Get.Download、
Senparc.CO2NET.HttpUtility.RequestUtility.HttpPost
1 /// <summary> 2 /// 文件下载 3 /// </summary> 4 /// <param name="url"></param> 5 public ActionResult GetImage(string url = "https://sdk.weixin.senparc.com/images/book-cover-front-small-3d-transparent.png") 6 { 7 string strFilePath = Server.MapPath("~/Images/") ; 8 9 var fileSaved = Senparc.CO2NET.HttpUtility.Get.Download(null, url, strFilePath); 10 11 //文件重命名 12 var newFileName = fileSaved + ".png"; 13 System.IO.File.Move(fileSaved, newFileName); 14 15 return Content("图片下载成功:" + newFileName); 16 } 17 18 /// <summary> 19 /// 以Stream的方式保存图片后,再上传 20 /// </summary> 21 /// <param name="url"></param> 22 /// <returns></returns> 23 public ActionResult GetAndUploadImage(string url = "https://sdk.weixin.senparc.com/images/book-cover-front-small-3d-transparent.png") 24 { 25 string uploadResult = ""; 26 27 //以流的方式进行上传 28 string uploadUrl = "http://localhost:39821/Request/SaveImage"; 29 30 using (var ms = new MemoryStream()) 31 { 32 Senparc.CO2NET.HttpUtility.Get.Download(null, url, ms); 33 34 uploadResult = Senparc.CO2NET.HttpUtility.RequestUtility.HttpPost(null, uploadUrl, null, ms); 35 } 36 37 return Content("图片上传成功,上传路径:" + uploadResult); 38 } 39 40 /// <summary> 41 /// 保存HttpPost过来的图片 42 /// </summary> 43 [HttpPost] 44 public string SaveImage() 45 { 46 var stream = Request.InputStream; 47 48 string fileSaveName = Server.MapPath("~/Images/Upload/UploadImage.jpg"); 49 using (var fileStream = new FileStream(fileSaveName, FileMode.OpenOrCreate)) 50 { 51 stream.CopyTo(fileStream); 52 stream.Flush(); 53 } 54 55 return fileSaveName; 56 }
四、 TryCommonApi
我们只需要提供AppId 参数 即可实现微信接口请求,TryCommonApi 实现了对 AccessToken 的自动获取 、检查,2次尝试获取
TryCommonApi 处理流程图: http://book.weixin.senparc.com/Upload/BookContent/Image/636344126967655618.png
出处:https://www.cnblogs.com/WechatDeveloper/p/SenparcWeixinSDK-Course-10-11.html