-
第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










