一、序言
一直在想第一次写博客,应该写点什么好?正好最近在研究微信公众平台开发,索性就记录下,分享下自己的心得,也分享下本人简单模仿asp.net运行机制所写的通用的微信公众平台开发.Net(c#)框架吧。由于本人知识有限、文字组织能力有限,如有错误或不足,请多多指教!
二、微信公众平台.Net(C#)框架介绍
运行流程:WeiXinRequestHandler.ashx接收微信服务器post请求,创建WeiXinApplication实例,构造函数中设置WeiContext(WeiXinRequest,WeiXinResponse)请求上下文属性,执行WeiXinApplication的GetResponseXml()方法,使用WeiXinHandlerFactory工厂类动态加载程序集,遍历程序集里的Type集合,反射获取控制器中的WeiXinMsgType属性值判断是否与请求消息上下文WeiXinRequest的WeiXinMsgType属性值一致创建相对应的消息处理控制器实例,并返回这个实例,赋值给WeiXinApplication中IWeiXinHandler属性值,调用ProcessWeiXin(WeiXinContext context)方法,执行完毕后,返回WeiXinResponse对象中的响应消息。
三、微信公众平台注册/接入相关事宜
1、注册:
填写基本信息,激活邮箱,登记信息......公众号信息。值得一提的是:目前个人只允许注册订阅号,公司单位才能注册服务号,服务号可以实现自定义菜单;公众号名称一经确认就无法修改!
2、接入:(必须条件:拥有自己的公网可访问的服务器)
①、成为开发者:在公众平台网站的高级功能 – 开发模式页,点击“成为开发者”按钮,根据官方文档填写相关接口配置信息并提交。
②、验证url有效性:开发者提交信息后,微信服务器将发送GET请求到填写的URL上,GET请求携带四个参数:
参数 | 描述 |
---|---|
signature | 微信加密签名,signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。 |
timestamp | 时间戳 |
nonce | 随机数 |
echostr | 随机字符串 |
开发者通过检验signature对请求进行校验(下面有校验方式)。若确认此次GET请求来自微信服务器,请原样返回echostr参数内容,则接入生效,成为开发者成功,否则接入失败。
加密/校验流程如下: 1. 将token、timestamp、nonce三个参数进行字典序排序 2. 将三个参数字符串拼接成一个字符串进行sha1加密 3. 开发者获得加密后的字符串可与signature对比,标识该请求来源于微信
验证工具类:UtilityHelper
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
#region 检查加密签名是否一致 - public static bool CheckSignature(string signature, string timestamp, string nonce) /// <summary> /// 检查加密签名是否一致 /// </summary> /// <param name="signature">微信加密签名</param> /// <param name="timestamp">时间戳</param> /// <param name="nonce">随机数</param> /// <returns></returns> public static bool CheckSignature( string signature, string timestamp, string nonce) { List< string > stringList = new List< string > {Token, timestamp, nonce}; // 字典排序 stringList.Sort(); return Sha1Encrypt( string .Join( "" , stringList)) == signature; } #endregion #region 对字符串SHA1加密 - public static string Sha1Encrypt(string targetString) /// <summary> /// 对字符串SHA1加密 /// </summary> /// <param name="targetString">源字符串</param> /// <returns>加密后的十六进制字符串</returns> private static string Sha1Encrypt( string targetString) { byte [] byteArray = Encoding.Default.GetBytes(targetString); HashAlgorithm hashAlgorithm = new SHA1CryptoServiceProvider(); byteArray = hashAlgorithm.ComputeHash(byteArray); StringBuilder stringBuilder = new StringBuilder(); foreach ( byte item in byteArray) { stringBuilder.AppendFormat( "{0:x2}" , item); } return stringBuilder.ToString(); } #endregion #region 根据加密类型对字符串SHA1加密 - public static string Sha1Encrypt(string targetString, string encryptType) /// <summary> /// 根据加密类型对字符串SHA1加密 /// </summary> /// <param name="targetString">源字符串</param> /// <param name="encryptType">加密类型:MD5/SHA1</param> /// <returns>加密后的字符串</returns> private static string Sha1Encrypt( string targetString, string encryptType) { return FormsAuthentication.HashPasswordForStoringInConfigFile(targetString, encryptType); } #endregion |
四、微信公众平台运行原理介绍
五、结束
字穷了...~~~!附源码吧。看web.config,打开Test.html进行测试。添加自己的消息控制器必须继承WeiXinHandlerType,程序集生成插件目录bin/WeiXinPlugins。
源码下载:WeiXin.Framework