MTrans

การแนะนำโครงการ mTrans

การแปลหลายแหล่ง (MTRANS) ของโครงการนี้ให้บริการที่มีน้ำหนักเบาซึ่งรวมฟังก์ชั่น การแปลออนไลน์ หลักและฟังก์ชั่น TTS ที่หลากหลาย โปรแกรมส่งคำขอ HTTP ไปยังเซิร์ฟเวอร์เป้าหมายออนไลน์ที่รองรับได้รับและแยกวิเคราะห์ผลลัพธ์ที่ส่งคืนให้ความสะดวกแก่ผู้ใช้ ในปัจจุบันโครงการนี้ ฟรีและโอเพ่นซอร์ส และนักพัฒนาสามารถดำเนินการพัฒนาทุติยภูมิตามนี้

ปัจจุบัน แหล่ง สนับสนุนและ ภาษา มีดังนี้:

แหล่งแปล	ที่อยู่เซิร์ฟเวอร์	สนับสนุนภาษา	ทาง
การแปล Baidu	http://fanyi.baidu.com/v2transapi	จีน, อังกฤษ, ญี่ปุ่น, เกาหลี, ฝรั่งเศส, รัสเซีย, เยอรมัน	การแปล
การแปล YouDao	http://fanyi.youdao.com/translate_o	จีน, อังกฤษ, ญี่ปุ่น, เกาหลี, ฝรั่งเศส, รัสเซีย	การแปล
Google แปล	https://translate.google.cn/translate_a/single	จีน, อังกฤษ, ญี่ปุ่น, เกาหลี, ฝรั่งเศส, รัสเซีย, เยอรมัน	การแปล
Tencent Translator	http://fanyi.qq.com/api/translate	จีน, อังกฤษ, ญี่ปุ่น, เกาหลี, ฝรั่งเศส, รัสเซีย, เยอรมัน	การแปล
การแปล ome	http://www.omianyi.com/transsents.do	จีนอังกฤษ	การแปล
Trycan	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://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, abstracthttpattribute	อินเทอร์เฟซวิธีการ HTTP และคลาสนามธรรม
com.swjtu.querier	querier	Generics, Queryer
com.swjtu.trans	บทคัดย่อ	คลาสนักแปล (บทคัดย่อ)
com.swjtu.trans.impl	Baidutranslator, Googletranslator, YouDaotranslator, Icibatranslator, Omitranslator, Sogoutranslator, TencentTranslator, trycantranslator	คลาส Entity Translator
com.swjtu.tts	บทคัดย่อ	คลาสบทคัดย่อ TTS
com.swjtu.tts.impl	Baidutts, YouDaotts, Googletts, Tencenttts, Sogoutts	คลาสเอนทิตี TTS

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 Class: มีและใช้วิธีการปฏิบัติบางอย่าง

   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 Class: กระบวนการร้องขอและการควบคุมที่เกี่ยวข้องกับคำขอ 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" );
      
      ...
  }

3. API ที่ให้ไว้

โครงการนี้สรุปวิธีการหลายวิธีและเปิดเผย 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 ในรหัสโครงการกำหนดภาษาที่ใช้กันมากที่สุด หากภาษาที่รองรับไม่สามารถตอบสนองความต้องการของผู้ใช้ได้ผู้ใช้สามารถขยายได้ด้วยตัวเอง

• กำหนดภาษาที่สนับสนุนโดยเซิร์ฟเวอร์เป้าหมายและรหัสภาษา
• เพิ่มรหัสที่กำหนดเองภาษาที่ต้องการใน enum;
• ในเมธอด 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 และ Enter: 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 เริ่มต้นคือ: ./tts/class ชื่อ -md5 (เนื้อหาที่จะแปลง) .mp3 (如：com.swjtu.tts.impl.GoogleTTS-5757a2c16ce52b5427eb12f961d6362e.mp3)