C++中使用Curl和JsonCpp调用有道翻译API实现在线翻译

使用C++开发一个在线翻译工具，这个想法在我大脑中过了好几遍了，所以就搜了下资料，得知网络上有很多翻译API，这里我选择我平时使用较多的有道翻译API进行在线翻译工具开发的练习。翻译API返回的结果常见的有两种：xml和json格式，本文选择使用json数据来实现Berlin版本的在线翻译工具。

开发环境：Ubuntu12.04 + GCC4.7

一、 有道翻译API

API 地址：http://fanyi.youdao.com/openapi

这里我选择了数据调用接口key的申请，填入相关信息，然后系统会提供API Key和Keyfrom字段给你，同时会发送一份包含这2项的邮件到你所填写的邮箱。

有道翻译API的数据接口如下：

http://fanyi.youdao.com/openapi.do?keyfrom=<keyfrom>&key=<key>&type=data&doctype=<doctype>&version=1.1&q=要翻译的文本

版本：1.1，请求方式：get，编码方式：utf-8

主要功能：中英互译，同时获得有道翻译结果和有道词典结果（可能没有）

参数说明：

　type - 返回结果的类型，固定为data

　doctype - 返回结果的数据格式，xml或json或jsonp

　version - 版本，当前最新版本为1.1

　q - 要翻译的文本，不能超过200个字符，需要使用utf-8编码

errorCode：

　0 - 正常

　20 - 要翻译的文本过长

　30 - 无法进行有效的翻译

　40 - 不支持的语言类型

　50 - 无效的key

二、 Curl和JsonCpp的安装

2.1 Curl的安装

Curl工程主页：http://curl.haxx.se/， 目前最新版本是curl-7.34.0，下载解压后进入curl-7.34.0目录，用如下命令安装：

 cd $CURL_HOME
 mkdir build
 cd build
 cmake ..
 make

2.2 JsonCpp的安装

JsonCpp工程主页：http://jsoncpp.sourceforge.net/，目前的最新版本是jsoncpp-src-0.5.0，下载解压后进入jsoncpp-src-0.5.0，使用Scons进行安装，Scons是一个Python编译系统，没有安装的童鞋需要先安装Scons，如下：

 sudo apt-get install scons

Scons安装好之后就可以编译JsonCpp了，使用如下命令：

 scons platform=linux-gcc

好了，JsonCpp已经成功安装了，为了后面程序编译链接过程中方便，我在JsonCpp路径下的libs文件夹中设置了一个软连接，如下：

 ln -s libjson_linux-gcc-.7_libmt.a libjson_linux-gcc.a

三、 在线翻译工具

直接贴代码：

 /*
     Filename: translate.cc
     Author: BerlinSun
 */
 #include <iostream>
 #include "curl/curl.h"
 #include "json/json.h"

 using namespace std;

 void usage()
 {
     cout << "Usage: translate word_you_want_to_translate" << endl;
 }

 int writer(char *data, size_t size, size_t nmemb, string *writerData)
 {
     if (writerData == NULL)
         return ;
     int len = size*nmemb;
     writerData->append(data, len);
     return len;
 }

 int main(int argc, char *argv[])
 {
     if(argc < )
     {
         usage();
         exit();
     }
     string buffer;
     string translate_url = "http://fanyi.youdao.com/openapi.do?keyfrom=xxxxxx&key=xxxxxx&type=data&doctype=json&version=1.1&q=";
     translate_url += argv[];
     CURL * curl;
     CURLcode res;
     curl = curl_easy_init();
     if (curl)
     {
         curl_easy_setopt(curl, CURLOPT_URL, translate_url.c_str());
         curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writer);
         curl_easy_setopt(curl, CURLOPT_WRITEDATA, &buffer);
         res = curl_easy_perform(curl);
         curl_easy_cleanup(curl);
     }
     if (buffer.empty())
     {
         cout << "The server return NULL!" << endl;
         exit();
     }

     Json::Value root;
     Json::Reader reader;
     bool parsingSuccessful = reader.parse(buffer, root);

     if (!parsingSuccessful)
     {
         cout << "Failed to parse the data!" << endl;
         exit();
     }

     const Json::Value basic = root["basic"];
     const Json::Value phonetic = basic["phonetic"];
     const Json::Value explains = basic["explains"];
     cout << "Provided by Youdao dictionary!" << endl;
     cout << "-----------------------------" << endl;
     cout << argv[] << "\t英[" << phonetic.asString()  << "]" << endl;

     for(int i = ; i < explains.size(); ++i)
         cout << explains[i].asString() << endl;

     return ;
 }

PS:代码中红色加粗的部分就是你所申请到的key和keyfrom字段。

CMake文件如下：

 project(test)
 cmake_minimum_required(VERSION 2.6)

 include_directories($ENV{JSONCPP_HOME}/include $ENV{CURL_HOME}/include)
 link_directories($ENV{JSONCPP_HOME}/libs/ $ENV{CURL_HOME}/build/lib)
 add_definitions(-std=c++0x)
 set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall")

 set(source
     translate.cc)
 add_executable(translate ${source})
 target_link_libraries(translate json_linux-gcc)
 target_link_libraries(translate curl)

程序执行效果如下：

=====================================================================

补充：

之前实现这个工具的时候没有考虑汉译英，所以并没有对汉语进行测试，感谢yough90提出汉语没法翻译的问题，这个问题其实很好理解，编码问题，中文和英文使用不同的编码方式，解决方案也比较简单，libcurl提供了专门用于编码的方法:

 char *curl_easy_escape( CURL * curl , char * url , int length );

在我们检测到我们传入的参数有非ASCII编码的时候，我们调用该函数对其进行转换：

 if ((*argv[]&0x80) != )
 {
     type = ;
     char *encode_word = curl_easy_escape(curl, argv[], );
     translate_url += encode_word;
 } else {
     type = ;
 　　translate_url += argv[];
 }

由于后面显示格式会有所不同，所以我加入一个type用来记住翻译类型，好了，修改后的代码如下：

 #include <iostream>
 #include "curl/curl.h"
 #include "json/json.h"

 using namespace std;

 void usage()
 {
     cout << "Usage: translate word_you_want_to_translate" << endl;
 }

 int writer(char *data, size_t size, size_t nmemb, string *writerData)
 {
     if (writerData == NULL)
         return ;
     int len = size*nmemb;
     writerData->append(data, len);
     return len;
 }

 int main(int argc, char *argv[])
 {
     if(argc < )
     {
         usage();
         exit();
     }
     string buffer;
     string translate_url = "http://fanyi.youdao.com/openapi.do?keyfrom=xxxxxxxx&key=xxxxxxxx&type=data&doctype=json&version=1.1&q=";
     CURL * curl;
     CURLcode res;
     curl = curl_easy_init();

     int type;

     if ((*argv[]&0x80) != )
     {
         type = ;
         char *encode_word = curl_easy_escape(curl, argv[], );
         translate_url += encode_word;
     } else {
         type = ;
         translate_url += argv[];
     }

     if (curl)
     {
         curl_easy_setopt(curl, CURLOPT_URL, translate_url.c_str());
         curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writer);
         curl_easy_setopt(curl, CURLOPT_WRITEDATA, &buffer);
         res = curl_easy_perform(curl);
         curl_easy_cleanup(curl);
     }
     if (buffer.empty())
     {
         cout << "The server return NULL!" << endl;
         exit();
     }

     Json::Value root;
     Json::Reader reader;
     bool parsingSuccessful = reader.parse(buffer, root);

     if (!parsingSuccessful)
     {
         cout << "Failed to parse the data!" << endl;
         exit();
     }

     if (root["errorCode"] != )
     {
         cout << "errorCode: " << root["errorCode"] << endl;
         exit();
     }
     const Json::Value basic = root["basic"];
     const Json::Value phonetic = basic["phonetic"];
     const Json::Value explains = basic["explains"];
     cout << "Provided by Youdao dictionary!" << endl;
     cout << "-----------------------------" << endl;
     const char *prefix = type ==  ? "[" : "英[";
     cout << argv[] << "\t" << prefix << phonetic.asString()  << "]" << endl;

     for(int i = ; i < explains.size(); ++i)
         cout << explains[i].asString() << endl;

     return ;
 }

这里，对之前博友提出的没有验证errorCode的问题也一并修复了！汉语翻译结果如下：

谢谢大家的阅读！

语音辞典功能见这里：http://www.cnblogs.com/berlin-sun/p/OnlineDictionary.html