如何基于OpenShift進行微信公眾號開發

作者：kaige 2015-08-24 15:08:50

OpenShift是紅帽的云開發平臺即服務（PaaS）。本文介紹了一個利用OpenShift托管Node.js Web服務進行微信公眾號開發的過程。用戶只要關注該微信號，發送英文的消息，就能收到中文翻譯的回復。下面讓我們看一下詳細內容。

最近寫了一個微信的翻譯機器人。用戶只要關注該微信號，發送英文的消息，就能收到中文翻譯的回復。后臺是用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

責任編輯：Ophira 來源： cnblogs