MTrans
1.0.0
Перевод с несколькими источниками (MTRANS) этого проекта предоставляет легкий сервис, который интегрирует различные основные онлайн-переводы и функции TTS . Программа отправляет HTTP -запросы на поддерживаемые онлайн -серверы, получает и анализирует возвращенные результаты, предоставляя удобство для пользователей. В настоящее время этот проект является бесплатным и открытым исходным кодом , и разработчики могут проводить вторичное развитие на основе этого.
В настоящее время источники и языки поддержки следующие:
| Источник перевода | Адрес сервера | Поддержка языков | Способ |
|---|---|---|---|
| Байду перевод | http://fanyi.baidu.com/v2transapi | Китайский, английский, японский, корейский, французский, русский, немецкий | Перевод |
| Youdao перевод | http://fanyi.youdao.com/translate_o | Китайский, английский, японский, корейский, французский, русский | Перевод |
| Google Translate | https://translate.google.cn/translate_a/single | Китайский, английский, японский, корейский, французский, русский, немецкий | Перевод |
| Tencent переводчик | http://fanyi.qq.com/api/translate | Китайский, английский, японский, корейский, французский, русский, немецкий | Перевод |
| OME Перевод | http://www.omianyi.com/transsents.do | Китайский, английский | Перевод |
| Трикан | http://fanyi.trycan.com/transfer.do | Китайский, английский | Перевод |
| Kingsoft Love Ci Domineer | http://fy.iciba.com/ajax.php?a=fy | Китайский, английский, японский, корейский, французский, немецкий | Перевод |
| SOGOU Перевод | http://fanyi.sogou.com/reventondc/translate | Китайский, английский, японский, корейский, французский, русский, немецкий | Перевод |
| TTS -источник | Адрес сервера | Поддержка языков |
|---|---|---|
| Baidu TTS | http://fanyi.baidu.com/gettts | Китайский, английский, японский, корейский, французский, русский, немецкий, тайский |
| Youdao tts | http://tts.youdao.com/fanyivoice | Английский, японский, корейский, французский |
| Google TTS | https://translate.google.cn/translate_tts | Китайский, английский, японский, корейский, французский, русский, немецкий |
| Tencent TTS | http://adiodetect.browser.qq.com:8080/tts | Китайский, английский, японский, корейский |
| Sogou tts | http://fanyi.sogou.com/reventondc/synctheesis | Китайский, английский |
Этот проект разработан с использованием Idea + Maven . Пожалуйста, добавьте следующие зависимости в pom.xml .
< dependency >
< groupId >org.apache.httpcomponents</ groupId >
< artifactId >httpclient</ artifactId >
< version >4.5.5</ version >
</ dependency >
< dependency >
< groupId >com.fasterxml.jackson.core</ groupId >
< artifactId >jackson-databind</ artifactId >
< version >2.9.5</ version >
</ dependency > import com . swjtu . lang . LANG ;
import com . swjtu . querier . Querier ;
import com . swjtu . trans . AbstractTranslator ;
import com . swjtu . trans . impl . GoogleTranslator ;
import java . util . List ;
public class Test {
public static void main ( String [] args ) {
Querier < AbstractTranslator > querierTrans = new Querier <>(); // 获取查询器
querierTrans . setParams ( LANG . ZH , LANG . EN , "如果这都不算爱，我有什么好悲哀！" ); // 设置参数
querierTrans . attach ( new GoogleTranslator ()); // 向查询器中添加 Google 翻译器
List < String > result = querierTrans . execute (); // 执行查询并接收查询结果
for ( String str : result ) {
System . out . println ( str );
}
}
} import com . swjtu . lang . LANG ;
import com . swjtu . querier . Querier ;
import com . swjtu . tts . AbstractTTS ;
import com . swjtu . tts . impl . BaiduTTS ;
import java . util . List ;
public class Test {
public static void main ( String [] args ) {
Querier < AbstractTTS > querierTTS = new Querier <>(); // 获取查询器
querierTTS . setParams ( LANG . EN , "To be or not to be, that is a question." ); // 设置参数
querierTTS . attach ( new BaiduTTS ()); // 向查询器中添加 Google 翻译器
List < String > result = querierTTS . execute (); // 执行查询并接收查询结果
for ( String str : result ) {
System . out . println ( str );
}
}
}Этот проект в основном определяет следующие пакеты, а их именование и функции следующие:
| Название пакета | Включите классы | иллюстрировать |
|---|---|---|
| com.swjtu.lang | Ланг | Тип перечисления, список поддерживаемых языков |
| com.swjtu.util | Утилит | Инструментарий |
| com.swjtu.http | Httpparams, Abstractttpattribute | Интерфейс метода HTTP и классы абстрактных классов |
| com.swjtu.querier | Querier | Дженерики, запрос |
| com.swjtu.trans | AbstractTranslator | Переводчик (абстрактный) класс |
| com.swjtu.trans.impl | Baidutranslator, Googletranslator, Youdaotranslator, Icibatranslator, Omitranslator, Sogoutranslator, TencentTranslator, TryCantranslator | Переводчик объект класса |
| com.swjtu.tts | Аннотация | TTS Abstract Class |
| com.swjtu.tts.impl | Baidutts, Youdaotts, Googletts, Tencenttts, Sogoutts | TTS Entity Class |
Структура проекта
com.swjtu.http пакет/схема класса
com.swjtu.querier пакет/схема класса
com.swjtu.trans пакет/диаграмма класса
com.swjtu.trans.impl пакет/схема класса
com.swjtu.tts пакет/классная диаграмма
com.swjtu.tts.impl пакет/диаграмма класса
com.swjtu.util Package/Class Diagram
Перечисление LANG : определяет поддерживаемые или поддерживаемые языки и равномерно стандартизирует список языков.
public enum LANG {
ZH , // 中文
EN , // 英语
JP , // 日语
JPKA , // 日语假名
TH , // 泰语
...
} Класс Util : содержит и реализует некоторые практические методы.
public static List < NameValuePair > map2list ( Map < String , String > mapParams ); // 将 Map 转换成 List
public static String getUrlWithQueryString ( String url , Map < String , String > params ); // 生成 URL
// 各种格式的 MD5
public static String md5 ( String input );
public static String md5 ( File file );
public static String md5 ( InputStream in ); Класс Querier : определяет класс Querier и использует шаблон наблюдателя. Этот класс содержит коллекцию, элементы в коллекции являются классом переводчика или классом TTS. После установки параметров через setParams() выполните метод execute() , чтобы отправить запрос и вернуть результат. Элементы могут быть добавлены или удалены в сборку с помощью методов attach() и detach() .
public final class Querier < T extends AbstractHttpAttribute > {
private List < T > collection ; // 集合
...
public void setParams ( LANG source , String text ); // TTS 参数设置， source 源语种，text 待转换为语音的内容
public void setParams ( LANG from , LANG to , String text ); // 翻译器参数设置，from 源语种，to 目标语种，text 待翻译内容
public List < String > execute () {
List < String > result = new ArrayList < String >();
for ( T element : collection ) {
if ( element . getClass (). getName (). contains ( "Translator" )) {
result . add ( element . run ( from , to , text ));
} else if ( element . getClass (). getName (). contains ( "TTS" )) {
result . add ( element . run ( from , text ));
}
}
return result ;
}
public void attach ( T element );
public void detach ( T element );
...
} Интерфейс HttpParams : определяет метод интерфейса для настройки формата данных HTTP
public interface HttpParams {
public void setFormData ( LANG source , String text ); // 设置 TTS 参数的接口方法
public void setFormData ( LANG from , LANG to , String text ); // 设置翻译器参数的接口方法
} Класс AbstractHttpAttribute : процесс запроса и управления, связанные с HTTP -запросами
public abstract String query () throws Exception ;
public abstract String run ( LANG source , String text );
public abstract String run ( LANG from , LANG to , String text );
// 资源释放
public void close ( HttpEntity httpEntity , CloseableHttpResponse httpResponse );
public void close (); Класс AbstractTranslator : наследует от класса AbstractHttpAttribute , реализует интерфейс HttpParams и определяет классы абстрактных переводчиков.
@ Override
public String run ( LANG from , LANG to , String text ) {
String result = "" ;
setFormData ( from , to , text );
try {
result = parses ( query ());
} catch ( Exception e ) {
e . printStackTrace ();
}
close ();
return result ;
}
public abstract void setLangSupport (); // 设置支持的语种
public abstract String parses ( String text ) throws IOException ; // 解析返回结果Класс AbstractTTS : наследует от класса AbstractHttpAttribute , реализует интерфейс HttpParams и определяет абстрактный класс TTS.
@ Override
public String run ( LANG source , String text ) {
String saveFile = null ;
setFormData ( source , text );
try {
saveFile = query ();
System . out . println ( saveFile );
} catch ( IOException e ) {
e . printStackTrace ();
}
close ();
return saveFile ;
}
public String query () throws IOException {
...
// 将 TTS 结果保存为 mp3 音频文件，以待转换文本的 md5 码作为部分文件名
StringBuilder saveFile = new StringBuilder ();
saveFile . append ( "./tts/" )
. append ( this . getClass (). getName ())
. append ( "-" )
. append ( Util . md5 ( uri ))
. append ( ".mp3" );
...
} Этот проект инкапсулирует несколько методов и выставляет 5 методов API через общий класс Querier . Это очень просто и легко в использовании. См. Пример для деталей:
// 设置查询器参数
public void setParams ( LANG source , String text );
public void setParams ( LANG from , LANG to , String text );
public List < String > execute (); // 执行查询并返回结果
public void attach ( T element ); // 向查询器中添加元素
public void detach ( T element ); // 移除查询器中的元素Этот проект поддерживает и предоставляет основной онлайн -перевод и услуги TTS и может легко выполнять соответствующие задачи через предоставленный интерфейс API. В то же время, учитывая потенциальные потребности пользователей, мы представим, как расширяться в зависимости от этого проекта, чтобы достичь цели вторичной разработки. Прежде чем расширить этот проект, пользователи должны иметь определенное понимание исходного кода проекта и знаний HTTP.
Перечисление LANG в коде проекта определяет наиболее часто используемые языки. Если поддерживаемый язык не может удовлетворить потребности пользователя, пользователь может расширить его сам.
setLangSupport() добавьте карту кода в переменную langMap ;Например: например, если вы добавите поддержку испанского языка в YouDao Translator:
Шаг 1: Запротив список языков, поддерживаемых сервером перевода YouDao, можно увидеть, что испанский язык поддерживается и его кодовое имя: es
Шаг 2: В LANG добавьте языковой пользовательский код:
public enum LANG {
ZH , // 中文
EN , // 英语
JP , // 日语
JPKA , // 日语假名
TH , // 泰语
FRA , // 法语
SPA , // 西班牙语 <--- 添加语种(自定义语种代号)
KOR , // 韩语
....
} Шаг 3: В классе YoudaoTranslator добавьте карту кода:
@ Override
public void setLangSupport () {
langMap . put ( LANG . ZH , "zh-CHS" );
langMap . put ( LANG . EN , "en" );
langMap . put ( LANG . JP , "ja" );
langMap . put ( LANG . KOR , "ko" );
langMap . put ( LANG . FRA , "fr" );
langMap . put ( LANG . RU , "ru" );
langMap . put ( LANG . SPA , "es" ); // 添加代号映射
} Разработчики определяют свой собственный класс переводчика, унаследовав класс AbstractTranslator и внедряют следующие абстрактные методы в классе:
// 添加语种支持
public abstract void setLangSupport ();
// 用于设置请求参数
public abstract void setFormData ( LANG from , LANG to , String text );
// 发送 HTTP 请求并接收返回结果(通常为 JSON 或 XML 字符串，根据用户请求结果而定)
public abstract String query () throws Exception ;
// 解析字符串，提取翻译结果
public abstract String parses ( String text ) throws IOException ;ПРИМЕЧАНИЕ. Для некоторых HTTP -запросов, которые требуют настройки файлов cookie, получите и установите файлы cookie, прежде чем сделать запрос. Обычно нажимайте F12 в браузере Chrome и введите:
document.cookieв консоли консоли, чтобы просмотреть его.
Разработчики определяют свой собственный класс TTS, унаследовав класс AbstractTTS и внедряют следующие абстрактные методы в классе:
// 添加语种支持
public abstract void setLangSupport ();
// 用于设置请求参数
public abstract void setFormData ( LANG source , String text );
// 发送 HTTP 请求并接收返回结果(通常为 JSON 或 XML 字符串，根据用户请求结果而定)
public abstract String query () throws Exception ;ПРИМЕЧАНИЕ. По умолчанию пути сохранения TTS: ./tts/class name -md5 (контент для преобразования) .mp3
(如：com.swjtu.tts.impl.GoogleTTS-5757a2c16ce52b5427eb12f961d6362e.mp3)
