Senparc.Weixin.MP SDK 微信公众平台开发教程（五）：使用Senparc.Weixin.MP SDK

时间 2019-11-18

标签 senparc.weixin.mp senparc weixin sdk 微信公众平台开发教程使用繁體版

原文原文链接

Senparc.Weixin.MP SDK 已经涵盖了微信 6.x 的几乎全部公共 API。html

整个项目的源代码以均可以在这个项目中获取到：https://github.com/JeffreySu/WeiXinMPSDKgit

PS：因为微信 API 以及 Senparc.Weixin SDK一直在不断升级更新，最新的代码及 Demo 以上面的 GitHub 中的源代码为准。github

咱们如今从无到有创建一个ASP.NET MVC 项目，来看一下如何与微信进行对接（Webforms 原理也都是同样，只不过把 Controller 中的 Action 换成 .aspx 页面就能够了，可参考 Demo）。web

将要演示的项目源代码也能够在开源项目中找到。由于源代码中要兼顾多个不一样 .net 版本的项目，所以有一个公用项目（CommonService），因此与下面展现的结构略有不一样，不过逻辑彻底一致：json

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 项目：

一、打开global.asax.cs文件

二、在 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);

三、参考 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 项目：

一、打开 Startup.cs 文件（可参考 Demo）

二、在 ConfigureServices() 方法中加入：

        public void ConfigureServices(IServiceCollection services)
        {
            //...
            services.AddSenparcGlobalServices(Configuration)//Senparc.CO2NET 全局注册
                    .AddSenparcWeixinServices(Configuration);//Senparc.Weixin 注册
        }

三、修改 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)
        }

四、在 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