百度翻译 API 的申请 与 百度通用翻译 API 的接入

// 为了方便观看，直接用 get 请求的 URL 来展示
// [] 表示要用实际的值进行填充
http://api.fanyi.baidu.com/api/trans/vip/translate?q=[]&from=[]&to=[]&appid=[]&salt=[]&sign=[]

https://fanyi-api.baidu.com/api/trans/vip/translate?q=[]&from=[]&to=[]&appid=[]&salt=[]&sign=[]

- ``q = "苹果"，from = "auto"或"zh"，to = "en"，appid = [APP ID]，salt = [随机数]，sign = [签名]``。

{
  "from": "en",
  "to": "zh",
  "trans_result": [
    {
      "src": "apple",
      "dst": "苹果"
    }
  ]
}

{
  "error_code": "54001",
  "error_msg": "Invalid Sign"
}

HttpGet.get(TRANS_API_HOST, params)

MD5.md5(src)

<dependencies>
    <dependency>
        <groupId>cn.hutool</groupId>
        <artifactId>hutool-all</artifactId>
        <version>5.8.5</version>
    </dependency>
</dependencies>

package com.example.demo.service;

import cn.hutool.crypto.SecureUtil;
import cn.hutool.http.HttpUtil;
import com.example.demo.entity.TranslateResults;
import com.google.gson.Gson;

import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * 百度通用翻译 工具类
 * <p>
 * 接入 百度翻译 API
 *
 */
public class BaiduTranslationUtils {
	
	/**
	 * 对接 百度通用翻译 API（https）
	 */
	private static final String TRANS_API_HOST_HTTPS = "https://fanyi-api.baidu.com/api/trans/vip/translate";
	/**
	 * 对接 百度通用翻译 API（http）
	 */
	private static final String TRANS_API_HOST_HTTP = "http://api.fanyi.baidu.com/api/trans/vip/translate";
	/**
	 * 百度翻译 APP ID
	 */
	private static final String APP_ID = "20220930001363960";
	/**
	 * 百度翻译 APP 密钥
	 */
	private static final String SECURITY_KEY = "ZWgAN0_8hngJPzuZbCRt";
	
	/**
	 * JSON 字符串工具类
	 */
	private static final Gson GSON = new Gson();
	
	public static void main(String[] args) {
		String result = BaiduTranslationUtils.getUniversalTranslation("苹果", "auto", "en");
//		System.out.println(result);
		TranslateResults translateResults = toTranslateResults(result);
		translateResults.outputDisplay();
		
		String result1 = BaiduTranslationUtils.getUniversalTranslations("Apple", "auto", "zh");
		TranslateResults translateResults1 = toTranslateResults(result1);
		translateResults1.outputDisplay();
		
		String result2 = BaiduTranslationUtils.postUniversalTranslation("苹果", "auto", "en");
		TranslateResults translateResults2 = toTranslateResults(result2);
		translateResults2.outputDisplay();
		
		String result3 = BaiduTranslationUtils.postUniversalTranslations("Apple", "auto", "zh");
		TranslateResults translateResults3 = toTranslateResults(result3);
		translateResults3.outputDisplay();
	}
	
	/**
	 * 用 GET 请求访问 通用翻译 http API
	 *
	 * @param query 查询的字段
	 * @param from  源语言代码名称
	 * @param to    目标语言代码名称
	 *
	 * @return JSON
	 */
	public static String getUniversalTranslation(String query, String from, String to) {
		return getHttpUniversalTranslation(query, from, to);
	}
	
	/**
	 * 用 GET 请求访问 通用翻译 https API
	 *
	 * @param query 查询的字段
	 * @param from  源语言代码名称
	 * @param to    目标语言代码名称
	 *
	 * @return JSON
	 */
	public static String getUniversalTranslations(String query, String from, String to) {
		return getHttpsUniversalTranslation(query, from, to);
	}
	
	/**
	 * 用 POST 请求访问 通用翻译 http API
	 *
	 * @param query 查询的字段
	 * @param from  源语言代码名称
	 * @param to    目标语言代码名称
	 *
	 * @return JSON
	 */
	public static String postUniversalTranslation(String query, String from, String to) {
		return postHttpUniversalTranslation(query, from, to);
	}
	
	/**
	 * 用 POST 请求访问 通用翻译 https API
	 *
	 * @param query 查询的字段
	 * @param from  源语言代码名称
	 * @param to    目标语言代码名称
	 *
	 * @return JSON
	 */
	public static String postUniversalTranslations(String query, String from, String to) {
		return postHttpsUniversalTranslation(query, from, to);
	}
	
	/**
	 * 用 GET 请求访问 通用翻译 http API
	 *
	 * @param query 查询的字段
	 * @param from  源语言代码名称
	 * @param to    目标语言代码名称
	 *
	 * @return JSON
	 */
	private static String getHttpUniversalTranslation(String query, String from, String to) {
		Map<String, Object> map = assemble(query, from, to);
		return HttpUtil.get(TRANS_API_HOST_HTTP, map);
	}
	
	/**
	 * 用 GET 请求访问 通用翻译 https API
	 *
	 * @param query 查询的字段
	 * @param from  源语言代码名称
	 * @param to    目标语言代码名称
	 *
	 * @return JSON
	 */
	private static String getHttpsUniversalTranslation(String query, String from, String to) {
		Map<String, Object> map = assemble(query, from, to);
		return HttpUtil.get(TRANS_API_HOST_HTTPS, map);
	}
	
	/**
	 * 用 POST 请求访问 通用翻译 http API
	 *
	 * @param query 查询的字段
	 * @param from  源语言代码名称
	 * @param to    目标语言代码名称
	 *
	 * @return JSON
	 */
	private static String postHttpUniversalTranslation(String query, String from, String to) {
		Map<String, Object> map = assemble(query, from, to);
		return HttpUtil.post(TRANS_API_HOST_HTTP, map);
	}
	
	/**
	 * 用 POST 请求访问 通用翻译 https API
	 *
	 * @param query 查询的字段
	 * @param from  源语言代码名称
	 * @param to    目标语言代码名称
	 *
	 * @return JSON
	 */
	private static String postHttpsUniversalTranslation(String query, String from, String to) {
		Map<String, Object> map = assemble(query, from, to);
		return HttpUtil.post(TRANS_API_HOST_HTTPS, map);
	}
	
	/**
	 * 将 输入参数 组装到 Map 中
	 *
	 * @param query 查询的字段
	 * @param from  源语言代码名称
	 * @param to    目标语言代码名称
	 *
	 * @return Map<String, Object>
	 */
	private static Map<String, Object> assemble(String query, String from, String to) {
		if(query == null || query.isEmpty()) {
			query = "中国";
		}
		if(from == null || from.isEmpty()) {
			from = "auto";
		}
		if(to == null || to.isEmpty()) {
			to = "en";
		}
		Map<String, Object> params = new HashMap<>(5);
		// 查询的字段
		params.put("q", new String(query.getBytes(StandardCharsets.UTF_8)));
		// 源语言代码名称
		params.put("from", from);
		// 目标语言代码名称
		params.put("to", to);
		// APP ID
		params.put("appid", APP_ID);
		// 随机数
		String salt = String.valueOf(System.currentTimeMillis());
		params.put("salt", salt);
		// 加密前的原文
		String src = APP_ID + query + salt + SECURITY_KEY;
		// 签名
		params.put("sign", SecureUtil.md5(src));
		return params;
	}
	
	/**
	 * 将 JSON 字符串 转换成 类对象
	 *
	 * @param json JSON 字符串
	 *
	 * @return 类对象
	 */
	public static TranslateResults toTranslateResults(String json) {
		return GSON.fromJson(json, TranslateResults.class);
	}

}

<dependencies>
    <!-- Gson JSON 工具类库 -->
    <!-- https://mvnrepository.com/artifact/com.google.code.gson/gson -->
    <dependency>
        <groupId>com.google.code.gson</groupId>
        <artifactId>gson</artifactId>
        <version>2.8.9</version>
    </dependency>

    <!-- lombok -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.20</version>
        <optional>true</optional>
    </dependency>
</dependencies>

public class BaiduTranslationUtils {
	
	/**
	 * JSON 字符串工具类
	 */
	private static final Gson GSON = new Gson();
  	
	public static TranslateResults toTranslateResults(String json) {
		return GSON.fromJson(json, TranslateResults.class);
	}
}

package com.example.demo.entity;

import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;

import java.util.Arrays;

/**
 * 翻译结果 类
 */
@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
public class TranslateResults {
	
	/**
	 * 源语言代码名称
	 */
	private String from;
	
	/**
	 * 目标语言代码名称
	 */
	private String to;
	
	/**
	 * 翻译结果数组
	 */
	private TransResult[] trans_result;
	
	/**
	 * 错误码
	 */
	private Integer error_code;
	
	/**
	 * 错误含义、信息
	 */
	private String error_msg;
	
	@Override
	public String toString() {
		return "TranslateResults{" +
				"from='" + from + '\'' +
				", to='" + to + '\'' +
				", trans_result=" + Arrays.toString(trans_result) +
				", error_code=" + error_code +
				", error_msg='" + error_msg + '\'' +
				'}';
	}
	
	/**
	 * 输出指点的内容
	 */
	public void outputDisplay() {
		StringBuilder builder = new StringBuilder();
		if(error_code == null && error_msg == null) {
			builder.append("[");
			for(TransResult transResult : trans_result) {
				builder.append(transResult.outputDisplay()).append(",");
			}
			builder.append("]");
		} else if(trans_result == null) {
			builder.append("{")
					.append("错误码 = ").append(error_code)
					.append(" , ")
					.append("错误信息提示 = ").append(error_msg)
					.append("}");
		} else {
			builder.append("返回值异常请检查！").append(this.toString());
		}
		System.out.println(builder.toString());
	}

}

package com.example.demo.entity;

import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;

import java.net.URLEncoder;

/**
 * 翻译原文译文 类
 */
@Setter
@Getter
@NoArgsConstructor
@AllArgsConstructor
public class TransResult {
	
	/**
	 * 翻译原文
	 */
	private String src;
	
	/**
	 * 翻译译文
	 */
	private String dst;
	
	@Override
	public String toString() {
		return "TransResult{" +
				"src='" + src + '\'' +
				", dst='" + dst + '\'' +
				'}';
	}
	
	/**
	 * 输出指点的内容
	 */
	public String outputDisplay() {
		return "{" +
				"原文 = '" + src + '\'' +
				", 译文 = '" + dst + '\'' +
				'}';
	}

}

{
  "from": "zh",
  "to": "en",
  "trans_result": [
    {
      "src": "\u82f9\u679c",
      "dst": "Apple"
    }
  ]
}