微信公众开发——使用消息接口 推荐



南苑随笔app

之前写了一篇搭建sae的python平台，通过微信公众平台验证的博文。现在就是要承上启下，开始开发的第一步。也许你会说开发的第一步就是写代码。那我会对你表示鄙视，尽管南苑随笔是个很简单的应用，但是多少也还需要设计一下。确定一下需求，为了将来能够吸引到粉丝来关注我的公众号，我必须要定位好我的app，然后提供优秀的内容，并确定它的运营模式，才能进一步地提升我们的应用水准。

需求分析

首先，这个app是要用python写的，那么就一定要优雅一点，pythonic一点。对于我自己来说，我要使得这个app至少能够满足我阅读若干与南苑相关的文章的要求才行。故而需要对南苑随笔进行需求分析：

定位： 为南苑或者外校同学提供我们在南苑生活和学习的文章。文体不限，内容形式包括{图片，语音，文字}，推送给用户，这正是微信能够提供给我的。

约定： 允许投稿，但是投稿必须通过管理员的审核。其实很大程度上，我们是为了向粉丝们推介 @bibo-果冻 和 @daoluan-郑思愿 合作的那本《南苑随笔——IT小小鸟外传》。

内容： 校园生活，学习，感情，分享，趣味，摄影，文学作品，简单社交 ，歌曲等等。

服务： 提供每1天/2天定期推送文章或语音。同时相应用户发来的请求，对用户请求进行分析后返回所要求的内容。

性能： 要求服务器在5秒内返回用户的请求内容，在网络差的时候，这个就难说了。能够同时处理至少20位粉丝的请求（其实到底有没有这么多粉丝发来请求，我心里还是没有数啊）。

系统设计

这次，我吸取了上次的经验教训，要先完成逻辑和数据的设计，最后才去设计我们的交互界面（包括交互方式和菜单）。数据先行，那么一切就从构建起数据库开始。参照wordpress的博客数据库，就可以设计出基本的数据库框架。这部分就交给 @daoluan-思愿 来搞定，我相信他会完成的相当出色。

本系统需要一个博客系统，和一个微信服务app,博客系统作为web端，用浏览器可访问的。而微信app则负责推送到用户的微信帐号聊天界面。故而我们的数据库设计就很清晰了，需要:

user表——用户
post表——文章
blog配置——博客的设置
category表——分类
———————————次要———————————
url表——友情链接
guest_book表——留言簿

而我需要用到的仅仅是博客系统数据库的一个子集——post表和guest_book表（也许会用到category表）。故而开发微信app则只需要自行创建两个表进行实验即可。

发送消息试验

暂且不把设计逻辑排到日程上来，我们来尝试一下在第三方服务器和微信服务器，以及客户端进行通信。假如用户发送来一个请求，由于已经绑定了URL，且开启了开发模式，那么就微信服务器就会转发这个请求到我们的服务器，我们的服务器要解析这个请求，然后返回所请求的内容。

我们需要一个类来处理get请求，以及定时向微信服务器传送群发的文章。
该类 weixin_scnuwriter设计如下：

handle_request(request) # 处理请求
parse_request_xml(xml) # 解析请求
response_msg(request) # 响应请求（关键逻辑部分）
pack_text_xml(post_msg, response_msg) # 打包响应的文本内容，需要参考微信API，供response_msg调用

# 另外在数据库方面要能够读取，需要django于数据库打交道，不过我们暂时不实现，只是做一个简单的测试。

下面是handle_request代码：

我们之前写认证的时候，都是直接将url导向到check_signature直接进行响应处理，但是这里我们对请求的类型进行区分，因为验证的时候发送的是GET请求，而对我们自己的服务器推送消息的时候，它是使用POST请求的，因为POST方法可以向服务器发送大量的数据（表单提交，文件上传等），在这里是xml结构。记得要在urls里面配置一个到handle_request的映射，我的是：“ url(r'^$', handle_request), ”。逗号是不能丢的。

handle_request需要调用check_signature,之前我们用了return HttpResponse(echoStr)来验证，但是我们把HttpResponse的封装放到了handle_request中，那么我们就只需在check_signature中返回echoStr就行了，当然，验证一次就行了，现在已经进入开发阶段，这函数将用不到。其实应该在一开始，我们就应该像现在一样写。check_signature如下：

很明显15行变了。浏览器和服务器之间，并不是简单的传递数据，还有解析包的过程，服务器返回一个http类型的文档，浏览器要进行协议解析，读取头部等东西，进而解析出整个文档。这就是为什么需要在返回的时候包装成HttpResponse，否则浏览器读不懂，django就报错说：返回的不是一个httpresponse类型的对象。我曾经参考《linux C 编程指南》写过一个简单的服务器程序，服务器程序，发送了固定的头部，然后对各种不同类型的返回打印不同的文档，例如404，503等等，而对于正常情况，则读取一个html文件予以返回。协议与就是相互商量好的约定，故而协议一般都约定了要以什么开头，或者按照协议里写的东西来解析。

下面是parse_request_xml函数，用来解析请求，该请求来自微信服务器，包含了一个xml结构，使用的是POST方法，待会我们就用个工具来测试一下怎么模拟POST请求，而不使用微信发送（微信发送需要经过微信服务器，而且我们不知道错在哪里）。

很明显，对于一个xml结构（其实是一个字符串），进行解析，就需要用到它的tag，来区分到底是什么内容，以及获取对应tag的内容，放到python我们程序中的一个字典结构里。

下面是response_msg函数：

消息回应，这里的逻辑很简单，对于hello，就返回一个hello to you too, 其他则返回 how are you , unkown。将来用户如果发来“第一篇”等请求，我们将返回完整的图文消息。这部分是有待开发的。

上面的回应函数用到了打包返回消息成xml这样的功能，pack_text_xml函数如下：

可以看到text_tpl其实就是微信API内容的一个——返回text，就是聊天记录一样的文本。对于其它内容，有其他内容的模板，可以到微信公众帐号API察看。这里需要说明的是xml结构里面要填参数的地方，都有一个占位符号%s，表示的是一个字符串。然后对于模板，填如我们的参数。如第12行所示。

poster测试

好了，我们可以开始测试了。我google了一下，有人说使用firefox的poster插件，非常好用。于是我就在firefox下装了一个，来模拟各种各样不同的http请求。首先，要有一个firefox浏览器，ubuntu现在是自带了，无需安装，如果没有可以去官网下载。然后安装poster，点这里，找到了poster插件，在firefox安装就行了。好了，我们可以模拟微信服务器发送我们的消息转发了，如下：



使用时，填入post请求时发送的xml,还有你的服务器的url，例如我的是: http://scnuwriter.sinaapp.com 然后点post，就可以看到下面的画面：



可以看到我们的服务器返回了 hello to you too,这是和我们的程序相符合的。但是可能你得到的是一个403fobidden。我google了一下，stack overflow里面说，那可能是因为我们没有启用跨站请求，以防止攻击，具体参考python的csrf文档。后来我修改了settings.py文件里面的middleware配置：

很奇怪，我去掉第8行CsrfResponseMiddleware之后，服务器就出错了。故而我注释了它，然后在views.py的最前面的函数前面加上一个：@csrf_exempt 。结果就行了，得到上面截图的内容。要深入了解这是为什么，还需要了解web的更多信息，还有django的官方文档，bibo也要好好充电了，知其然，不知其所以然，不可谓为知也。

最后

好吧，用svn上传你的成果到服务器上吧，用手机来测试。一般用post得到了正确回应都不会有错的。bibo在自己的手机微信上面发送了一个"hello"，真的收到了一个"hello to you too"。第一次尝试微信编程，居然成功了！yeah。而且还学会了一个工具poster。

by bibodeng 2013-04-19 士别三日，当刮目相看

scnuwriter示例下载链接：http://vdisk.weibo.com/s/y9wJz 主要看views.py