最近几个月本人与团队一直与小程序打交道,对小程序的实战开发算比较熟悉,也因一些朋友经常问我各种小程序问题,无不能一一回答,想了很久,决定还是空余时间来写写文章吧,偶尔发现一个人安静的时候写文章特爽,不信大伙可以试试哦^_^
一般项目开发已快速为主,这时想到了一个小程序开源框架,盛派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 = 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名人堂,主要分享.NET core各种技术文章,以及架构设计,管理技巧等干货,希望在这里通过实战能让你全新认识.NET core相关技术,项目架构,大数据处理,高并发,高耦合相关问题欢迎留言与我探讨。
作者微信ID:tangguo_9669
好文章,点我【在看】 ?