MTrans

مقدمة مشروع MTRANS

توفر الترجمة متعددة المصادر (MTRANS) لهذا المشروع خدمة خفيفة الوزن تدمج مجموعة متنوعة من وظائف الترجمة و TTS السائدة. يرسل البرنامج طلبات HTTP إلى الخوادم المستهدفة المدعومة على الإنترنت ، ويحصل على النتائج التي تم إرجاعها وتوصيفها ، مما يوفر الراحة للمستخدمين. في الوقت الحاضر ، هذا المشروع مجاني ومفتوح المصدر ، ويمكن للمطورين إجراء تطوير ثانوي بناءً على هذا.

حاليا مصادر الدعم واللغات على النحو التالي:

مصدر الترجمة	عنوان الخادم	دعم اللغات	طريق
ترجمة بايدو	http://fanyi.baidu.com/v2transapi	الصينية ، الإنجليزية ، اليابانية ، الكورية ، الفرنسية ، الروسية ، الألمانية	ترجمة
youdao ترجمة	http://fanyi.youdao.com/translate_o	الصينية ، الإنجليزية ، اليابانية ، الكورية ، الفرنسية ، الروسية	ترجمة
ترجمة جوجل	https://translate.google.cn/translate_a/single	الصينية ، الإنجليزية ، اليابانية ، الكورية ، الفرنسية ، الروسية ، الألمانية	ترجمة
مترجم تينسنت	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	الصينية ، الإنجليزية ، اليابانية ، الكورية ، الفرنسية ، الألمانية	ترجمة
ترجمة سوجو	http://fanyi.sogou.com/reventondc/translate	الصينية ، الإنجليزية ، اليابانية ، الكورية ، الفرنسية ، الروسية ، الألمانية	ترجمة

مصدر TTS	عنوان الخادم	دعم اللغات
بايدو TTS	http://fanyi.baidu.com/gettts	الصينية ، الإنجليزية ، اليابانية ، الكورية ، الفرنسية ، الروسية ، الألمانية ، التايلاندية
youdao tts	http://tts.youdao.com/fanyivoice	الإنجليزية ، اليابانية ، الكورية ، الفرنسية
جوجل TTS	https://translate.google.cn/translate_tts	الصينية ، الإنجليزية ، اليابانية ، الكورية ، الفرنسية ، الروسية ، الألمانية
Tencent tts	http://audiodetect.browser.qq.com:8080/tts	الصينية ، الإنجليزية ، اليابانية ، الكورية
Sogou tts	http://fanyi.sogou.com/reventondc/syncthesis	الصينية ، الإنجليزية

1. ابدأ بسرعة

1. تكوين البيئة

تم تطوير هذا المشروع باستخدام 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 >

2. الحد الأدنى مثيل

• مثال الترجمة الأدنى

   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 );
          }
      }
  }

• الحد الأدنى TTS مثيل

   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 );
          }
      }
  }

2. تعليمات mtrans

1. الحزمة/قائمة الفئة

يحدد هذا المشروع بشكل أساسي الحزم التالية ، وتسمية ووظائفها هي كما يلي:

اسم الحزمة	تشمل الفصول	يوضح
com.swjtu.lang	لانغ	نوع التعداد ، قائمة اللغات المدعومة
com.swjtu.util	استخدام	مجموعة الأدوات
com.swjtu.http	httpparams ، absstracthttpattribute	واجهة طريقة HTTP والفئات المجردة
com.swjtu.querier	مروع	الأدوية ، Queryer
com.swjtu.trans	الملخص	مترجم (ملخص) فئة
com.swjtu.trans.impl	BaiduTranslator ، Googletranslator ، youdaotranslator ، icibatranslator ، Omitranslator ، Sogoutranslator ، TencentTranslator ، Trycantranslator	فئة كيان المترجم
com.swjtu.tts	الملخص	TTS المجردة فئة
com.swjtu.tts.impl	Baidutts ، youdaotts ، googletts ، tencenttts ، sogoutts	TTS CHITITY CLASS

2. مخطط الفصل

• هيكل المشروع

  

• com.swjtu.http حزمة/مخطط فئة

  

• com.swjtu.querier حزمة/مخطط فئة

  

• com.swjtu.trans حزمة/مخطط فئة

  

• com.swjtu.trans.impl حزمة/مخطط فئة

  

• com.swjtu.tts حزمة/مخطط فئة

  

• com.swjtu.tts.impl حزمة/مخطط فئة

  

• com.swjtu.util حزمة/مخطط فئة

  

3. وصف الفصل

• تعداد 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 Class: وراثة من فئة 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 Class: ويرث من فئة 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" );
      
      ...
  }

3. واجهة برمجة التطبيقات المقدمة

يلف هذا المشروع العديد من الطرق ويعرض 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 );                       // 移除查询器中的元素

4. كيف تتوسع؟

يدعم هذا المشروع ويوفر خدمات الترجمة و TTS السائدة عبر الإنترنت ، ويمكنه بسهولة أداء المهام ذات الصلة من خلال واجهة API المقدمة. في الوقت نفسه ، بالنظر إلى الاحتياجات المحتملة للمستخدمين ، سنقدم كيفية التوسع بناءً على هذا المشروع لتحقيق الغرض من التطوير الثانوي. قبل توسيع هذا المشروع ، يحتاج المستخدمون إلى فهم معين لرمز مصدر المشروع ومعرفة HTTP.

1. توسيع اللغة

يحدد تعداد LANG في رمز المشروع اللغات الأكثر استخدامًا. إذا لم تتمكن اللغة المدعومة من تلبية احتياجات المستخدم ، فيمكن للمستخدم توسيعها بنفسه.

• تحديد اللغة المدعومة من الخادم الهدف ورمز اللغة ؛
• إضافة رمز مخصص اللغة المطلوبة إلى التعداد ؛
• في طريقة فئة الكيان setLangSupport() ، أضف خريطة التعليمات البرمجية إلى متغير langMap ؛

على سبيل المثال: على سبيل المثال ، إذا قمت بإضافة دعم إسباني إلى مترجم Youdao :

• الخطوة 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" );                  // 添加代号映射
   }

2. مترجم ممتد

يحدد المطورون فئة المترجم الخاصة بهم من خلال وراثة فئة 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 التي تتطلب إعداد ملفات تعريف الارتباط ، يرجى الحصول على ملفات تعريف الارتباط وتعيينها قبل تقديم الطلب. عادة ، اضغط على F12 في متصفح Chrome وأدخل: document.cookie في وحدة التحكم في وحدة التحكم لعرضه.

3. تمديد TTS

يحدد المطورون فئة TTS الخاصة بهم من خلال ورث فئة AbstractTTS وتنفيذ الأساليب التجريدية التالية في الفصل:

 // 添加语种支持
public abstract void setLangSupport ();
// 用于设置请求参数
public abstract void setFormData ( LANG source , String text );
// 发送 HTTP 请求并接收返回结果(通常为 JSON 或 XML 字符串，根据用户请求结果而定)
public abstract String query () throws Exception ;

ملاحظة: المسار الافتراضي TTS Save هو: ./tts/class name-md5 (المحتوى المراد تحويله). mp3 (如：com.swjtu.tts.impl.GoogleTTS-5757a2c16ce52b5427eb12f961d6362e.mp3)