插播:微信小程序类库
https://github.com/JeffreySu/WxOpen
目录
- 微信C# SDK
- 贡献代码
- 如何使用.net core开发
- 资源
- 关注测试账号(SenparcRobot)
- 项目文件夹说明(src文件夹下)
- Senparc.Weixin.MP.Sample中的关键代码说明
- 使用Nuget安装到项目中
- 已实现功能
- 捐助
- 图书众筹
- License
# | 模块功能 | DLL | Nuget |
---|---|---|---|
1 | 基础库 | Senparc.Weixin.dll | |
2 | 微信公众号 / 小程序 / 微信支付 / JSSDK / 摇周边 / 等等 | Senparc.Weixin.MP.dll | |
3 | ASP.NET MVC 扩展 | Senparc.Weixin.MP.MVC.dll | |
4 | 微信企业号 | Senparc.Weixin.QY.dll | |
5 | 微信开放平台 | Senparc.Weixin.Open.dll | |
6 | Redis 分布式缓存 | Senparc.Weixin.Cache.Redis.dll | |
7 | Memcached 分布式缓存 | Senparc.Weixin.Cache.Memcached.dll | |
8 | 微信小程序 | Senparc.Weixin.WxOpen.dll |
本库为.NET4.5,其他.NET版本请看各自分支(DotNET-Core、.NET 4.0等)。
- 已经支持所有微信6 API,包括自定义菜单/个性化菜单、模板信息接口、素材上传接口、群发接口、多客服接口、支付接口、微小店接口、卡券接口等等。
- 已经支持用户会话上下文(解决服务器无法使用Session处理用户信息的问题)。
- 已经全面支持微信公众号、企业号、开放平台的最新API。
- 已经支持分布式缓存及缓存策略扩展。
目前官方的API都已完美集成,除非有特殊说明,所有升级都会尽量确保向下兼容,所以已经发布的版本请放心使用或直接升级(覆盖)最新的DLLs。
如何使用.NET Core开发
.NET Framework 版本及 .NET Core 版本代码分别位于 master 和 DotNET-Core 分支下, 结构保持了高度一致。
Senparc.Weixin SDK已经针对.NET Core进行了优化,.NET Core 的开发过程和.NET Framework几乎是一样的, 所有的接口、方法、命名规则和架构设计也都保持了高度的一致。
由于.NET Core对某些特性支持正在完善中,目前.NET Core版本暂未提供分布式缓存有关的功能以及Senpar.Weixin.Open.dll。 除此以外的所有库都已在Nuget包中支持,可以直接使用(同一个Nuget包同时支持.NET 4.0/4.5/Core,安装后程序会自动根据项目环境适配)。
以下所有介绍以 .NET Framework 版本为例。
贡献代码
如果需要使用或修改此项目的源代码,建议先Fork。也欢迎将您修改的通用版本Pull Request过来。
- Fork
- 创建您的特性分支 (
git checkout -b my-new-feature
) - 提交您的改动 (
git commit -am 'Added some feature'
) - 将您的修改记录提交到远程
git
仓库 (git push origin my-new-feature
) - 然后到 github 网站的该
git
远程仓库的my-new-feature
分支下发起 Pull Request
资源
- 官网地址:http://weixin.senparc.com/
- Demo 地址:http://sdk.weixin.senparc.com/
- 微信开发系列教程:http://www.cnblogs.com/szw/archive/2013/05/14/weixin-course-index.html
- 微信技术交流社区:http://weixin.senparc.com/QA
- 自定义菜单在线编辑工具:http://sdk.weixin.senparc.com/Menu
- 在线消息测试工具:http://sdk.weixin.senparc.com/SimulateTool
- 缓存测试工具:http://sdk.weixin.senparc.com/Cache/Test
- chm帮助文档下载:http://sdk.weixin.senparc.com/Document
- 源代码及最新更新:https://github.com/JeffreySu/WeiXinMPSDK
- 微信开发资源集合:https://github.com/JeffreySu/WeixinResource
- 技术交流QQ群(目前未满可加:
3群
、12群
,其他群均已满):
1群:300313885,2群:293958349,
3群:342319110
,4群:372212092,5群:377815480
6群:425898825,7群:482942254,8群:106230270,9群:539061281,11群:553198593
10群(Redis / Memcached 分布式缓存群):只加已经在使用的开发者。发送申请及截图至 zsu@senparc.com 或QQ:498977166,标题:Senparc.Weixin.Cache 加群申请
12群(微信小程序):108830388
-
业务联系QQ:498977166
-
新浪微博:@苏震巍
如果这个项目对您有用,我们欢迎各方任何形式的捐助,也包括参与到项目代码更新或意见反馈中来。谢谢!
资金捐助:进入
###关注测试账号(SenparcRobot): ![qrcode] [qrcode]: http://sdk.weixin.senparc.com/Images/qrcode.jpg
项目文件夹说明(src文件夹下)
文件夹 | 说明 |
---|---|
Senparc.Weixin.Cache | Senparc.Weixin.Cache.Memcached.dll 、 Senparc.Weixin.Cache.Redis.dll 等分布式缓存扩展方案 |
Senparc.Weixin.MP.BuildOutPut | 所有最新版本DLL发布文件夹 |
Senparc.Weixin.MP.MvcExtension | Senparc.Weixin.MP.MvcExtension.dll源码,为MVC4.0项目提供的扩展包。 |
Senparc.Weixin.MP.Sample | 可以直接发布使用的Demo(ASP.NET MVC 4.0) |
Senparc.Weixin.MP.Sample.WebForms | 可以直接发布使用的Demo(ASP.NET WebForms) |
Senparc.Weixin.MP | Senparc.Weixin.MP.dll 微信公众账号SDK源代码 |
Senparc.Weixin.QY | Senparc.Weixin.QY.dll 微信企业号SDK源代码 |
Senparc.Weixin.Open | Senparc.Weixin.Open.dll 第三方开放平台SDK源代码 |
Senparc.Wiexin | 所有Senparc.Weixin.[x].dll 基础类库源代码 |
Senparc.Weixin.MP.Sample中的关键代码说明
注:这是MVC项目,WebForms项目见对应Demo中的Weixin.aspx。
###/Controllers/WeixinController.cs 下面的Token需要和微信公众平台后台设置的Token同步,如果经常更换建议写入Web.config等配置文件(实际使用过程中两列建议使用数字+英文大小写改写Token,Token一旦被破解,微信请求将很容易被伪造!):
public readonly string Token = "weixin";
下面这个Action(Get)用于接收并返回微信后台Url的验证结果,无需改动。地址如:http://domain/Weixin或http://domain/Weixin/Index
/// <summary>
/// 微信后台验证地址(使用Get),微信后台的“接口配置信息”的Url填写如:http://weixin.senparc.com/weixin
/// </summary>
[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 + ","
+ MP.CheckSignature.GetSignature(postModel.Timestamp, postModel.Nonce, Token) + "。" +
"如果你在浏览器中看到这句话,说明此地址可以被作为微信公众账号后台的Url,请注意保持Token一致。");
}
}
上述方法中的PostModel是一个包括了了Signature、Timestamp、Nonce(由微信服务器通过请求时的Url参数传入),以及AppId、Token、EncodingAESKey等一系列内部敏感的信息(需要自行传入)的实体类,同时也会在后面用到。
下面这个Action(Post)用于接收来自微信服务器的Post请求(通常由用户发起),这里的if必不可少,之前的Get只提供微信后台保存Url时的验证,每次Post必须重新验证,否则很容易伪造请求。
/// <summary>
/// 用户发送消息后,微信平台自动Post一个请求到这里,并等待响应XML
/// </summary>
[HttpPost]
[ActionName("Index")]
public ActionResult Post(PostModel postModel)
{
if (!CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token))
{
return Content("参数错误!");
}
...
}
###如何处理微信公众账号请求? Senparc.Weixin.MP提供了2中处理请求的方式,传统方法及使用MessageHandler处理方法(推荐)。上面两个方法在wiki中已经有比较详细的说明,这里简单举例MessageHandler的处理方法。
MessageHandler的处理流程非常简单:
[HttpPost]
[ActionName("Index")]
public ActionResult Post(PostModel postModel)
{
if (!CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token))
{
return Content("参数错误!");
}
postModel.Token = Token;
postModel.EncodingAESKey = EncodingAESKey;//根据自己后台的设置保持一致
postModel.AppId = AppId;//根据自己后台的设置保持一致
var messageHandler = new CustomMessageHandler(Request.InputStream, postModel);//接收消息(第一步)
messageHandler.Execute();//执行微信处理过程(第二步)
return new FixWeixinBugWeixinResult(messageHandler);//返回(第三步)
}
整个消息除了postModel的赋值以外,接收(第一步)、处理(第二步)、返回(第三步)分别只需要一行代码。
上述代码中的CustomMessageHandler是一个自定义的类,继承自Senparc.Weixin.MP.MessageHandler.cs。MessageHandler是一个抽象类,包含了执行各种不同请求类型的抽象方法(如文字,语音,位置、图片等等),我们只需要在自己创建的CustomMessageHandler中逐个实现这些方法就可以了。刚建好的CustomMessageHandler.cs如下:
using System;
using System.IO;
using Senparc.Weixin.MP.MessageHandlers;
using Senparc.Weixin.MP.Entities;
namespace Senparc.Weixin.MP.Sample.CustomerMessageHandler
{
public class CustomMessageHandler : MessageHandler<MessageContext>
{
public public CustomMessageHandler(Stream inputStream, PostModel postModel, int maxRecordCount = 0)
: base(inputStream, postModel, maxRecordCount)
{
}
public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage)
{
//ResponseMessageText也可以是News等其他类型
var responseMessage = CreateResponseMessage<ResponseMessageText>();
responseMessage.Content = "这条消息来自DefaultResponseMessage。";
return responseMessage;
}
public override IResponseMessageBase OnTextRequest(RequestMessageText requestMessage)
{
//...
}
public override IResponseMessageBase OnVoiceRequest(RequestMessageVoice requestMessage)
{
//...
}
//更多没有重写的OnXX方法,将默认返回DefaultResponseMessage中的结果。
....
}
}
其中OnTextRequest、OnVoiceRequest等分别对应了接收文字、语音等不同的请求类型。
比如我们需要对文字类型请求做出回应,只需要完善OnTextRequest方法:
public override IResponseMessageBase OnTextRequest(RequestMessageText requestMessage)
{
//TODO:这里的逻辑可以交给Service处理具体信息,参考OnLocationRequest方法或/Service/LocationSercice.cs
var responseMessage = CreateResponseMessage<ResponseMessageText>();
responseMessage.Content =
string.Format(
"您刚才发送了文字信息:{0}",
requestMessage.Content);
return responseMessage;
}
这样CustomMessageHandler在执行messageHandler.Execute()的时候,如果发现请求信息的类型是文本,会自动调用以上代码,并返回代码中的responseMessage作为返回信息。responseMessage可以是IResponseMessageBase接口下的任何类型(包括文字、新闻、多媒体等格式)。
从v0.4.0开始,MessageHandler增加了对用户会话上下文的支持,用于解决服务器上无法使用Session管理用户会话的缺陷。详见:用户上下文WeixinContext和MessageContext
使用Nuget安装到项目中
###如何处理微信公众号请求?
-
命令:
PM> Install-Package Senparc.Weixin.MP
###如何增强 ASP.NET MVC 项目的功能? Senparc.Weixin.MP.MVC 针对 ASP.NET MVC 项目做了更多的优化,包括便捷的浏览器环境判断、官方 bug 修复等。
-
Nuget 地址:https://www.nuget.org/packages/Senparc.Weixin.MP.MVC
-
命令:
PM> Install-Package Senparc.Weixin.MP.MVC
###如何处理微信企业号请求? Senparc.Weixin.QY.dll对企业号相关功能进行了封装,操作过程和微信公众账号SDK(Senparc.Weixin.MP)保持了一致。
-
命令:
PM> Install-Package Senparc.Weixin.QY
###如何处理微开放平台请求? Senparc.Weixin.Open.dll对目前所有的开放平台API进行了封装,消息处理过程和微信公众账号SDK(Senparc.Weixin.MP)保持了一致,其他一些特殊的消息流程请先阅读官方的文档,然后对照Senparc.Weixin.MP.Sample中有关Open的Demo进行开发。
-
命令:
PM> Install-Package Senparc.Weixin.Open
###如何使用分布式缓存? Senparc.Weixin SDK 提供了完善的缓存策略接口,默认使用本机缓存实现,同时也提供了 Redis 和 Memcached 两个扩展方案,您也可以根据相同的规则添加自己的缓存策略。
- Redis 缓存扩展包 Nuget 地址:https://www.nuget.org/packages/Senparc.Weixin.Cache.Redis
- 命令:
PM> Install-Package Senparc.Weixin.Senparc.Weixin.Cache.Redis
- Memcached 缓存扩展包 Nuget 地址:https://www.nuget.org/packages/Senparc.Weixin.Cache.Memcached
- 命令:
PM> Install-Package Senparc.Weixin.Senparc.Weixin.Cache.Memcached
已实现功能
- 微信公众号 - [x] 接收/发送消息(事件) - [x] 自定义菜单 & 个性化菜单 - [x] 消息管理 - [x] OAuth授权 - [x] JSSDK - [x] 微信支付 - [x] 用户管理 - [x] 素材管理 - [x] 账号管理 - [x] 带参数二维码 - [X] 长链接转短链接接口 - [ ] 微信认证事件推送 - [x] 数据统计 - [x] 微信小店 - [x] 微信卡券 - [x] 卡券事件推送 - [ ] 买单事件推送 - [ ] 会员卡内容更新事件推送 - [ ] 库存报警事件推送 - [ ] 券点流水详情事件推送 - [x] 微信门店 - [x] 微信智能 - [x] 微信设备功能 - [x] 多客服功能 - [x] 微信摇一摇周边 - [x] 微信连WI-FI(未完整) - [x] 微信扫一扫(商家) - [ ] 扫一扫事件推送 - [ ] 打开商品主页事件推送 - [ ] 关注公众号事件推送 - [ ] 进入公众号事件推送 - [ ] 地理位置信息异步推送 - [ ] 商品审核结果推送
- 微信开放平台 - [x] 网站应用 - [x] 公众号第三方平台
- 微信企业号 - [x] 管理通讯录 - [x] 管理素材文件 - [x] 管理企业号应用 - [x] 接收消息与事件 - [x] 发送消息 - [x] 自定义菜单 - [x] 身份验证接口 - [x] JSSDK - [x] 第三方应用授权 - [x] 第三方回调协议 - [ ] 授权成功推送auth_code事件 - [ ] 通讯录变更通知 - [x] 企业号授权登陆 - [x] 企业号微信支付 - [x] 企业回话服务 - [ ] 企业会话回调 - [x] 企业摇一摇周边 - [ ] 企业卡券服务 - [ ] 卡券事件推送 - [x] 企业客服服务 - [ ] 客服回复消息回调
- 缓存策略 - [x] 策略扩展接口 - [x] 本地缓存 - [x] Redis 扩展包 - [x] Memcached 扩展包
欢迎开发者对未完成或需要补充的模块进行 Pull Request!
捐助
如果这个项目对您有用,我们欢迎各方任何形式的捐助,也包括参与到项目代码更新或意见反馈中来。谢谢!
资金捐助:
![donate] [donate]: http://sdk.weixin.senparc.com/Images/T1nAXdXb0jXXXXXXXX_s.png
图书众筹
扫描下方二维码参与《微信公众平台快速开发》图书众筹
![CrowdFunding]
[CrowdFunding]: http://sdk.weixin.senparc.com/images/crowdfunding-qrcode.png
License
FreeBSD License
Copyright (c) 2016, Jeffrey Su <www.jeffrey.su@gmail.com>, Suzhou Senparc Network Technology Co.,Ltd.
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
The views and conclusions contained in the software and documentation are those
of the authors and should not be interpreted as representing official policies,
either expressed or implied, of the FreeBSD Project.
via https://github.com/JeffreySu/WeiXinMPSDK/blob/master/license.md