.NET Core 小程序开发零基础系列（1）——开发者启用并牵手成功
最近几个月本人与团队一直与小程序打交道，对小程序的实战开发算比较熟悉，也因一些朋友经常问我各种小程序问题，无不能一一回答，想了很久，决定还是空余时间来写写文章吧，偶尔发现一个人安静的时候写文章特爽，不
.NET Core 小程序开发零基础系列（1）——开发者启用并牵手成功
最近几个月本人与团队一直与小程序打交道，对小程序的实战开发算比较熟悉，也因一些朋友经常问我各种小程序问题，无不能一一回答，想了很久，决定还是空余时间来写写文章吧，偶尔发现一个人安静的时候写文章特爽，不信大伙可以试试哦^_^
一般项目开发已快速为主，这时想到了一个小程序开源框架，盛派Senparc，这个项目使用过程中确实很爽，开发速度贼快，想了解底层原理的同学可以下载盛派Senparc开源项目，开原址址附文章底部。
小程序开发系统文章就此诞生了，后面文章会覆盖小程序的所有功能，希望对刚步入小程序开发的同学有所帮助。
目录
一、微信公众平台开发者设置
二、新建.netcore 项目与微信服务器牵手
三、开发者服务器自动回复
四、各种消息类型处理
五、总结
微信公众平台开发者设置
登录微信公众平台小程序后台，开发设置-消息推送，启用开发者，填写相关信息，如下图
配置好后，点击提交，会校验与服务器牵手动作，此时要保证服务地址能正常访问。
如不清楚的，请看下一步操作。
新建.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?}");});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);}
以上盛派Senparc组件的全局配置基本完成，可以开始写验证服务器的接口啦。
新建HomeController类
静态变量定义如下：
/// <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;
验证接口代码如下：
[][]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");}}
发布项目到生产环境，在次点击微信小程序后台开发者配置，点击提交，验证成功说明已经与服务器牵手成功。
开发者服务器自动回复
建立与开发者服务器成功后，在公众号，小程序客服等功能发送的消息都会先经过微信服务器，微信服务器将已POST的请求方式中转给我们配置的URL地址，收到指令后，我们开发者根据收到的类型消息进行处理。
统一处理消息的入口，代码如下：
[][]public ActionResult Post(PostModel postModel){if (!CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token)){return Content("参数错误！");}try{postModel.Token = Token;//根据自己后台的设置保持一致postModel.EncodingAESKey = EncodingAESKey;//根据自己后台的设置保持一致postModel.AppId = AppId;//根据自己后台的设置保持一致（必须提供）var maxRecordCount = 10;var messageHandler = new CustomWxOpenMessageHandler(Request.GetRequestMemoryStream(), postModel, maxRecordCount);messageHandler.Execute();//执行微信处理过程（关键）var result = new FixWeixinBugWeixinResult(messageHandler);return result;}catch (Exception ex){Logger.Info("异常消息：" + ex.Message);return Content("");}}
所有消息都会经过管道处理即CustomWxOpenMessageHandler方法，CustomWxOpenMessageHandler主要代码如下（遇到问题请与我联系）：
public CustomWxOpenMessageHandler(Stream inputStream, PostModel postModel, int maxRecordCount = 0): base(inputStream, postModel, maxRecordCount){//这里设置仅用于测试，实际开发可以在外部更全局的地方设置，//比如MessageHandler<MessageContext>.GlobalGlobalMessageContext.ExpireMinutes = 3。GlobalMessageContext.ExpireMinutes = 3;if (!string.IsNullOrEmpty(postModel.AppId)){appId = postModel.AppId;//通过第三方开放平台发送过来的请求}//在指定条件下，不使用消息去重base.OmitRepeatedMessageFunc = requestMessage =>{var textRequestMessage = requestMessage as 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){//发来图片，进行处理Task.Factory.StartNew(async () =>{await Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendTextAsync(appId, OpenId, "刚才您发送了这张图片：");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();}
统一默认处理，代码如下：
public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage){return new SuccessResponseMessage();}
总结
盛派Senparc组件适用于快速开发项目，个人觉得还是很方便的，如果想进一步了解底层，可以看底层接口，其实就是请求的微信的相关接口，处理返回的结果进行了封装，如有在小程序开发过程中遇到任何问题可与我联系
盛派Senparc开源项目：https://github.com/JeffreySu/WeiXinMPSDK/
责任编辑：dotNET知音
