微信开发从未如此简单-饭前甜点之公众号的“你问我答”

世间万物,纷繁复杂。如何在一个纷繁复杂的世界中,找到问题最简单的解决方案,每每是人们追求的目标。然而,老是会有一些游戏规则的掌控者将简单的问题复杂化。好比,“伟大”而又“使人抓狂”的微信,微信的伟大是不能否认的,它改变了绝大多数人生活方式,工做方式。而之因此说微信使人抓狂,是由于凡是看过微信文档的开发者广泛存在的心声。web

有将简单问题复杂化的,那就有将复杂问题简单化的,好比说,众多微信开发者,精确的说应该是众多竭尽全力的利用本身的经验,开源微信平台sdk的开发者。而我很荣幸能成为其中名不见经传的一员。json

微信公众平台使人抓狂的是晦涩难懂的文档,以及简陋的sdk,这也成了不少微信开发者入门时最大的门槛。而做为其中一员的我,也深有体会,从2013年第一次接触微信公众平台开发至今,微信的文档我翻了无数次,也正是由于如此,2015年时,很荣幸能将本身踩的微信的坑分享给你们(个人第一本书出版),不过,因为才疏学浅,能力有限,并无很好的成为将复杂问题简单化的简单方案。时过境迁,而今开源社区中出现多了众多开发者,也不乏一些优秀的sdk,不过,并无出现一款可让用户脱离官方文档、简单上手的sdk,因此这也就成为了个人一个目标,但愿能作出一款简单方便、稳定快捷的微信sdk,WeShare.Weixin。后端

废话讲完,下面就来看看干货吧。看一下内容以前,须要一个前提,那就是你须要具备C#开发基础,由于笔者不才,入行以来,除C#以外,并无深刻研究第二种后端开发语言。至因而否看过微信文档、是否拥有微信开发者经验,这都不重要。api

工欲善其事必先利其器。作微信公众平台开发,没有微信公众号是万万不能的。因此开发以前,你可使用官方提供的微信测试号https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login)进行开发测试,或自行申请个公众号(具体申请流程见微信官网)。后面的内容我会同时使用测试号和微信服务号进行演示。另外,你可能还须要一个域名映射的工具,好比花生壳,或ngrok,用于在开发测试时,将微信服务器的请求映射到开发环境,方便调试。安全

其实,微信公众平台最让人很差理解的就是微信的消息机制,在这里,我不讲什么原理,我以前的文章中也讲过原理,不过部分人并不在意原理,他们在乎的是快速实现我须要的功能。因此,本次的内容就是给你们提供一个几行代码就能实现公众号消息处理机制的功能。下面的代码示例中,我将分别使用.net4的webform、.net4.5的mvc和.net core2+进行演示,这是目前我所能想到,而且能作到的.netweb开发的框架选型。服务器

首先,新建解决方案。分别在解决方案中建立以上三种框架的web项目。以下图所示:微信

使用nuget给每一个项目都安装WeShare.WeiXin.Mp微信开发

咱们先从WebMvc开始演示。 个人WebMvc项目我选择的是webapi模板,建立完成后,须要更改默认的路由模板为以下方式:mvc

config.MapHttpAttributeRoutes();

config.Routes.MapHttpRoute(

name: "DefaultApi",

routeTemplate: "api/{controller}/{action}/{id}",

defaults: new { id = RouteParameter.Optional }

);

  

而后新建控制器。名字随便取。我命名为WxController,而后再控制器中添加action,命名为MessageHandler。app

再而后新建类,命名为MsgHandler,并继承BaseMsgHandler抽象类。而后在MessageHandler方法中添加注册公众平台消息handler的方法,以下所示:

[HttpGet, HttpPost]

public HttpResponseMessage MessageHandler()

{

var result = HttpContext.Current.Register<MsgHandler>(new EnterParamConfig

{

appid = "",

EncodingAESKey = "",

token = ""

});

return new HttpResponseMessage { Content = new StringContent(result) };

}

  

其中,须要将上述代码中的appid,EncodingAESKey(若是不启动安全模式,此参数能够不配置。),token(token为接入服务器的口令,此参数可随便填写,但进行接口配置时须要填入这里填的token,注意此参数的保密。)替换成你本身公众号的对应信息。

至此代码部分已经完成,下面将演示微信公众平台后台的配置。若想微信平台接入上面写的代码,那就须要提供一个公网能够访问的地址。下面就先演示下怎样使用花生壳访问本地的web服务。首先打开项目的目录。

打开iis,添加网站,物理路径就填入项目的更目录路径。端口号能够随便填,ip地址设置为127.0.0.1,只要没有被其余应用占用。以下图所示:

而后配置花生壳的映射服务。

点击内网穿透,添加内网映射,以下图所示:

其中,内网主机和内网端口填写在iis中建立网站时填写的内容。肯定后,可看到外网的地址。

此时,经过外网访问你的接口,http://ypyle.xicp.net/api/wx/MessageHandler,若是响应的是"签名验证失败",则表示配置成功。

而后登录微信平台,我先使用微信测试号测试。以下图:

 

填好url和token后,点击提交按钮,若是提示“配置成功”,则表示微信公众平台接入已经配置成功了。

如今微信用户发送给公众号的信息将被转发到接口配置里填写的url。下面我们经过简单配置实现消息的接收与回复。

在MsgHandler类中,重写TextHandler,用于接收微信用户发送的文本类型的消息。而后调用ResponseTxt方法,回复文本消息给用户。代码以下:

public override string TextHandler(TextMsg msg)

       {

           return msg.ResponseTxt($"你发送的内容是:{msg.Content},当前时间:{DateTime.Now}");

       }

  

而后你就能够试着给你的公众号发送消息啦。

下面再简单给你们演示下webform框架的接入以及.net core中的接入。

先说webfrom,webform中,我们使用ashx处理请求。在项目中,新建wx.ashx文件。和上面说的mvc方式同样,先建立MsgHandler类,并继承BaseMsgHandler基类,而后在wx.ashx添加以下代码:

 

public void ProcessRequest(HttpContext context)

       {

           var result = HttpContext.Current.Register<MsgHandler>(new EnterParamConfig

           {

               appid = "wxd7008116979a800d",

               EncodingAESKey = "",

               token = "weixintoken"

           });

           context.Response.Write(result);

       }

  

这样就完成了代码阶段,测试的方式和上面提到的mvc方式同样,在此就不在赘余。

而后就是.net core中的配置,和mvc的方式也很类似。代码阶段就不赘余呢,须要的朋友能够关注公众号获取这次示例的代码下载连接。

这里我只简单说下花生壳域名映射的配置。.net core中的web项目就简单多了,只需编辑launchSettings.json文件中的iisExpress节点便可。以下所示:本博文到此就结束了,因为sdk还有部分接口没有完成,文章中使用nuget导入的开发包将在一周内进行开源,请关注微信公众号获此本次博文的示例代码。

本博文到此就结束了,因为sdk还有部分接口没有完成,文章中使用nuget导入的开发包将在一周内进行开源,请关注微信公众号获此本次博文的示例代码。回复doc1,获取下载连接。

 

相关文章
相关标签/搜索