最近几个月本人与团队一直与小程序打交道,对小程序的实战开发算比较熟悉,也因一些朋友经常问我各种小程序问题,无不能一一回答,想了很久,决定还是空余时间来写写文章吧,偶尔发现一个人安静的时候写文章特爽,不信大伙可以试试哦^_^
一般项目开发已快速为主,这时想到了一个小程序开源框架,
盛派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>
本文文章版权归作者和博客园共有,未经作者同意不得随意转载,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。如有问题或建议,请与我联系。