一、序言
一直在想第一次写博客,应该写点什么好?正好最近在研究微信公众平台开发,索性就记录下,分享下自己的心得,也分享下本人简单模仿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
#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