.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?}"); }); #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类 静态变量定义如下： #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"); } }
 
发布项目到生产环境，在次点击微信小程序后台开发者配置，点击提交，验证成功说明已经与服务器牵手成功。   开发者服务器自动回复
建立与开发者服务器成功后，在公众号，小程序客服等功能发送的消息都会先经过微信服务器，微信服务器将已POST的请求方式中转给我们配置的URL地址，收到指令后，我们开发者根据收到的类型消息进行处理。
  统一处理消息的入口，代码如下： [HttpPost] [ActionName("Index")] 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 = 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) {//发来图片，进行处理
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/
<https://github.com/JeffreySu/WeiXinMPSDK/>  
作者：Dylan

公众号：dotNET名人堂（sharecore）

微信：tangguo_9669

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

出处：https://blog.csdn.net/hailang2ll <https://blog.csdn.net/hailang2ll>
本文文章版权归作者和博客园共有，未经作者同意不得随意转载，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。如有问题或建议，请与我联系。    

• « 上一篇：Kubernetes 系列六】Kubernetes 服务发现
• » 下一篇：淘宝自动登录2.0，新增Cookies序列化