微信公号开发实战之智能翻译

一时失言乱红尘 2022-05-25 13:57 183阅读 0赞

本篇文章为大家演示如何在微信公众帐号上实现“智能翻译”，本例中翻译功能是通过调用“[百度翻译API][API]”实现的。智能翻译是指用户任意输入想要翻译的内容（单词或句子），系统能自动识别用户采用的语言，并将其翻译为其他语言，目前支持的翻译方向：中->英、英->中和日->中。下面我们来看看智能翻译最终做出来的效果：

[![wKioJlKCZNjieziqAACInfiH4tQ331.jpg-wh_651x-s_834015387.jpg][]][wKioJlKCZNjieziqAACInfiH4tQ331.jpg-wh_651x-s_834015387.jpg][![wKioOVKCZO7QD3WfAACNZugVR5Y799.jpg][]][wKioOVKCZO7QD3WfAACNZugVR5Y799.jpg]

我们通过输入关键词“翻译”或者点击菜单“翻译”能够看到该功能的使用帮助，然后输入“翻译+内容”就能对内容进行翻译了。

**百度翻译API介绍**

点击查看[百度翻译API使用说明][API]，其实这份文档已经说的很详细了，笔者只是将我们调用该接口时最关心的内容摘取出来，主要如下：

1）通过发送HTTP GET请求调用百度翻译API。

2）百度翻译API请求地址：

1.  http://openapi.baidu.com/public/2.0/bmt/translate

3）调用API需要传递from、to、client\_id和q四个参数，描述如下：

<table> 
 <tbody> 
  <tr> 
   <th>key</th> 
   <th>value</th> 
   <th>描述</th> 
  </tr> 
  <tr> 
   <td>from</td> 
   <td>源语言语种：语言代码或auto</td> 
   <td>仅支持特定的语言组合，下面会单独进行说明</td> 
  </tr> 
  <tr> 
   <td>to</td> 
   <td>目标语言语种：语言代码或auto</td> 
   <td>仅支持特定的语言组合，下面会单独进行说明</td> 
  </tr> 
  <tr> 
   <td>client_id</td> 
   <td>开发者在百度连接平台上注册得到的授权API key</td> 
   <td><a href="http://developer.baidu.com/wiki/index.php?title=%E5%B8%AE%E5%8A%A9%E6%96%87%E6%A1%A3%E9%A6%96%E9%A1%B5/%E7%BD%91%E7%AB%99%E6%8E%A5%E5%85%A5/%E5%85%A5%E9%97%A8%E6%8C%87%E5%8D%97" rel="nofollow">请阅读如何获取api key</a></td> 
  </tr> 
  <tr> 
   <td>q</td> 
   <td>待翻译内容</td> 
   <td>该字段必须为UTF-8编码，并且以GET方式调用API时，需要进行urlencode编码。</td> 
  </tr> 
 </tbody> 
</table>

在调用接口前，我们要先获取到api key。获取方式比较简单，根据提示一步步操作就可以，笔者就不再赘述了。  
4）对于智能翻译，参数from和to的传都是auto。  
4）参数q的编码方式为UTF-8，传递之前要进行urlencode编码。

5）接口返回结果示例如下：

1.  \{ "from":"en","to":"zh","trans\_result":\[\{ "src":"today","dst":"\\u4eca\\u5929"\}\]\}

返回结果里的中文是unicode编码，需要通过json\_decode进行转换，转换后的示例如下：

1.  \{ 
2.      "from": "en", 
3.      "to": "zh", 
4.      "trans\_result": \[ 
5.          \{ 
6.              "src": "today", 
7.              "dst": "今天" 
8.          \}, 
9.          \{ 
10.             "src": "tomorrow", 
11.             "dst": "明天" 
12.         \} 
13.     \] 
14. \}

**JSON处理工具包Gson介绍**

Gson是Google提供的用于在Java对象和JSON数据之间进行转换的Java类库。通过使用Gson类库，我们可以将JSON字符串转成Java对象，反之亦然。下载地址：[https://code.google.com/p/google-gson/downloads/list][https_code.google.com_p_google-gson_downloads_list]，Gson的使用比较简单，直接调用它的方法toJson()或fromJson()就能完成相应的转换，但需要注意的是：在使用Gson将json字符串转换成Java对象之前，需要先创建好与目标Java对象。读者可以在维基百科上学习它的使用示例[http://zh.wikipedia.org/wiki/Gson][http_zh.wikipedia.org_wiki_Gson]。

**代码实现**

1）创建与百度翻译API返回的JSON相对应的Java类

1.  **import** java.util.List; 
2.   
3.  /\*\* 
4.   \* 调用百度翻译api查询结果 
5.   \*  
6.   \* @author liufeng 
7.   \* @date 2013-10-21 
8.   \*/ 
9.  **public** **class** TranslateResult \{ 
10.     // 实际采用的源语言 
11.     **private** String from; 
12.     // 实际采用的目标语言 
13.     **private** String to; 
14.     // 结果体 
15.     **private** List<ResultPair> trans\_result; 
16.  
17.     **public** String getFrom() \{ 
18.         **return** from; 
19.     \} 
20.  
21.     **public** **void** setFrom(String from) \{ 
22.         **this**.from = from; 
23.     \} 
24.  
25.     **public** String getTo() \{ 
26.         **return** to; 
27.     \} 
28.  
29.     **public** **void** setTo(String to) \{ 
30.         **this**.to = to; 
31.     \} 
32.  
33.     **public** List<ResultPair> getTrans\_result() \{ 
34.         **return** trans\_result; 
35.     \} 
36.  
37.     **public** **void** setTrans\_result(List<ResultPair> trans\_result) \{ 
38.         **this**.trans\_result = trans\_result; 
39.     \} 
40. \}

注意：这里的类名可以任意取，但是成员变量的名字应于翻译API返回的JSON字符串中的属性名保持一致，否则将JSON转换成TranslateResult对象时会报错。

TranslateResult类中的trans\_result属性是一个ResultPair集合，该类的代码如下：

1.  /\*\* 
2.   \* 结果对 
3.   \*  
4.   \* @author liufeng 
5.   \* @date 2013-10-21 
6.   \*/ 
7.  **public** **class** ResultPair \{ 
8.      // 原文 
9.      **private** String src; 
10.     // 译文 
11.     **private** String dst; 
12.  
13.     **public** String getSrc() \{ 
14.         **return** src; 
15.     \} 
16.  
17.     **public** **void** setSrc(String src) \{ 
18.         **this**.src = src; 
19.     \} 
20.  
21.     **public** String getDst() \{ 
22.         **return** dst; 
23.     \} 
24.  
25.     **public** **void** setDst(String dst) \{ 
26.         **this**.dst = dst; 
27.     \} 
28. \}

说明：这两个类的封装是Gson类库所要求的，如果读者不是用Gson解析json字符串，而是用JSON-lib，就没有必要封装这两个类。

2）接口调用** **

1.  **import** java.io.BufferedReader; 
2.  **import** java.io.InputStream; 
3.  **import** java.io.InputStreamReader; 
4.  **import** java.io.UnsupportedEncodingException; 
5.  **import** java.net.HttpURLConnection; 
6.  **import** java.net.URL; 
7.  **import** com.google.gson.Gson; 
8.   
9.  /\*\* 
10.  \*  
11.  \* @author liufeng 
12.  \* @date 2013-10-21 
13.  \*/ 
14. **public** **class** BaiduTranslateService \{ 
15.     /\*\* 
16.      \* 发起http请求获取返回结果 
17.      \*  
18.      \* @param requestUrl 请求地址 
19.      \* @return 
20.      \*/ 
21.     **public** **static** String httpRequest(String requestUrl) \{ 
22.         StringBuffer buffer = **new** StringBuffer(); 
23.         **try** \{ 
24.             URL url = **new** URL(requestUrl); 
25.             HttpURLConnection httpUrlConn = (HttpURLConnection) url.openConnection(); 
26.  
27.             httpUrlConn.setDoOutput(**false**); 
28.             httpUrlConn.setDoInput(**true**); 
29.             httpUrlConn.setUseCaches(**false**); 
30.  
31.             httpUrlConn.setRequestMethod("GET"); 
32.             httpUrlConn.connect(); 
33.  
34.             // 将返回的输入流转换成字符串 
35.             InputStream inputStream = httpUrlConn.getInputStream(); 
36.             InputStreamReader inputStreamReader = **new** InputStreamReader(inputStream, "utf-8"); 
37.             BufferedReader bufferedReader = **new** BufferedReader(inputStreamReader); 
38.  
39.             String str = **null**; 
40.             **while** ((str = bufferedReader.readLine()) != **null**) \{ 
41.                 buffer.append(str); 
42.             \} 
43.             bufferedReader.close(); 
44.             inputStreamReader.close(); 
45.             // 释放资源 
46.             inputStream.close(); 
47.             inputStream = **null**; 
48.             httpUrlConn.disconnect(); 
49.  
50.         \} **catch** (Exception e) \{ 
51.         \} 
52.         **return** buffer.toString(); 
53.     \} 
54.  
55.     /\*\* 
56.      \* utf编码 
57.      \*  
58.      \* @param source 
59.      \* @return 
60.      \*/ 
61.     **public** **static** String urlEncodeUTF8(String source) \{ 
62.         String result = source; 
63.         **try** \{ 
64.             result = java.net.URLEncoder.encode(source, "utf-8"); 
65.         \} **catch** (UnsupportedEncodingException e) \{ 
66.             e.printStackTrace(); 
67.         \} 
68.         **return** result; 
69.     \} 
70.  
71.     /\*\* 
72.      \* 翻译（中->英 英->中 日->中 ） 
73.      \*  
74.      \* @param source 
75.      \* @return 
76.      \*/ 
77.     **public** **static** String translate(String source) \{ 
78.         String dst = **null**; 
79.  
80.         // 组装查询地址 
81.         String requestUrl = "http://openapi.baidu.com/public/2.0/bmt/translate?client\_id=AAAAAAAAAAAAAAAAAAAAAAAA&q=\{keyWord\}&from=auto&to=auto"; 
82.         // 对参数q的值进行urlEncode utf-8编码 
83.         requestUrl = requestUrl.replace("\{keyWord\}", urlEncodeUTF8(source)); 
84.  
85.         // 查询并解析结果 
86.         **try** \{ 
87.             // 查询并获取返回结果 
88.             String json = httpRequest(requestUrl); 
89.             // 通过Gson工具将json转换成TranslateResult对象 
90.             TranslateResult translateResult = **new** Gson().fromJson(json, TranslateResult.**class**); 
91.             // 取出translateResult中的译文 
92.             dst = translateResult.getTrans\_result().get(0).getDst(); 
93.         \} **catch** (Exception e) \{ 
94.             e.printStackTrace(); 
95.         \} 
96.  
97.         **if** (**null** == dst) 
98.             dst = "翻译系统异常，请稍候尝试！"; 
99.         **return** dst; 
100.     \} 
101.  
102.     **public** **static** **void** main(String\[\] args) \{ 
103.         // 翻译结果：The network really powerful 
104.         System.out.println(translate("网络真强大")); 
105.     \} 
106. \}

代码解读：

1）第21-53行封装了一个http请求方法httpRequest()，相信读过之前教程的读者已经很熟悉了。

2）第61-69行封装了一个urlEncodeUTF8()方法，用于对url中的参数进行UTF-8编码。

3）第81行代码中的client\_id需要替换成自己申请的api key。

4）第83行代码是对url中的中文进行编码。以后凡是遇到通过url传递中文参数的情况，一定要显示地对中文进行编码，否则很可能出现程序在本机能正常运行，但部署到服务器上却有问题，因为本机与服务器的默认编码方式可能不一样。

5）第88行代码就是调用百度翻译API。

6）第90行代码是使用Gson工具将json字符串转换成TranslateResult对象，是不是发现Gson的使用真的很简单？另外，前面提到过调用百度翻译API返回的json里如果有中文是用unicode表示的，形如“\\u4eca\\u5929”，那为什么这里没有做任何处理？因为Gson的内部实现已经帮我们搞定了。

**公众账号后台调用**

在公众账号后台，需要对接收到的文本消息进行判断，如果是以“翻译”两个字开头的，就认为是在使用智能翻译功能，然后将“翻译”两个字之后的内容作为翻译对象，调用API进行翻译；如果输入的只有“翻译”两个字，就提示智能翻译功能的使用指南。关键代码如下：

1.  // 文本消息  
2.  **if** (WeixinUtil.REQ\_MESSAGE\_TYPE\_TEXT.equals(msgType)) \{ 
3.      String content = requestMap.get("Content").trim(); 
4.      **if** (content.startsWith("翻译")) \{ 
5.          String keyWord = content.replaceAll("^翻译", "").trim(); 
6.          **if** ("".equals(keyWord)) \{ 
7.              textMessage.setContent(getTranslateUsage()); 
8.          \} **else** \{ 
9.              textMessage.setContent(BaiduTranslateService.translate(keyWord)); 
10.         \} 
11.         out.print(WeixinUtil.textMessageToXml(textMessage)); 
12.     \} 
13. \}

第7行getTranslateUsage()方法得到的就是智能翻译功能的使用指南，代码如下：

1.  /\*\* 
2.   \* Q译通使用指南 
3.   \*  
4.   \* @return 
5.   \*/ 
6.  **public** **static** String getTranslateUsage() \{ 
7.      StringBuffer buffer = **new** StringBuffer(); 
8.      buffer.append(XiaoqUtil.emoji(0xe148)).append("Q译通使用指南").append("\\n\\n"); 
9.      buffer.append("Q译通为用户提供专业的多语言翻译服务，目前支持以下翻译方向：").append("\\n"); 
10.     buffer.append("    中 -> 英").append("\\n"); 
11.     buffer.append("    英 -> 中").append("\\n"); 
12.     buffer.append("    日 -> 中").append("\\n\\n"); 
13.     buffer.append("使用示例：").append("\\n"); 
14.     buffer.append("    翻译我是中国人").append("\\n"); 
15.     buffer.append("    翻译dream").append("\\n"); 
16.     buffer.append("    翻译さようなら").append("\\n\\n"); 
17.     buffer.append("回复“?”显示主菜单"); 
18.     **return** buffer.toString(); 
19. \}

说明：希望通过本例的学习，除了掌握百度翻译API的调用之外，读者还能够掌握json字符串的解析方法，这样就能够自己学会调用更多互联网上开放的接口。

[API]: http://developer.baidu.com/wiki/index.php?title=%E5%B8%AE%E5%8A%A9%E6%96%87%E6%A1%A3%E9%A6%96%E9%A1%B5/%E7%99%BE%E5%BA%A6%E7%BF%BB%E8%AF%91/%E7%BF%BB%E8%AF%91API
[wKioJlKCZNjieziqAACInfiH4tQ331.jpg-wh_651x-s_834015387.jpg]: http://s4.51cto.com/wyfs01/M02/32/79/wKioJlKCZNjieziqAACInfiH4tQ331.jpg-wh_651x-s_834015387.jpg
[wKioOVKCZO7QD3WfAACNZugVR5Y799.jpg]: /images/20220525/7151a753b82c40e58a9ac5148ce38ec5.png
[https_code.google.com_p_google-gson_downloads_list]: https://code.google.com/p/google-gson/downloads/list
[http_zh.wikipedia.org_wiki_Gson]: http://zh.wikipedia.org/wiki/Gson