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-4.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 0;
    int len = size*nmemb;
    writerData->append(data, len); 
    return len;
}

int main(int argc, char *argv[])
{
    if(argc < 2)
    {
        usage();
        exit(0);
    }
    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[1];
    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(0);
    }
    
    Json::Value root;
    Json::Reader reader;
    bool parsingSuccessful = reader.parse(buffer, root);
    
    if (!parsingSuccessful)
    {
        cout << "Failed to parse the data!" << endl;
        exit(0);
    }
    
    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[1] << "	英[" << phonetic.asString()  << "]" << endl;
    
    for(int i = 0; i < explains.size(); ++i)
        cout << explains[i].asString() << endl;

    return 0;
}

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[1]&0x80) != 0)
{
    type = 0;
    char *encode_word = curl_easy_escape(curl, argv[1], 0);
    translate_url += encode_word;
} else {
    type = 1;
　　translate_url += argv[1];
}

由于后面显示格式会有所不同，所以我加入一个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 0;
    int len = size*nmemb;
    writerData->append(data, len); 
    return len;
}

int main(int argc, char *argv[])
{
    if(argc < 2)
    {
        usage();
        exit(0);
    }
    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[1]&0x80) != 0)
    {
        type = 0;
        char *encode_word = curl_easy_escape(curl, argv[1], 0);
        translate_url += encode_word;
    } else {
        type = 1;
        translate_url += argv[1];
    }

    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(0);
    }
    
    Json::Value root;
    Json::Reader reader;
    bool parsingSuccessful = reader.parse(buffer, root);
    
    if (!parsingSuccessful)
    {
        cout << "Failed to parse the data!" << endl;
        exit(0);
    }

    if (root["errorCode"] != 0)
    {
        cout << "errorCode: " << root["errorCode"] << endl;
        exit(0);
    }
    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 == 0 ? "[" : "英[";
    cout << argv[1] << "	" << prefix << phonetic.asString()  << "]" << endl;
    
    for(int i = 0; i < explains.size(); ++i)
        cout << explains[i].asString() << endl;

    return 0;
}

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

谢谢大家的阅读！

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