如何基于OpenShift進行微信公眾號開發
最近寫了一個微信的翻譯機器人。用戶只要關注該微信號，發送英文的消息，就能收到中文翻譯的回復。后臺是用Node.js寫的，托管在 OpenShift的Paas平臺上。翻譯過程實際上是調用微軟的Bing translation API做的，代碼中用到了alexu84的bing-translate和JacksonTian的wechat這兩個npm模塊。下面把做的過程詳細說一下。
1. 微信公眾號開發
首先是要到 https://mp.weixin.qq.com 申請一個公眾號，并申請成為開發者。目前個人只能申請訂閱號，不過訂閱號也可以和用戶進行消息的交互，這對我們的應用來說足夠了。
成為開發者后，微信會給你一個AppID和一個AppSecret，都是一長串的字符串。在開發我們這個應用時，只要用到AppID。
微信客戶端會接受用戶輸入的消息，并把它們轉給我們的Web服務。所以微信會要求我們填寫我們Web服務的URL地址，Token(令牌)，EncodingAESKey(消息加解密密鑰)。頁面如下圖所示：
大致上，填寫好信息并提交后，微信服務器會發送一個GET請求到我們的Web服務，攜帶上Token和一個隨機字符串。我們的Web服務必須按照微信開發者文檔規定的方式處理這個請求，原樣返回這個隨機字符串，這樣微信服務器才認為我們的Web服務是符合它的接入要求的。微信服務器轉發消息給我們自己的Web服務時，是以一個POST消息攜帶上一個XML數據包，我們的web服務必須解析這個XML數據包才能取得用戶發的消息。同樣，當我們回復消息給微信服務器時，也要滿足其規定的要求。所有這些，在微信的開發者文檔中都有詳細的描述。
我們當然可以仔細閱讀微信的 開發者文檔 ，并自己按要求一一實現對應的接口，不過這樣太麻煩了:-)。更方便的方式是使用 JacksonTian的微信開發Node.js模塊 。使用這個模塊，我們只需要填入我們的Token，APPID以及EncodingAESKey，它自動就幫我們處理好微信服務器的驗證請求，并允許我們直接獲取/回復用戶的字符串消息，使我們不用處理XML數據解析等細節問題。在下文我會詳細介紹如何使用這個模塊。
2. 利用OpenShift托管Node.js Web服務
首先，我們要知道如何用Node.js開發一個Web服務。本文不打算詳細介紹這部分內容。基本上，利用express模塊，只需幾行代碼就可以搭起一個Web服務，像這樣：
- var express = require('express');
- var app = express();
- app.listen(80);
- app.get('/', function (req, res) {
- res.send("hello world');
- });
搭建好web服務后，我們需要一個擁有公有IP的服務器來運行這些代碼。在這方面，我們有很多選擇，本文使用OpenShift的應用托管服務。
Youtube上有一個很好的 視頻 介紹如何利用OpenShift建立和發布一個Node.js應用，step by step級別的，非常的詳細。我們只需要看前30分鐘就行了。基本上，Openshift使用git來管理代碼開發以及發布的過程。你建立一個應用，OpenShift就在云端為你創建了一個Git倉庫，包含一個示例的Node.js應用，并把它在云端運行起來了。我們只要把這個Git倉庫的代碼 Clone到本地，修改其中的server.js，并把修改好的代碼push到云端，Openshift就會自動幫我們停掉當前的示例服務，重新編譯代碼，重新發布并把我們修改過后的服務運行起來。超級的簡單，是不是?
下面是稍微詳細一點的步驟：
1)安裝OpenShift的客戶端工具 rhc ，我們需要利用這個工具創建、發布Node.js應用
2)在command line窗口運行 $ rhc app create nodejs-0.10。這個命令為我們在云端創建了一個Git倉庫，把內含的示例應用運行起來，并把代碼幫我們clone到了本地。
3)修改server.js，運行：
$ git commit -am
$ git push
我們自己的web服務就在云端運行起來了!
3. 使用bing-translate 和wechat NPM module
這一部分稍微詳細介紹一下如何修改server.js，也就是如何使用bing-translate和wechat這兩個NPM模塊的。
還是直接上代碼吧，因為總共就不到40行代碼。其中第18行展示了如何使用wechat，第23行展示了如何使用bing-translate。
- var express = require('express');
- var kutil = require('./util/kutil.js');
- var wechat = require('wechat');
- var server_port = process.env.OPENSHIFT_NODEJS_PORT || 8080
- var server_ip_address = process.env.OPENSHIFT_NODEJS_IP || '127.0.0.1'
- var client_id_secret = kutil.readJsonFromFile('./res/client_id_secret.json');
- var wechat_app_config = kutil.readJsonFromFile('./res/wechat_app_config.json');
- var bt = require('./util/bing-translate.js').init(client_id_secret);
- var app = express();
- app.listen(server_port, server_ip_address);
- // wechat API
- app.use(express.query());
- app.use('/wechat', wechat(wechat_app_config, function (req, res, next) {
- var message = req.weixin;
- if (message.MsgType == 'text') {
- var input_word = message.Content;
- bt.translate(input_word, 'en', 'zh-CHS', function (translate_err, translate_res) {
- if (translate_err) {
- res.reply({
- content: 'translation error',
- type: 'text'
- });
- return;
- }
- var translate_result = translate_res["translated_text"];
- res.reply({
- content: translate_result,
- type: 'text'
- });
- });
- }
- }));
因為我不想在開源的代碼中明文寫上我的微信APPID等敏感信息，我又寫了一個util從Json文件中讀取這些信息。第8行是讀Bing translation app的ID和secret，第9行是讀微信的APPID等信息。這些信息都分別寫在一個Json文件中，格式如下:
- {
- "client_id": "your-Bing-translator-app-client_id",
- "client_secret": "your-Bing-translator-app-client_secret"
- }
- {
- "token": "your_wechat_app_token",
- "appid": "your_wechat_app_appid",
- "encodingAESKey": "your_wechat_app_AESKey"
- }
另外，有人可能會注意到我沒有直接使用alexu84的bing-translate模塊，而是引用了一個本地的bing- translate.js文件。這是因為我對該模塊的源文件做了少量的改動，主要是在本地cache了一個Bing translation API的token，這樣就不用每次翻譯的時候都去調微軟的Web API重新拿token了，翻譯響應的速度會大大提高。有空的時候我會把這個改動push給alexu84試試看。
4. 關于Microsoft Bing Translation API
大家都注意到在上一部分我們要填入Bing Translation的client ID和client secret。這是因為Bing Translation API也是一個Web服務，我們需要到這個 頁面 去申請一個Bing Translation的app，申請好后，就有了我們自己的client ID 和 secret。當然這里可能涉及要注冊微軟的賬號什么的，這里就不贅述了。
***， 我的代碼都放到了 GitHub 上，除了把APPID和secret什么的替換成示例的字符串，其他的就和我在OpenShift上發布的代碼一模一樣了。
參考資源
1. Jose Annunziato 如何利用OpenShift 發布 Node.js應用的視頻： https://www.youtube.com/watch?v=wnRtA7a0ST0
2. alexu84: Bing translation API 的Node.js wrapper https://github.com/alexu84/bing-translatehttps://github.com/alexu84/bing-translate
3. JacksonTian: 微信API的Node.js wrapper https://github.com/node-webot/wechat
4. Bing Translation API: http://blogs.msdn.com/b/translation/p/gettingstarted1.aspx
5. 我的代碼示例： https://github.com/kaige/KDict/tree/master/openshift_host_code/kdict
博文出處：http://www.cnblogs.com/kaige/p/4659989.html?utm_source=tuicool
