Senparc.Weixin.MP SDK 微信公众平台开发教程(五):使用Senparc.Weixin.MP SDK

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

    整个项目的源代码以都可以在这个项目中获取到:GitHub - JeffreySu/WeiXinMPSDK: 微信全平台 SDK Senparc.Weixin for C#,支持 .NET Framework 及 .NET Core、.NET 6.0、.NET 7.0。已支持微信公众号、小程序、小游戏、微信支付、企业微信/企业号、开放平台、JSSDK、微信周边等全平台。 WeChat SDK for C#.

    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项目地址:NuGet Gallery | Senparc.Weixin.MP 16.19.2.1

  第一种方式已经足够简单(但是不建议,除非你需要修改 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”,选中最新的版本,点击右侧的【安装】按钮:

C#版的微信公众号开发SDK Senparc.Weixin.MP几个关键类介绍如下: Entities/Request*.cs 用于接收微信平台自动发送到服务器的实体(发送过来的是XML),包括文本、位置、图片三类 Entities/Response*.cs 用于反馈给发送人的信息实体(最终会转成XML),包括文本、新闻(图文)两类 Helpers/EntityHelper.cs 用于实体和XML之间的转换(由于其中有许多需要特殊处理的字段和类型,这里不能简单用XML序列化) Helpers/MsgTypeHelper.cs 用于获取消息类型 CheckSignature.cs 验证请求合法性类 Enums.cs 各种枚举 RequestMessageFactory.cs 用于自动生成不同Request类型的实体,并作必要的数据填充 Senparc.Weixin.MP几个关键类及重要方法(按一般使用过程排序) 生成验证字符串:Senparc.Weixin.MP.CheckSignature.GetSignature(string timestamp, string nonce, string token = null),返回根据微信平台提供的数据,SHA1加密后的验证字符串(注意token必须跟公众平台的设置一直) 验证请求:Senparc.Weixin.MP.CheckSignature.Check(string signature, string timestamp, string nonce, string token = null),验证请求是否合法 获取请求实体:var requestMessage = Senparc.Weixin.MP.RequestMessageFactory.GetRequestEntity(XDocument doc); 根据不同请求的类型,自动生成可用于操作的实体(doc只需要用XDocument.Parse(xmlString)就能生成),requestMessage.MsgType就是请求枚举类型。 进行判断及各类操作。 根据需要,创建响应类型的实体,如:var responseMessage = ResponseMessageBase.CreateFromRequestMessage(requestMessage, ResponseMsgType.Text) as ResponseMessageText; 即可返回文本类型信息。 由于目前微信只接受XML的返回数据,所以在返回之前还需要做一次转换:XDocument responseDoc = Senparc.Weixin.MP.Helpers.EntityHelper.ConvertEntityToXml(responseMessage); var xmlString =responseDoc.ToString();
<think>好的,我现在需要帮助用户解决如何使用Senparc.Weixin.Open库获取微信开放平台的component_verify_ticket的问题。首先,我需要回顾用户提供的引用内容,看看有没有相关的信息。 用户提供了三个引用,其中引用[3]提到在.net web api中接收推送的component_verify_ticket,并可以将其保存在缓存、数据库或文件中。这说明component_verify_ticket是通过微信开放平台推送过来的,而不是主动获取的。因此,步骤应该是配置接收推送的消息,然后从中提取并存储这个票据。 接下来,我需要考虑Senparc.Weixin.Open库中的相关类和方法。引用[1]提到了WeixinOpenException,可能和异常处理有关,但这不是当前问题的重点。引用[2]提到CustomThirdPartyMessageHandlers用于接收和解析消息,这应该与处理微信推送的component_verify_ticket有关。 用户的问题是如何获取component_verify_ticket,根据微信开放平台的流程,第三方平台需要提供一个接收消息的URL,微信服务器会定期推送component_verify_ticket到这个URL。因此,使用Senparc库时,需要设置一个Controller来处理这个推送,并使用CustomThirdPartyMessageHandlers来解析消息。 然后,我需要检查是否需要注册第三方平台信息,例如ComponentBag,这在引用[1]的WeixinOpenException中有提到ComponentBag属性,可能用于存储平台相关信息。注册信息可能需要AppId、密钥等。 另外,引用[3]提到将component_verify_ticket存储在缓存中,这可能涉及到Senparc的缓存机制,比如使用Cache或数据库存储。用户需要在自己的代码中处理接收到的票据,并保存到合适的存储介质中。 可能还需要配置消息处理程序,确保能够正确解析微信推送的XML数据,并从中提取component_verify_ticket。处理完成后,返回成功响应给微信服务器,以避免重复推送。 总结步骤应该是:配置接收URL的Controller,使用CustomThirdPartyMessageHandlers解析消息,提取票据并存储。同时,需要注册第三方平台信息,确保库能正确处理请求。 现在需要验证这些步骤是否正确,是否有遗漏。比如是否需要配置中间件或路由,确保请求能正确路由到Controller。另外,处理消息时是否需要验证签名,这部分Senparc库可能已经封装好了,用户只需关注处理逻辑。 可能还需要参考Senparc的官方文档,确保代码示例的正确性。例如,处理推送消息的Controller可能继承自特定的基类,或者使用特定的属性标记路由。 最后,确保用户了解component_verify_ticket的有效期较长,但仍需定期检查更新,避免过期导致的问题。</think>要通过 Senparc.Weixin.Open 获取微信开放平台的 component_verify_ticket,需通过以下步骤实现: --- ### 一、配置接收推送的 Controller 1. **创建消息接收接口** 在 Web API 中创建用于接收微信推送的 Controller,继承 `WeixinOpenController`: ```csharp public class WeixinOpenController : Senparc.Weixin.Open.Containers.ThirdPartyMessageHandler.WeixinOpenController { // 处理 component_verify_ticket 推送 public override ActionResult Post(string postModel) { var messageHandler = new CustomThirdPartyMessageHandler(Request.InputStream, postModel); messageHandler.Execute(); // 执行消息解析 return Content("success"); // 必须返回 success } } ``` 2. **注册路由** 确保路由配置中包含该接口(如 `/WeixinOpen`),需与微信开放平台后台设置的**授权事件接收URL**一致[^3]。 --- ### 二、实现消息处理器 使用 `CustomThirdPartyMessageHandler` 解析 XML 消息: ```csharp public class CustomThirdPartyMessageHandler : ThirdPartyMessageHandler { public CustomThirdPartyMessageHandler(Stream inputStream, string postModel) : base(inputStream, postModel) { } public override IResponseMessageBase OnComponentVerifyTicketRequest(RequestMessageComponentVerifyTicket requestMessage) { // 提取 component_verify_ticket var componentVerifyTicket = requestMessage.ComponentVerifyTicket; // 存储到缓存(示例使用 Senparc 缓存) CacheStrategyFactory.GetObjectCacheStrategyInstance().Set( "ComponentVerifyTicket", componentVerifyTicket, TimeSpan.FromMinutes(20)); // 根据实际情况设置过期时间[^3] return new SuccessResponseMessage(); } } ``` --- ### 三、注册第三方平台信息 在全局启动时注册组件信息: ```csharp var componentAppId = "第三方平台AppId"; var componentSecret = "第三方平台AppSecret"; var componentToken = "令牌"; var componentEncodingAESKey = "消息加解密Key"; ComponentContainer.Register( componentAppId, componentSecret, componentToken, componentEncodingAESKey); ``` --- ### 四、获取已存储的 component_verify_ticket 后续通过缓存或数据库读取: ```csharp var componentVerifyTicket = CacheStrategyFactory.GetObjectCacheStrategyInstance().Get<string>("ComponentVerifyTicket"); ``` --- 相关问题
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值