Senparc.Weixin.MP SDK 微信公众平台开发教程(五):使用Senparc.Weixin.MP SDK
本文转载自: https://www.cnblogs.com/szw/archive/2013/11/08/3414732.html 作者:szw 转载请注明该声明。
Senparc.Weixin.MP SDK 已经涵盖了微信 6.x 的几乎所有公共 API。
整个项目的源代码以都可以在这个项目中获取到:https://github.com/JeffreySu/WeiXinMPSDK
PS:由于微信 API 以及 Senparc.Weixin SDK一直在不断升级更新,最新的代码及 Demo 以上面的 GitHub 中的源代码为准。
我们现在从无到有建立一个ASP.NET MVC 项目,来看一下如何与微信进行对接(Webforms 原理也都是一样,只不过把 Controller 中的 Action 换成 .aspx 页面就可以了,可参考 Demo)。
将要演示的项目源代码也可以在开源项目中找到。因为源代码中要兼顾多个不同 .net 版本的项目,因此有一个公用项目(CommonService),所以与下面展示的结构略有不同,不过逻辑完全一致:
MVC:https://github.com/JeffreySu/WeiXinMPSDK/tree/master/Senparc.Weixin.MP.Sample
WebForms:https://github.com/JeffreySu/WeiXinMPSDK/tree/master/Senparc.Weixin.MP.Sample.WebForms
现在就开始吧!
第一步:建立一个空的 ASP.NET MVC 项目(截图以 ASP.NET MVC 4.0 为例,.net core 也是类似的),项目名称如Senparc.Weixin.MP.Sample
第二步:引入Senparc.Weixin.MP.dll
引入相关dll的方式有两种:
- 一种是复制 dll 到项目某文件夹中,然后直接在项目中添加 Senparc.Weixin.MP.dll 、依赖dll 及 Senparc.Weixin.MP.MvcExtension.dll 的引用(Senparc.Weixin.MP.MvcExtension.dll 只有 MVC 项目需要,WebForms 项目可以忽略);
- 第二种方式我们可以使用 Nuget 直接安装到项目中。
Nuget项目地址:https://www.nuget.org/packages/Senparc.Weixin.MP/
第一种方式已经足够简单(但是不建议,除非你需要修改 SDK 中的内容,使用自己编译的 dll)。
下面介绍第二种:打开菜单【工具】> 【库程序包管理器】 > 【程序包管理器控制台】,如下图:
点击后将会出现程序包管理器控制台:
如果是第一次安装Senparc.Weixin.MP库,则在PM>后面输入命令:
Install-Package Senparc.Weixin.MP
回车,Senparc.Weixin.MP.dll将会被自动引入到项目中。
如果以后需要更新到最新版本,只需要使用Update-Package命令,将会自动在线更新:
Update-Package Senparc.Weixin.MP
以上操作对MVC和WebForms项目都有效。
如果是MVC项目,为了获得更多针对MVC的扩展功能,我们可以继续引入Senparc.Weixin.MP.MvcExtension.dll:
Install-Package Senparc.Weixin.MP.MVC
命令窗口输出结果如下,表示已经安装成功:
我们观察一下项目引用的程序集,这两个dll已经被引用进来了(同时还会自动引入依赖的dll,如 Senparc.CO2NET):
除了使用命令行的方式,也可以在【解决方案管理器】中的项目节点点击右键,选择【管理 Nuget 程序包 ...】,在【浏览】标签下输入关键字“Senparc.Weixin.MP”,选中最新的版本,点击右侧的【安装】按钮:
第三步:在全局中进行设置
.net framework 项目:
1、打开global.asax.cs文件
2、在 Application_Start() 方法中加入如下代码(可参考 Demo):
/* CO2NET 全局注册开始* 建议按照以下顺序进行注册*///设置全局 Debug 状态var isGLobalDebug = true;var senparcSetting = SenparcSetting.BuildFromWebConfig(isGLobalDebug);//CO2NET 全局注册,必须!!IRegisterService register = RegisterService.Start(senparcSetting).UseSenparcGlobal(false, null);/* 微信配置开始* 建议按照以下顺序进行注册*///设置微信 Debug 状态var isWeixinDebug = true;var senparcWeixinSetting = SenparcWeixinSetting.BuildFromWebConfig(isWeixinDebug);//微信全局注册,必须!!register.UseSenparcWeixin(senparcWeixinSetting, senparcSetting);
3、参考 Web.Config 的<appSetting>节点下加入参数设置(可参考 Demo):
<!-- 以下信息会被自动识别,如无特殊说明,不用的参数可以删除,但修改 key 后将会无法自动识别! --><!-- 自动识别参数开始 --><!-- 以下为 CO2NET 的 SenparcSetting 全局配置,请勿修改 key,勿删除任何项 --><!-- 默认缓存命名空间配置 --><add key="DefaultCacheNamespace" value="DefaultCache" /><!-- Cache.Redis连接配置 --><add key="Cache_Redis_Configuration" value="Redis配置" /><!--<add key="Cache_Redis_Configuration" value="localhost:6379" />--><!-- Cache.Memcached连接配置 --><add key="Cache_Memcached_Configuration" value="Memcached配置" /><add key="SenparcUnionAgentKey" value="SenparcUnionAgentKey" /><!-- 以下为 Senparc.Weixin 的 SenparcWeixinSetting 微信配置,不使用的参数可以删除 --><!-- 微信公众号URL对接信息 --><add key="WeixinToken" value="应用服务器(开发者服务器)URL对应的Token" /><add key="WeixinEncodingAESKey" value="应用服务器(开发者服务器)URL对应的消息加解密密钥" /><!-- 高级接口信息 --><add key="WeixinAppId" value="微信AppId" /><add key="WeixinAppSecret" value="微信AppSecret" /><!-- SDK提供的代理功能设置 --><add key="WeixinAgentUrl" value="外部代理Url" /><add key="WeixinAgentToken" value="外部代理Token" /><add key="SenparcAgentKey" value="盛派代理系统通用Key" /><add key="WeixinAgentWeiweihiKey" value="外部代理WeiWeiHiKey" /><!-- 微信支付相关参数 --><!-- 微信支付V2 --><add key="WeixinPay_Tenpay" value="WeixinPay_Tenpay" /><add key="WeixinPay_PartnerId" value="WeixinPay_PartnerId" /><add key="WeixinPay_Key" value="WeixinPay_Key" /><add key="WeixinPay_AppId" value="WeixinPay_AppId" /><add key="WeixinPay_AppKey" value="WeixinPay_AppKey" /><add key="WeixinPay_TenpayNotify" value="WeixinPay_TenpayNotify" /><!-- 微信支付V3 --><add key="TenPayV3_MchId" value="TenPayV3_MchId" /><add key="TenPayV3_Key" value="TenPayV3_Key" /><add key="TenPayV3_AppId" value="TenPayV3_AppId" /><add key="TenPayV3_AppSecret" value="TenPayV3_AppSecret" /><add key="TenPayV3_TenpayNotify" value="http://YourDomainName/TenpayV3/PayNotifyUrl" /><!-- 开放平台 --><add key="Component_Appid" value="Component_Appid" /><add key="Component_Secret" value="Component_Secret" /><add key="Component_Token" value="Component_Token" /><add key="Component_EncodingAESKey" value="Component_EncodingAESKey" /><!-- 微信企业号 --><add key="WeixinCorpId" value="WeixinCorpId" /><add key="WeixinCorpSecret" value="WeixinCorpSecret" /><!-- 小程序 --><!-- 小程序消息URL对接信息 --><add key="WxOpenToken" value="小程序消息URL对应的Token" /><add key="WxOpenEncodingAESKey" value="小程序消息URL对应的消息加解密密钥" /><!-- 小程序秘钥信息 --><add key="WxOpenAppId" value="微信小程序AppId" /><add key="WxOpenAppSecret" value="微信小程序AppSecret" /><!-- 自动识别参数结束 -->
View Code
.net core 项目:
1、打开 Startup.cs 文件(可参考 Demo)
2、在 ConfigureServices() 方法中加入:
public void ConfigureServices(IServiceCollection services){//...services.AddSenparcGlobalServices(Configuration)//Senparc.CO2NET 全局注册.AddSenparcWeixinServices(Configuration);//Senparc.Weixin 注册}
3、修改 Configure() 方法传入参数,并添加代码:
public void Configure(IApplicationBuilder app, IHostingEnvironment env, IOptions<SenparcSetting> senparcSetting, IOptions<SenparcWeixinSetting> senparcWeixinSetting){//app.UseMvc()等设置...// 启动 CO2NET 全局注册,必须!IRegisterService register = RegisterService.Start(env, senparcSetting.Value).UseSenparcGlobal(false, null);//开始注册微信信息,必须!register.UseSenparcWeixin(senparcWeixinSetting.Value, senparcSetting.Value) }
4、在 appsetting.json 文件下插入以下设置(可参考 Demo):
//以下信息会被自动识别,如无特殊说明,不用的参数可以删除,但修改 key 后将会无法自动识别!//CO2NET 设置"SenparcSetting": {//以下为 CO2NET 的 SenparcSetting 全局配置,请勿修改 key,勿删除任何项"IsDebug": true,"DefaultCacheNamespace": "DefaultCache",//分布式缓存"Cache_Redis_Configuration": "Redis配置",//"Cache_Redis_Configuration": "localhost:6379","Cache_Memcached_Configuration": "Memcached配置","SenparcUnionAgentKey": "SenparcUnionAgentKey"},//Senparc.Weixin SDK 设置"SenparcWeixinSetting": {//以下为 Senparc.Weixin 的 SenparcWeixinSetting 微信配置//微信全局"IsDebug": true,//以下不使用的参数可以删除,key 修改后将会失效//公众号"Token": "weixin","EncodingAESKey": "","WeixinAppId": "WeixinAppId","WeixinAppSecret": "WeixinAppSecret",//小程序"WxOpenAppId": "WxOpenAppId","WxOpenAppSecret": "WxOpenAppSecret","WxOpenToken": "WxOpenToken","WxOpenEncodingAESKey": "WxOpenEncodingAESKey",//企业微信"WeixinCorpId": "WeixinCorpId","WeixinCorpSecret": "WeixinCorpSecret",//微信支付//微信支付V2(旧版)"WeixinPay_PartnerId": "WeixinPay_PartnerId","WeixinPay_Key": "WeixinPay_Key","WeixinPay_AppId": "WeixinPay_AppId","WeixinPay_AppKey": "WeixinPay_AppKey","WeixinPay_TenpayNotify": "WeixinPay_TenpayNotify",//微信支付V3(新版)"TenPayV3_MchId": "TenPayV3_MchId","TenPayV3_Key": "TenPayV3_Key","TenPayV3_AppId": "TenPayV3_AppId","TenPayV3_AppSecret": "TenPayV3_AppId","TenPayV3_TenpayNotify": "TenPayV3_TenpayNotify",//开放平台"Component_Appid": "Component_Appid","Component_Secret": "Component_Secret","Component_Token": "Component_Token","Component_EncodingAESKey": "Component_EncodingAESKey",//扩展及代理参数"AgentUrl": "AgentUrl","AgentToken": "AgentToken","SenparcWechatAgentKey": "SenparcWechatAgentKey"}
View Code
第四步:建立一个Controller,如WeixinController.cs
第四步:修改WeixinController.cs
我们将下列代码加入WeixinController.cs:
1 using System; 2 using System.IO; 3 using System.Web.Configuration; 4 using System.Web.Mvc; 5 using Senparc.Weixin.MP.Entities.Request; 6 7 namespace Senparc.Weixin.MP.Sample.Controllers 8 { 9 using Senparc.Weixin.MP.MvcExtension; 10 using Senparc.Weixin.MP.Sample.CommonService.CustomMessageHandler; 11 12 public partial class WeixinController : Controller 13 { 14 public static readonly string Token = Config.SenparcWeixinSetting.Token;//与微信公众账号后台的Token设置保持一致,区分大小写。 15 public static readonly string EncodingAESKey = Config.SenparcWeixinSetting.EncodingAESKey;//与微信公众账号后台的EncodingAESKey设置保持一致,区分大小写。 16 public static readonly string AppId = Config.SenparcWeixinSetting.WeixinAppId;//与微信公众账号后台的AppId设置保持一致,区分大小写。 17 18 /// <summary> 19 /// 微信后台验证地址(使用Get),微信后台的“接口配置信息”的Url填写如:http://weixin.senparc.com/weixin 20 /// </summary> 21 [HttpGet] 22 [ActionName("Index")] 23 public ActionResult Get(PostModel postModel, string echostr) 24 { 25 if (CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token)) 26 { 27 return Content(echostr); //返回随机字符串则表示验证通过 28 } 29 else 30 { 31 return Content("failed:" + postModel.Signature + "," + MP.CheckSignature.GetSignature(postModel.Timestamp, postModel.Nonce, Token) + "。" + 32 "如果你在浏览器中看到这句话,说明此地址可以被作为微信公众账号后台的Url,请注意保持Token一致。"); 33 } 34 } 35 36 /// <summary> 37 /// 用户发送消息后,微信平台自动Post一个请求到这里,并等待响应XML。 38 /// PS:此方法为简化方法,效果与OldPost一致。 39 /// v0.8之后的版本可以结合Senparc.Weixin.MP.MvcExtension扩展包,使用WeixinResult,见MiniPost方法。 40 /// </summary> 41 [HttpPost] 42 [ActionName("Index")] 43 public ActionResult Post(PostModel postModel) 44 { 45 if (!CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token)) 46 { 47 return Content("参数错误!"); 48 } 49 50 postModel.Token = Token;//根据自己后台的设置保持一致 51 postModel.EncodingAESKey = EncodingAESKey;//根据自己后台的设置保持一致 52 postModel.AppId = AppId;//根据自己后台的设置保持一致 53 54 //自定义MessageHandler,对微信请求的详细判断操作都在这里面。 55 var messageHandler = new CustomMessageHandler(Request.InputStream, postModel);//接收消息 56 57 messageHandler.Execute();//执行微信处理过程 58 59 return new FixWeixinBugWeixinResult(messageHandler);//返回结果 60 61 } 62 } 63 }
第一个 Get() 对应微信后台设置 URL 时候的请求(只在验证的时候用到),第二个 Post() 用于接收微信服务器转发过来的客户请求。
其中 CustomMessageHandler 是我们自己创建的一个类,用于实现 MessageHandler(有关MessageHandler的详细介绍可以看《Senparc.Weixin.MP SDK 微信公众平台开发教程(六):了解MessageHandler》,也可以看这里),所有处理微信消息的核心逻辑都被包含到 CustomMessageHandler 中执行。除了承担处理微信响应的任务,MessageHandler 还实现了处理单个用户对话上下文等功能,非常方便。
至此,整个Senparc.Weixin.MP SDK已经基本开发完毕,可以直接发布,并在微信后台使用“高级功能”对接了。
在微信后台设置中,Url 填写 http://xxx/Weixin,Token 填写 Web.config 中的“WeixinToken ” 或 appsetting.json 中的“Token”所设置的值。
(如何在微信后台设置请看:Senparc.Weixin.MP SDK 微信公众平台开发教程(三):微信公众平台开发验证)
接下去我们会介绍如何在MessageHandler中处理具体的微信请求(文字、图片、位置、语音等等)。
系列教程索引
地址:http://www.cnblogs.com/szw/archive/2013/05/14/weixin-course-index.html
- Senparc.Weixin.MP SDK 微信公众平台开发教程(一):微信公众平台注册
- Senparc.Weixin.MP SDK 微信公众平台开发教程(二):成为开发者
- Senparc.Weixin.MP SDK 微信公众平台开发教程(三):微信公众平台开发验证
- Senparc.Weixin.MP SDK 微信公众平台开发教程(四):Hello World
- Senparc.Weixin.MP SDK 微信公众平台开发教程(五):使用Senparc.Weixin.MP SDK
- Senparc.Weixin.MP SDK 微信公众平台开发教程(六):了解MessageHandler
- Senparc.Weixin.MP SDK 微信公众平台开发教程(七):解决用户上下文(Session)问题
- Senparc.Weixin.MP SDK 微信公众平台开发教程(八):通用接口说明
- Senparc.Weixin.MP SDK 微信公众平台开发教程(九):自定义菜单接口说明
- Senparc.Weixin.MP SDK 微信公众平台开发教程(十):多客服接口说明
- Senparc.Weixin.MP SDK 微信公众平台开发教程(十一):高级接口说明
- Senparc.Weixin.MP SDK 微信公众平台开发教程(十二):OAuth2.0说明
- Senparc.Weixin.MP SDK 微信公众平台开发教程(十三):地图相关接口说明
- Senparc.Weixin.MP SDK 微信公众平台开发教程(十四):请求消息去重
- Senparc.Weixin.MP SDK 微信公众平台开发教程(十五):消息加密
- Senparc.Weixin.MP SDK 微信公众平台开发教程(十六):AccessToken自动管理机制
- Senparc.Weixin.MP SDK 微信公众平台开发教程(十七):个性化菜单接口说明
- Senparc.Weixin.MP SDK 微信公众平台开发教程(十八):Web代理功能
Senparc.Weixin.MP SDK 微信公众平台开发教程(五):使用Senparc.Weixin.MP SDK相关推荐
- Senparc.Weixin.MP SDK 微信公众平台开发教程(十一):高级接口说明
这里所说的高级接口是指面向通过认证的服务号开通的高级功能. 高级功能大致可以分类为: 用户接口 分组接口 客服接口(有别于之前介绍的多客服) 群发接口 多媒体接口 二维码接口 模板消息接口(不是所有账 ...
- Senparc.Weixin.MP SDK 微信公众平台开发教程(十八):Web代理功能
在Senparc.Weixin.dll v4.5.7版本开始,我们提供了Web代理功能,以方便在受限制的局域网内的应用可以顺利调用接口. 有关的修改都在Senparc.Weixin/Utilities ...
- Senparc.Weixin.MP SDK 微信公众平台开发教程(九):自定义菜单接口说明
Senparc.Weixin.MP SDK 微信公众平台开发教程(九):自定义菜单接口说明 原文:Senparc.Weixin.MP SDK 微信公众平台开发教程(九):自定义菜单接口说明 上一篇&l ...
- Senparc.Weixin.MP SDK 微信公众平台开发教程(十六):AccessToken自动管理机制
在<Senparc.Weixin.MP SDK 微信公众平台开发教程(八):通用接口说明>中,我介绍了获取AccessToken(通用接口)的方法. 在实际的开发过程中,所有的高级接口都需 ...
- Senparc.Weixin.MP SDK 微信公众平台开发教程(六):了解MessageHandler
原文地址为: Senparc.Weixin.MP SDK 微信公众平台开发教程(六):了解MessageHandler 上一篇<Senparc.Weixin.MP SDK 微信公众平台开发教程( ...
- Senparc.Weixin.MP SDK 微信公众平台开发教程(二十二):如何安装 Nuget(dll) 后使用项目源代码调试...
最近碰到开发者问:我使用 nuget 安装了 Senparc.Weixin SDK,但是有一些已经封装好的过程想要调试,我又不想直接附加源代码项目,这样就没有办法同步更新了,我应该怎么办? 这其实是一 ...
- 转载收藏之用 - 微信公众平台开发教程(三):微信公众平台开发验证
要对接微信公众平台的"开发模式",即对接到自己的网站程序,必须在注册成功之后(见Senparc.Weixin.MP SDK 微信公众平台开发教程(一):微信公众平台注册),等待官方 ...
- 微信支付(企业付款到个人微信零钱账户)微信公众平台开发教程(6)
微信支付(企业付款到个人微信零钱账户)微信公众平台开发教程(6 简介 开发步骤 后端代码实现 简介 Senparc.Weixin SDK 是由盛派网络(Senparc)团队自主研发的针对微信各模块的 ...
- 微信公众平台开发教程(二) 基本原理及消息接口
微信公众平台开发教程(二) 基本原理及消息接口 一.基本原理 在开始做之前,大家可能对这个很感兴趣,但是又比较茫然.是不是很复杂?很难学啊? 其实恰恰相反,很简单.为了打消大家的顾虑,先简单介绍了微信 ...
- 微信公众平台开发教程(一) 微信公众账号注册流程
微信公众平台开发教程(一) 微信公众账号注册流程 具体的操作步骤 1.注册公众账号 注册地址:http://mp.weixin.qq.com/ 1)首先需要邮箱注册: 2)邮箱激活.邮箱将会收到激活邮 ...
最新文章
- 什么是接口幂等性?为什么会产生这个问题?如何保证接口幂等性?
- python小项目推荐项目-推荐 10 个有趣的 Python 项目
- 【292天】跃迁之路——程序员高效学习方法论探索系列(实验阶段50-2017.11.24)...
- 中国电子云发布专属云CECSTACK 以全栈信创赋能千行百业
- java mysql 配置_Java连接MySQL数据库详细分析
- 用聚合数据API快速写出小程序
- 用mysql搭建蚂蚁笔记_利用蚂蚁笔记搭建个人云笔记/博客
- 微信小程序——车牌键盘js+css
- C语言实现EEPROM程序读取24C02成功读取方案单片机用
- Python数据类型——逻辑值详解
- 用例图、功能模块图和数据库的区别
- console,控制台也能玩出花样(console操作大全)
- 深度神经网络之Keras(二)——监督学习:回归
- ChatGPT 火爆“出圈”,谷歌员工慌了!CEO 回应:我们也有,担心声誉才没上
- python干货分享/网址总结
- FPGA 开发项目参考
- 【C语言】复试系列问题
- linux添加ip白名单_centOS7 下利用iptables配置IP地址白名单的方法
- 大数据技术包括哪些内容?
- 深度学习 从零开始 —— 神经网络(七又二分之一)卷积优化结构,阿猫阿狗识别,优化步骤结果