MTrans 项目介绍

本项目 多源翻译 (Multi-source Translation, MTrans)，提供了集多种主流的 在线翻译 及 TTS 功能于一身的轻量级服务。通过程序向所支持的在线目标服务器发送 HTTP 请求，获取并解析返回的结果，为使用者提供便利。目前，本项目免费开源，开发者可基于此进行二次开发。

目前支持源及语种如下:

一、快速开始

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

二、MTrans 使用说明

1、包/类一览表

本项目中主要定义了如下几个包，其命名及作用如下表：

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>

MTrans

Install / Use

README

MTrans 项目介绍

一、快速开始

1、环境配置

2、最小实例

二、MTrans 使用说明

1、包/类一览表

2、类图

3、类说明

MTrans

Install / Use

README

MTrans 项目介绍

一、快速开始

1、环境配置

2、最小实例

二、MTrans 使用说明

1、包/类 一览表

2、类图

3、类说明

1、包/类一览表