/**
* @file lltranslate.cpp
* @brief Functions for translating text via Google Translate.
*
* $LicenseInfo:firstyear=2009&license=viewerlgpl$
* Second Life Viewer Source Code
* Copyright (C) 2010, Linden Research, Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation;
* version 2.1 of the License only.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*
* Linden Research, Inc., 945 Battery Street, San Francisco, CA 94111 USA
* $/LicenseInfo$
*/
#include "llviewerprecompiledheaders.h"
#include "lltranslate.h"
#include
#include "llbufferstream.h"
#include "llui.h"
#include "llversioninfo.h"
#include "llviewercontrol.h"
#include "reader.h"
class LLTranslationAPIHandler
{
public:
virtual void getTranslateURL(
std::string &url,
const std::string &from_lang,
const std::string &to_lang,
const std::string &text) const = 0;
virtual bool parseResponse(
int& status,
const std::string& body,
std::string& translation,
std::string& detected_lang,
std::string& err_msg) const = 0;
virtual ~LLTranslationAPIHandler() {}
protected:
static const int STATUS_OK = 200;
};
class LLGoogleV1Handler : public LLTranslationAPIHandler
{
LOG_CLASS(LLGoogleV1Handler);
public:
/*virtual*/ void getTranslateURL(
std::string &url,
const std::string &from_lang,
const std::string &to_lang,
const std::string &text) const
{
url = "http://ajax.googleapis.com/ajax/services/language/translate?v=1.0&q="
+ LLURI::escape(text)
+ "&langpair=" + from_lang + "%7C" + to_lang;
}
/*virtual*/ bool parseResponse(
int& status,
const std::string& body,
std::string& translation,
std::string& detected_lang,
std::string& err_msg) const
{
Json::Value root;
Json::Reader reader;
if (!reader.parse(body, root))
{
err_msg = reader.getFormatedErrorMessages();
return false;
}
// This API doesn't return proper status in the HTTP response header,
// but it is in the body.
status = root["responseStatus"].asInt();
if (status != STATUS_OK)
{
err_msg = root["responseDetails"].asString();
return false;
}
const Json::Value& response_data = root["responseData"];
translation = response_data.get("translatedText", "").asString();
detected_lang = response_data.get("detectedSourceLanguage", "").asString();
return true;
}
};
class LLGoogleV2Handler : public LLTranslationAPIHandler
{
LOG_CLASS(LLGoogleV2Handler);
public:
/*virtual*/ void getTranslateURL(
std::string &url,
const std::string &from_lang,
const std::string &to_lang,
const std::string &text) const
{
url = std::string("https://www.googleapis.com/language/translate/v2?key=")
+ getAPIKey() + "&q=" + LLURI::escape(text) + "&target=" + to_lang;
if (!from_lang.empty())
{
url += "&source=" + from_lang;
}
}
/*virtual*/ bool parseResponse(
int& status,
const std::string& body,
std::string& translation,
std::string& detected_lang,
std::string& err_msg) const
{
Json::Value root;
Json::Reader reader;
if (!reader.parse(body, root))
{
err_msg = reader.getFormatedErrorMessages();
return false;
}
if (status != STATUS_OK)
{
const Json::Value& error = root["error"];
err_msg = error["message"].asString();
status = error["code"].asInt();
return false;
}
const Json::Value& response_data = root["data"]["translations"][0U];
translation = response_data["translatedText"].asString();
detected_lang = response_data["detectedSourceLanguage"].asString();
return true;
}
private:
static std::string getAPIKey()
{
return gSavedSettings.getString("GoogleTranslateAPIv2Key");
}
};
class LLBingHandler : public LLTranslationAPIHandler
{
LOG_CLASS(LLBingHandler);
public:
/*virtual*/ void getTranslateURL(
std::string &url,
const std::string &from_lang,
const std::string &to_lang,
const std::string &text) const
{
url = std::string("http://api.microsofttranslator.com/v2/Http.svc/Translate?appId=")
+ getAPIKey() + "&text=" + LLURI::escape(text) + "&to=" + to_lang;
if (!from_lang.empty())
{
url += "&from=" + from_lang;
}
}
/*virtual*/ bool parseResponse(
int& status,
const std::string& body,
std::string& translation,
std::string& detected_lang,
std::string& err_msg) const
{
if (status != STATUS_OK)
{
size_t begin = body.find("Message: ");
size_t end = body.find("
", begin);
err_msg = body.substr(begin, end-begin);
LLStringUtil::replaceString(err_msg, "
", ""); // strip CR
return false;
}
// Sample response: Hola
size_t begin = body.find(">");
if (begin == std::string::npos || begin >= (body.size() - 1))
{
return false;
}
size_t end = body.find("", ++begin);
if (end == std::string::npos || end < begin)
{
return false;
}
detected_lang = ""; // unsupported by this API
translation = body.substr(begin, end-begin);
LLStringUtil::replaceString(translation, "
", ""); // strip CR
return true;
}
private:
static std::string getAPIKey()
{
return gSavedSettings.getString("BingTranslateAPIKey");
}
};
LLTranslate::TranslationReceiver::TranslationReceiver(const std::string& from_lang, const std::string& to_lang)
: mFromLang(from_lang)
, mToLang(to_lang)
, mHandler(LLTranslate::getPreferredHandler())
{
}
// virtual
void LLTranslate::TranslationReceiver::completedRaw(
U32 http_status,
const std::string& reason,
const LLChannelDescriptors& channels,
const LLIOPipe::buffer_ptr_t& buffer)
{
LLBufferStream istr(channels, buffer.get());
std::stringstream strstrm;
strstrm << istr.rdbuf();
const std::string body = strstrm.str();
std::string translation, detected_lang, err_msg;
int status = http_status;
if (mHandler.parseResponse(status, body, translation, detected_lang, err_msg))
{
// Fix up the response
LLStringUtil::replaceString(translation, "<", "<");
LLStringUtil::replaceString(translation, ">",">");
LLStringUtil::replaceString(translation, ""","\"");
LLStringUtil::replaceString(translation, "'","'");
LLStringUtil::replaceString(translation, "&","&");
LLStringUtil::replaceString(translation, "'","'");
handleResponse(translation, detected_lang);
}
else
{
llwarns << "Translation request failed: " << err_msg << llendl;
LL_DEBUGS("Translate") << "HTTP status: " << status << " " << reason << LL_ENDL;
LL_DEBUGS("Translate") << "Error response body: " << body << LL_ENDL;
handleFailure(status, err_msg);
}
}
//static
void LLTranslate::translateMessage(
TranslationReceiverPtr &receiver,
const std::string &from_lang,
const std::string &to_lang,
const std::string &mesg)
{
std::string url;
receiver->mHandler.getTranslateURL(url, from_lang, to_lang, mesg);
static const float REQUEST_TIMEOUT = 5;
static LLSD sHeader;
if (!sHeader.size())
{
std::string user_agent = llformat("%s %d.%d.%d (%d)",
LLVersionInfo::getChannel().c_str(),
LLVersionInfo::getMajor(),
LLVersionInfo::getMinor(),
LLVersionInfo::getPatch(),
LLVersionInfo::getBuild());
sHeader.insert("Accept", "text/plain");
sHeader.insert("User-Agent", user_agent);
}
LL_DEBUGS("Translate") << "Sending translation request: " << url << LL_ENDL;
LLHTTPClient::get(url, receiver, sHeader, REQUEST_TIMEOUT);
}
//static
std::string LLTranslate::getTranslateLanguage()
{
std::string language = gSavedSettings.getString("TranslateLanguage");
if (language.empty() || language == "default")
{
language = LLUI::getLanguage();
}
language = language.substr(0,2);
return language;
}
// static
const LLTranslationAPIHandler& LLTranslate::getPreferredHandler()
{
static LLGoogleV1Handler google_v1;
static LLGoogleV2Handler google_v2;
static LLBingHandler bing;
std::string service = gSavedSettings.getString("TranslationService");
if (service == "google_v2")
{
return google_v2;
}
else if (service == "google_v1")
{
return google_v1;
}
return bing;
}