第10、11课 接口调用及数据请求

文章说明: 

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

课程地址： 

　　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类型 ； 如以下方法获取天气预报信息

        /// <summary>
        /// 调用API返回的Json对象，转化为对应的实体类
        /// </summary>
        /// <param name="url"></param>
        /// <returns></returns>
        public string GetJsonResult(string url = "http://t.weather.itboy.net/api/weather/city/101030100")
        {
            var cityCode = Regex.Match("天气 101030100", @"(?<=天气 )(S+)").Value;
             
            var weather = Senparc.CO2NET.HttpUtility.Get.GetJson<Weather>(null, url);

            return weather.ToJson();
        }

        public class Weather
    {
        public string message { get; set; }
        public int status { get; set; }
        public string date { get; set; }
        public string time { get; set; }

        private DateTime AddTime { get; set; }

        public Weather()
        {
            AddTime = DateTime.Now;
        }
    } 

 三、文件（图片）的下载、上传：

　　SDK对文件的上传、下载也进行了封装，提供了简单、易用的方法：

　　Senparc.CO2NET.HttpUtility.Get.Download、 

　　Senparc.CO2NET.HttpUtility.RequestUtility.HttpPost

 /// <summary>
        /// 文件下载
        /// </summary>
        /// <param name="url"></param>
        public ActionResult GetImage(string url = "https://sdk.weixin.senparc.com/images/book-cover-front-small-3d-transparent.png")
        {
            string strFilePath = Server.MapPath("~/Images/") ;

            var fileSaved = Senparc.CO2NET.HttpUtility.Get.Download(null, url, strFilePath);

            //文件重命名
            var newFileName = fileSaved + ".png";
            System.IO.File.Move(fileSaved, newFileName);

            return Content("图片下载成功：" + newFileName);
        }

        /// <summary>
        /// 以Stream的方式保存图片后，再上传
        /// </summary>
        /// <param name="url"></param>
        /// <returns></returns>
        public ActionResult GetAndUploadImage(string url = "https://sdk.weixin.senparc.com/images/book-cover-front-small-3d-transparent.png")
        {
            string uploadResult = "";

            //以流的方式进行上传
            string uploadUrl = "http://localhost:39821/Request/SaveImage";

            using (var ms = new MemoryStream())
            {
                Senparc.CO2NET.HttpUtility.Get.Download(null, url, ms);

                uploadResult = Senparc.CO2NET.HttpUtility.RequestUtility.HttpPost(null, uploadUrl, null, ms);
            }

            return Content("图片上传成功，上传路径：" + uploadResult);
        }

        /// <summary>
        /// 保存HttpPost过来的图片
        /// </summary>
        [HttpPost]
        public string SaveImage()
        {
            var stream = Request.InputStream;

            string fileSaveName = Server.MapPath("~/Images/Upload/UploadImage.jpg");
            using (var fileStream = new FileStream(fileSaveName, FileMode.OpenOrCreate))
            {
                stream.CopyTo(fileStream);
                stream.Flush();
            }

            return fileSaveName;
        }

 四、 TryCommonApi

     我们只需要提供AppId 参数 即可实现微信接口请求，TryCommonApi 实现了对 AccessToken 的自动获取 、检查，2次尝试获取

　 TryCommonApi 处理流程图： http://book.weixin.senparc.com/Upload/BookContent/Image/636344126967655618.png

 

　　

 

 

---