.NET Core 小程序開發(fā)零基礎系列（1）——開發(fā)者啟用并牽手成功

?
最近幾個月本人與團隊一直與小程序打交道，對小程序的實戰(zhàn)開發(fā)算比較熟悉，也因一些朋友經(jīng)常問我各種小程序問題，無不能一一回答，想了很久，決定還是空余時間來寫寫文章吧，偶爾發(fā)現(xiàn)一個人安靜的時候寫文章特爽，不信大伙可以試試哦^_^
一般項目開發(fā)已快速為主，這時想到了一個小程序開源框架，
盛派Senparc，這個項目使用過程中確實很爽，開發(fā)速度賊快，想了解底層原理的同學可以下載盛派Senparc開源項目，開原址址附文章底部。 ?
小程序開發(fā)系統(tǒng)文章就此誕生了，后面文章會覆蓋小程序的所有功能，希望對剛步入小程序開的同學有所幫助。 ? 目錄 一、微信公眾平臺開發(fā)者設置
二、新建.netcore 項目與微信服務器牽手 三、開發(fā)者服務器自動回復 四、各種消息類型處理 五、總結 ? ? 微信公眾平臺開發(fā)者設置
登錄微信公眾平臺小程序后臺，開發(fā)設置-消息推送，啟用開發(fā)者，填寫相關信息，如下圖 ? ?
配置好后，點擊提交，會校驗與服務器牽手動作，此時要保證服務地址能正常訪問。 如不清楚的，請看下一步操作。 ? ? 新建.netcore 項目與微信服務器牽手
新建.netcore api項目，項目結構如下圖： ? 引用盛派Senparc組件： Senparc.Weixin.MP.MVC
Senparc.Weixin.WxOpen
?
使用盛派Senparc組件配置文件如下： "SenparcWeixinSetting": { //微信全局 "IsDebug": true, //公眾號 "
Token": "#Token#", "EncodingAESKey": "#EncodingAESKey#", "WeixinAppId": "
#WeixinAppId#", "WeixinAppSecret": "#WeixinAppSecret#", "Items": { "小程序1": { "
WxOpenAppId": "#WxOpenAppId#", "WxOpenAppSecret": "#WxOpenAppSecret#", "
WxOpenToken": "#WxOpenToken#", "WxOpenEncodingAESKey": "#WxOpenEncodingAESKey#"
},"小程B": { "WxOpenAppId": "#WxOpenAppId#", "WxOpenAppSecret": "#WxOpenAppSecret#
", "WxOpenToken": "#WxOpenToken#", "WxOpenEncodingAESKey": "
#WxOpenEncodingAESKey#" } } }
?
使用盛派Senparc組件必須先進行注冊，在Startup類中ConfigureServices方法進行注冊
services.AddSenparcGlobalServices(Configuration)
.AddSenparcWeixinServices(Configuration);
?
在Startup類中Configure方法進行使用 public void Configure(IApplicationBuilder app,
IHostingEnvironment env, IOptions<SenparcSetting> senparcSetting,
IOptions<SenparcWeixinSetting> senparcWeixinSetting) { if (env.IsDevelopment())
{ app.UseDeveloperExceptionPage(); app.UseSwaggerUIV2(); }
app.UseStaticHttpContext(); app.UseStaticFiles(); app.UseMvc(routes=> {
routes.MapRoute( name:"default", template: "
{controller=Home}/{action=Index}/{id?}"); }); #region 公眾號，小程序 IRegisterService
register= RegisterService.Start(env, senparcSetting.Value).UseSenparcGlobal(
false, null); register.UseSenparcWeixin(senparcWeixinSetting.Value,
senparcSetting.Value);//配置 var bInfo = senparcWeixinSetting.Value.Items["appid"
]; AccessTokenContainer.RegisterAsync(bInfo.WxOpenAppId, bInfo.WxOpenAppSecret,
bInfo.WxOpenAppId);//公眾號
AccessTokenContainer.RegisterAsync(senparcWeixinSetting.Value.WeixinAppId,
senparcWeixinSetting.Value.WeixinAppSecret,
senparcWeixinSetting.Value.WeixinAppId);#endregion }
?
以上盛派Senparc組件的全局配置基本完成，可以開始寫驗證服務器的接口啦。 ? 新建HomeController類 靜態(tài)變量定義如下： #region
static/// <summary> /// 當前小程序的AppId /// </summary> public static readonly string
AppId = Senparc.Weixin.Config.SenparcWeixinSetting.Items["appid"].WxOpenAppId;
/// <summary> /// /// </summary> public static readonly string Token =
Senparc.Weixin.Config.SenparcWeixinSetting.Items[AppId].WxOpenToken;///
<summary> /// /// </summary> public static readonly string EncodingAESKey =
Senparc.Weixin.Config.SenparcWeixinSetting.Items[AppId].WxOpenEncodingAESKey;
#endregion
?
驗證接口代碼如下： [HttpGet] [ActionName("Index")] public ActionResult Get(PostModel
postModel,string echostr) { if (CheckSignature.Check(postModel.Signature,
postModel.Timestamp, postModel.Nonce, Token)) {return Content(echostr); //
返回隨機字符串則表示驗證通過 } else { return Content("failed:" + postModel.Signature + "," +
Senparc.Weixin.MP.CheckSignature.GetSignature(postModel.Timestamp,
postModel.Nonce, Token) +"。" + "
如果你在瀏覽器中看到這句話，說明此地址可以被作為微信小程序后臺的Url，請注意保持Token一致。1"); } }
?
發(fā)布項目到生產(chǎn)環(huán)境，在次點擊微信小程序后臺開發(fā)者配置，點擊提交，驗證成功說明已經(jīng)與服務器牽手成功。 ? 開發(fā)者服務器自動回復
建立與開發(fā)者服務器成功后，在公眾號，小程序客服等功能發(fā)送的消息都會先經(jīng)過微信服務器，微信服務器將已POST的請求方式中轉給我們配置的URL地址，收到指令后，我們開發(fā)者根據(jù)收到的類型消息進行處理。
? 統(tǒng)一處理消息的入口，代碼如下： [HttpPost] [ActionName("Index")] public ActionResult
Post(PostModel postModel) {if (!CheckSignature.Check(postModel.Signature,
postModel.Timestamp, postModel.Nonce, Token)) {return Content("參數(shù)錯誤！"); } try {
postModel.Token= Token;//根據(jù)自己后臺的設置保持一致 postModel.EncodingAESKey =
EncodingAESKey;//根據(jù)自己后臺的設置保持一致 postModel.AppId = AppId;//根據(jù)自己后臺的設置保持一致（必須提供） var
maxRecordCount =10; var messageHandler = new
CustomWxOpenMessageHandler(Request.GetRequestMemoryStream(), postModel,
maxRecordCount); messageHandler.Execute();//執(zhí)行微信處理過程（關鍵） ? ? var result = new
FixWeixinBugWeixinResult(messageHandler);return result; } catch (Exception ex)
{ Logger.Info("異常消息：" + ex.Message); return Content(""); } }
?

所有消息都會經(jīng)過管道處理即CustomWxOpenMessageHandler方法，CustomWxOpenMessageHandler主要代碼如下（遇到問題請與我聯(lián)系）：
public CustomWxOpenMessageHandler(Stream inputStream, PostModel postModel, int
maxRecordCount =0) : base(inputStream, postModel, maxRecordCount) { //
這里設置僅用于測試，實際開發(fā)可以在外部更全局的地方設置，//
比如MessageHandler<MessageContext>.GlobalGlobalMessageContext.ExpireMinutes = 3。
GlobalMessageContext.ExpireMinutes =3; if (!string
.IsNullOrEmpty(postModel.AppId)) { appId= postModel.AppId;//通過第三方開放平臺發(fā)送過來的請求 }
//在指定條件下，不使用消息去重 base.OmitRepeatedMessageFunc = requestMessage => { var
textRequestMessage = requestMessageas RequestMessageText; if
(textRequestMessage !=null && textRequestMessage.Content == "容錯") { return false
; }return true; }; }
?
自動回復處理方法，代碼如下： public override IResponseMessageBase
OnEvent_UserEnterTempSessionRequest(RequestMessageEvent_UserEnterTempSession
requestMessage) {//進入客服 var msg = @"歡迎您！這條消息來自服務器";
Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendText(appId, OpenId, msg);return
DefaultResponseMessage(requestMessage); } ?
?
效果圖如下： ? 各種消息類型處理 圖片消息處理代碼如下： public override IResponseMessageBase
OnImageRequest(RequestMessageImage requestMessage) {//發(fā)來圖片，進行處理
Task.Factory.StartNew(async () => { await
Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendTextAsync(appId, OpenId,"
剛才您發(fā)送了這張圖片："); await
Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendImageAsync(appId, OpenId,
requestMessage.MediaId); });return DefaultResponseMessage(requestMessage); }
?
文字消息處理代碼如下： public override IResponseMessageBase
OnTextRequest(RequestMessageText requestMessage) {if (contentUpper == "1") { var
uploadResult =
Senparc.Weixin.MP.AdvancedAPIs.MediaApi.UploadTemporaryMedia(appId,
UploadMediaFileType.image, ServerUtility.ContentRootMapPath("
~/wwwroot/imgs/fwh.jpg"));
Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendImage(appId, OpenId,
uploadResult.media_id); }else { var msg = "親，回復“1”，關注服務號。";
Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendText(appId, OpenId, msg); }
return new SuccessResponseMessage(); }
?
統(tǒng)一默認處理，代碼如下： public override IResponseMessageBase
DefaultResponseMessage(IRequestMessageBase requestMessage) {return new
SuccessResponseMessage(); ? } ? 總結
盛派Senparc組件適用于快速開發(fā)項目，個人覺得還是很方便的，如果想進一步了解底層，可以看底層接口，其實就是請求的微信的相關接口，處理返回的結果進行了封裝，如有在小程序開發(fā)過程中遇到任何問題可與我聯(lián)系
? 盛派Senparc開源項目：https://github.com/JeffreySu/WeiXinMPSDK/
<https://github.com/JeffreySu/WeiXinMPSDK/> ?
作者：Dylan

公眾號：dotNET名人堂（sharecore）

微信：tangguo_9669

QQ：.NET Core 技術交流（18362376）

出處：https://blog.csdn.net/hailang2ll <https://blog.csdn.net/hailang2ll>
本文文章版權歸作者和博客園共有，未經(jīng)作者同意不得隨意轉載，且在文章頁面明顯位置給出原文連接，否則保留追究法律責任的權利。如有問題或建議，請與我聯(lián)系。 ? ?

• ? 上一篇：Kubernetes 系列六】Kubernetes 服務發(fā)現(xiàn)
• ? 下一篇：淘寶自動登錄2.0，新增Cookies序列化