最近寫了一個(gè)微信的翻譯機(jī)器人。用戶只要關(guān)注該微信號(hào)，發(fā)送英文的消息，就能收到中文翻譯的回復(fù)。后臺(tái)是用Node.js寫的，托管在 OpenShift的Paas平臺(tái)上。翻譯過程實(shí)際上是調(diào)用微軟的Bing translation API做的，代碼中用到了alexu84的bing-translate和JacksonTian的wechat這兩個(gè)npm模塊。下面把做的過程詳細(xì)說一下。

1. 微信公眾號(hào)開發(fā)

首先是要到 https://mp.weixin.qq.com 申請(qǐng)一個(gè)公眾號(hào)，并申請(qǐng)成為開發(fā)者。目前個(gè)人只能申請(qǐng)訂閱號(hào)，不過訂閱號(hào)也可以和用戶進(jìn)行消息的交互，這對(duì)我們的應(yīng)用來說足夠了。

成為開發(fā)者后，微信會(huì)給你一個(gè)AppID和一個(gè)AppSecret，都是一長串的字符串。在開發(fā)我們這個(gè)應(yīng)用時(shí)，只要用到AppID。

微信客戶端會(huì)接受用戶輸入的消息，并把它們轉(zhuǎn)給我們的Web服務(wù)。所以微信會(huì)要求我們填寫我們Web服務(wù)的URL地址，Token(令牌)，EncodingAESKey(消息加解密密鑰)。頁面如下圖所示：

大致上，填寫好信息并提交后，微信服務(wù)器會(huì)發(fā)送一個(gè)GET請(qǐng)求到我們的Web服務(wù)，攜帶上Token和一個(gè)隨機(jī)字符串。我們的Web服務(wù)必須按照微信開發(fā)者文檔規(guī)定的方式處理這個(gè)請(qǐng)求，原樣返回這個(gè)隨機(jī)字符串，這樣微信服務(wù)器才認(rèn)為我們的Web服務(wù)是符合它的接入要求的。微信服務(wù)器轉(zhuǎn)發(fā)消息給我們自己的Web服務(wù)時(shí)，是以一個(gè)POST消息攜帶上一個(gè)XML數(shù)據(jù)包，我們的web服務(wù)必須解析這個(gè)XML數(shù)據(jù)包才能取得用戶發(fā)的消息。同樣，當(dāng)我們回復(fù)消息給微信服務(wù)器時(shí)，也要滿足其規(guī)定的要求。所有這些，在微信的開發(fā)者文檔中都有詳細(xì)的描述。

我們當(dāng)然可以仔細(xì)閱讀微信的 開發(fā)者文檔 ，并自己按要求一一實(shí)現(xiàn)對(duì)應(yīng)的接口，不過這樣太麻煩了:-)。更方便的方式是使用 JacksonTian的微信開發(fā)Node.js模塊 。使用這個(gè)模塊，我們只需要填入我們的Token，APPID以及EncodingAESKey，它自動(dòng)就幫我們處理好微信服務(wù)器的驗(yàn)證請(qǐng)求，并允許我們直接獲取/回復(fù)用戶的字符串消息，使我們不用處理XML數(shù)據(jù)解析等細(xì)節(jié)問題。在下文我會(huì)詳細(xì)介紹如何使用這個(gè)模塊。

2. 利用OpenShift托管Node.js Web服務(wù)

首先，我們要知道如何用Node.js開發(fā)一個(gè)Web服務(wù)。本文不打算詳細(xì)介紹這部分內(nèi)容?；旧?，利用express模塊，只需幾行代碼就可以搭起一個(gè)Web服務(wù)，像這樣：

var express = require('express'); 
 
var app = express(); 
app.listen(80); 
 
app.get('/', function (req, res) { 
    res.send("hello world'); 
}); 

搭建好web服務(wù)后，我們需要一個(gè)擁有公有IP的服務(wù)器來運(yùn)行這些代碼。在這方面，我們有很多選擇，本文使用OpenShift的應(yīng)用托管服務(wù)。

Youtube上有一個(gè)很好的 視頻 介紹如何利用OpenShift建立和發(fā)布一個(gè)Node.js應(yīng)用，step by step級(jí)別的，非常的詳細(xì)。我們只需要看前30分鐘就行了?；旧?，Openshift使用git來管理代碼開發(fā)以及發(fā)布的過程。你建立一個(gè)應(yīng)用，OpenShift就在云端為你創(chuàng)建了一個(gè)Git倉庫，包含一個(gè)示例的Node.js應(yīng)用，并把它在云端運(yùn)行起來了。我們只要把這個(gè)Git倉庫的代碼 Clone到本地，修改其中的server.js，并把修改好的代碼push到云端，Openshift就會(huì)自動(dòng)幫我們停掉當(dāng)前的示例服務(wù)，重新編譯代碼，重新發(fā)布并把我們修改過后的服務(wù)運(yùn)行起來。超級(jí)的簡單，是不是?

下面是稍微詳細(xì)一點(diǎn)的步驟：

1)安裝OpenShift的客戶端工具 rhc ，我們需要利用這個(gè)工具創(chuàng)建、發(fā)布Node.js應(yīng)用

2)在command line窗口運(yùn)行 $ rhc app create nodejs-0.10。這個(gè)命令為我們?cè)谠贫藙?chuàng)建了一個(gè)Git倉庫，把內(nèi)含的示例應(yīng)用運(yùn)行起來，并把代碼幫我們clone到了本地。

3)修改server.js，運(yùn)行：

$ git commit -am

$ git push

我們自己的web服務(wù)就在云端運(yùn)行起來了!

3. 使用bing-translate 和wechat NPM module

這一部分稍微詳細(xì)介紹一下如何修改server.js，也就是如何使用bing-translate和wechat這兩個(gè)NPM模塊的。

還是直接上代碼吧，因?yàn)榭偣簿筒坏?0行代碼。其中第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' 
      }); 
    }); 
  } 
})); 

因?yàn)槲也幌朐陂_源的代碼中明文寫上我的微信APPID等敏感信息，我又寫了一個(gè)util從Json文件中讀取這些信息。第8行是讀Bing translation app的ID和secret，第9行是讀微信的APPID等信息。這些信息都分別寫在一個(gè)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" 
} 

另外，有人可能會(huì)注意到我沒有直接使用alexu84的bing-translate模塊，而是引用了一個(gè)本地的bing- translate.js文件。這是因?yàn)槲覍?duì)該模塊的源文件做了少量的改動(dòng)，主要是在本地cache了一個(gè)Bing translation API的token，這樣就不用每次翻譯的時(shí)候都去調(diào)微軟的Web API重新拿token了，翻譯響應(yīng)的速度會(huì)大大提高。有空的時(shí)候我會(huì)把這個(gè)改動(dòng)push給alexu84試試看。

4. 關(guān)于Microsoft Bing Translation API

大家都注意到在上一部分我們要填入Bing Translation的client ID和client secret。這是因?yàn)锽ing Translation API也是一個(gè)Web服務(wù)，我們需要到這個(gè) 頁面 去申請(qǐng)一個(gè)Bing Translation的app，申請(qǐng)好后，就有了我們自己的client ID 和 secret。當(dāng)然這里可能涉及要注冊(cè)微軟的賬號(hào)什么的，這里就不贅述了。

***， 我的代碼都放到了 GitHub 上，除了把APPID和secret什么的替換成示例的字符串，其他的就和我在OpenShift上發(fā)布的代碼一模一樣了。

參考資源

1. Jose Annunziato 如何利用OpenShift 發(fā)布 Node.js應(yīng)用的視頻： 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