转载收藏之用 - 微信公众平台开发教程（五）：使用Senparc.Weixin.MP SDK

Senparc.Weixin.MP SDK已经涵盖了微信5.0的所有公共API，以及2013年10月29日升级之后大部分实用的接口。

整个项目的源代码以及已经编译好的程序集可以在这个项目中获取到：https://github.com/JeffreySu/WeiXinMPSDK

我们现在从无到有建立一个ASP.NET MVC项目，来看一下如何与微信进行对接（Webforms原理也都是一样，只不过把Controller中的Action换成.aspx页面就可以了）。

将要演示的项目源代码也可以在开源项目中找到（因为源代码中要兼顾2个项目，有一个公用项目，所以与下面展示的结构略有不同，逻辑完全一致）：

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(4.0)项目，项目名称如Senparc.Weixin.MP.Sample

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using Senparc.Weixin.MP.MvcExtension;
using Senparc.Weixin.MP.Sample.Weixin;

namespace Senparc.Weixin.MP.Sample.Controllers
{
public class WeixinController : Controller
{
private const string Token = "weixin";//对应微信后台设置的Token，建议设置地复杂一些

/// <summary>
/// 微信后台验证地址（使用Get），微信后台的“接口配置信息”的Url填写如：http://weixin.senparc.com/weixin
/// </summary>
[HttpGet]
[ActionName("Index")]
public ActionResult Get(string signature, string timestamp, string nonce, string echostr)
{
if (CheckSignature.Check(signature, timestamp, nonce, Token))
{
return Content(echostr);//返回随机字符串则表示验证通过
}
else
{
return Content("failed:" + signature + "," + CheckSignature.GetSignature(timestamp, nonce, Token));
}
}

[HttpPost]
[ActionName("Index")]
public ActionResult Post(string signature, string timestamp, string nonce, string echostr)
{
if (!CheckSignature.Check(signature, timestamp, nonce, Token))
{
return Content("参数错误！");
}

var messageHandler = new CustomMessageHandler(Request.InputStream);//接收消息

messageHandler.Execute();//执行微信处理过程

return new WeixinResult(messageHandler);//返回结果
}
}
}

View Code
第一个Get对应微信后台设置URL时候的请求，第二个Post用于接受么次转发过来的客户请求。

其中CustomMessageHandler是我们自己创建的一个类，用于实现MessageHandler（有关MessageHandler的详细介绍可以看《Senparc.Weixin.MP SDK 微信公众平台开发教程（六）：了解MessageHandler》，也可以看这里），所有处理微信消息的核心逻辑都被包含到CustomMessageHandler中执行。除了承担处理微信响应的任务，MessageHandler还实现了处理单个用户对话上下文等功能，非常方便。

至此，整个Senparc.Weixin.MP SDK已经基本开发完毕，可以直接发布，并在微信后台使用“高级功能”对接了。

例如上述代码，Url填写http://xxx/Weixin，Token填写weixin

（如何在微信后台设置请看：Senparc.Weixin.MP SDK 微信公众平台开发教程（三）：微信公众平台开发验证）

接下去我们会介绍如何在MessageHandler中处理具体的微信请求（文字、图片、位置、语音等等）。

　本人参考该教程编写了一个微信公众平台服务平台小云吞微管理，网址: http://www.xiaoyuntun.com