第10、11课 接口调用及数据请求 - Senparc.CO2NET

文章说明: 

  本文是基于盛派网络苏震巍老师的《微信公众号+小程序快速开发》课程笔记。

课程地址: 

  https://study.163.com/course/courseMain.htm?courseId=1004873017

本课项目地址:

  https://github.com/wechatdeveloper/WechatVideoCourse

课程目标

  1.   SDK 对微信请求返回结果定义了对应的类,熟悉类之间的继承、扩展;
  2.   SDK 对微信接口的请求方法、进行了封装,参考:接口结构图示  ;
  3.   了解如何调用微信接口 ,使用工具类HttpUtility  调用外部接口,文件的上传、下载、保存;
  4.   了解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

 

  

 

 


 

posted @ 2021-06-15 09:59  Wechat-Developer  阅读(386)  评论(0编辑  收藏  举报