- A+
文章说明:
本文是基于盛派网络苏震巍老师的《微信公众号+小程序快速开发》课程笔记。
课程地址：
https://study.163.com/course/courseMain.htm?courseId=1004873017
本课项目地址：
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 }
View Code
三、文件（图片）的下载、上传：
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 }
View Code
四、 TryCommonApi
我们只需要提供AppId 参数 即可实现微信接口请求，TryCommonApi 实现了对 AccessToken 的自动获取 、检查，2次尝试获取
TryCommonApi 处理流程图： http://book.weixin.senparc.com/Upload/BookContent/Image/636344126967655618.png
