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

世间万物,纷繁复杂。如何在一个纷繁复杂的世界中,找到问题最简单的解决方案,往往是人们追求的目标。然而,总是会有一些游戏规则的掌控者将简单的问题复杂化。比如,“伟大”而又“令人抓狂”的微信,微信的伟大是不可否认的,它改变了绝大多数人生活方式,工作方式。而之所以说微信令人抓狂,是因为凡是看过微信文档的开发者普遍存在的心声。

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

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

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

工欲善其事必先利其器。做微信公众平台开发,没有微信公众号是万万不能的。所以开发之前,你可以使用官方提供的微信测试号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模板,创建完成后,需要更改默认的路由模板为如下方式:

config.MapHttpAttributeRoutes();

config.Routes.MapHttpRoute(

name: "DefaultApi",

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

defaults: new { id = RouteParameter.Optional }

);

  

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

再然后新建类,命名为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,获取下载链接。

 

 
 
 
posted @ 2018-12-31 15:43  billsking  阅读(1070)  评论(2编辑  收藏  举报