第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 = https://www.cnblogs.com/WechatDeveloper/p/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

標籤：C#

上一篇：AgileConfig輕量級配置中心1.3.0發布，支持多用戶權限控制

下一篇：從檔案路徑截取需要的內容