nodejs微信公众号开发——3.封装消息响应模块

上一篇文章：nodejs微信公众号开发(2)自动回复，实现了简单的关注回复。采用拼接字符串的形式，并不是很方便，这里我们将其封装承接口。(项目github地：https://github.com/Panfen/wem... )

1. ejs模板引擎

不使用拼接字符串的方式，那么模板引擎就是较好的选择。Nodejs开源模板的选择很多，程序中使用 EJS，有Classic ASP/PHP/JSP的经验用起EJS来的确可以很自然，也就是说，你能够在 <%...%> 块中安排 JavaScript 代码，利用最传统的方式 <%=输出变量%>（另外 <%-输出变量是不会对 & 等符号进行转义的）。
EJS 模板快速入门

2. heredoc

在php、python中都有heredoc方式的字符串定义方法，JavaScript也实现了heredoc模块，主要解决大量字符串拼接问题。
新建模板文件tpl.js:

'use strict'

var ejs = require('ejs');
var heredoc = require('heredoc');

var tpl = heredoc(function(){/*
    <xml>
        <ToUserName><![CDATA[<%= toUserName %>]]></ToUserName>
        <FromUserName><![CDATA[<%= fromUserName %>]]></FromUserName>
        <CreateTime><%= createTime%></CreateTime>
        <MsgType><![CDATA[<%= msgType %>]]></MsgType>
        <% if(msgType ==='text') { %>
            <Content><![CDATA[<%= content %>]]></Content>
        <% }else if(msgType ==='image'){ %>
            <Image>
                <MediaId><![CDATA[<%= content.mediaId %>]]></MediaId>
            </Image>
        <% }else if(msgType ==='voice'){ %>
            <Voice>
                <MediaId><![CDATA[<%= content.mediaId %>]]></MediaId>
            </Voice>
        <% } else if(msgType ==='video'){ %>
            <Video>
                <MediaId><![CDATA[<%= content.mediaId %>]]></MediaId>
                <Title><![CDATA[<%= content.title %>]]></Title>
                <Description><![CDATA[<%= content.description %>]]></Description>
            </Video>     
        <% } else if(msgType ==='music'){ %>
            <Music>
                <Title><![CDATA[<%= content.title %>]]></Title>
                <Description><![CDATA[<%= content.description %>]]></Description>
                <MusicUrl><![CDATA[<%= content.musicUrl %>]]></MusicUrl>
                <HQMusicUrl><![CDATA[<%= content.hqMusicUrl %>]]></HQMusicUrl>
                <ThumbMediaId><![CDATA[<%= content.thumbMediaId %>]]></ThumbMediaId>    
            </Music>
        <% } else if(msgType ==='news'){ %>
            <ArticleCount><%= content.length %></ArticleCount>
            <Articles>
                <% content.forEach(function(item){ %>
                <item>
                    <Title><![CDATA[<%= item.title %>]]></Title> 
                    <Description><![CDATA[<%= item.description %>]]></Description>
                    <PicUrl><![CDATA[<%= item.picUrl %>]]></PicUrl>
                    <Url><![CDATA[<%= item.url %>]]></Url>
                </item>
                <% }) %>
            </Articles>
        <% } %>    
    </xml>
*/});

var compiled = ejs.compile(tpl);

exports = module.exports = {
    compiled:compiled
};
 

3. 处理接收到的消息

修改generator.js中之前直接回复消息的那部分代码，我们将处理回复内容的逻辑交给业务层，等其处理完毕，继续执行下面的代码，封装消息内容成xml并回复出去。

var message = util.formatMessage(content.xml);
        
this.weixin = message;  //挂载消息

yield handler.call(this,next);   //转到业务层逻辑

wechat.replay.call(this);  //真正回复

4.业务层的处理逻辑

app.js里面中间件的使用方式修改为：

var weixin = require('./weixin');
...
app.use(wechat(config.wechat,weixin.reply)); 

weixin.reply即generator.js中的handler,我们将公众号业务成的逻辑都写在weixin.js里面，如回复消息、将来的爬取电影网站信息、支付等。

exports.reply = function* (next){
    var message = this.weixin;

    if(message.MsgType === 'event'){
        if(message.Event === 'subscribe'){
            if(message.EventKey) console.log('扫描二维码关注：'+message.EventKey+' '+message.ticket);
            this.body = '终于等到你，还好我没放弃';
        }else if(message.Event === 'unsubscribe'){
            this.body = '';
            console.log(message.FromUserName +' 悄悄地走了...');
        }
    }else{
        //
    }

    yield next;
}

5.回复消息

我们在Wechat原型链上增加replay方法：

Wechat.prototype.replay = function(){
    var content = this.body;
    var message = this.weixin;

    var xml = util.tpl(content,message);

    this.status = 200;
    this.type = 'application/xml';
    this.body = xml;
}

这样实现了wechat.replay.call(this); 的回复消息功能。我们打印一下this.body的内容：

6.总结

上面代码已经基本实现了消息的封装，回复规则和回复内容写在业务层代码weixin.js中，里面简单的实现了关注和取关的事件处理。
由于koa框架是基于ES6，里面充斥了大量的Promise、genarator、yield等内容，对ES6不了解的，可以学习一下阮一峰的著作：《ECMAScript 6 入门》