.NET应用系统的国际化-多语言翻译服务

闲爱孤烟

上篇文章我们介绍了
.NET应用系统的国际化-基于Roslyn抽取词条、更新代码
系统国际化改造整体设计思路如下：

• 提供一个工具，识别前后端代码中的中文，形成多语言词条，按语言、界面、模块统一管理多有的多语言词条
  
• 提供一个翻译服务，批量翻译多语言词条
  
• 提供一个词条服务，支持后端代码在运行时根据用户登录的语言，动态获取对应的多语言文本
  
• 提供前端多语言JS生成服务，按界面动态生成对应的多语言JS文件，方便前端VUE文件使用。
  
• 提供代码替换工具，将VUE前端代码中的中文替换为$t("词条ID")，后端代码中的中文替换为TermService.Current.GetText("词条ID")
  

本篇文章我们重点和大家分享多语言翻译服务的设计和实现。
一、业务背景
通过上一篇文章，我们把sln解决方案中各个Project下的中文文本，识别成大量的多语言词条。
这些多语言词条临时存储在数据库中，我们要对这个临时结果集，通过多语言翻译服务，按支持的语言，翻译成多语言词条。
对应的类图设计：

 
 
 对应的词条管理界面：

 

 
 因此我们需要一个多语言词条翻译服务，实现词条的批量、快速机器翻译。
二、多语言词条翻译服务
首先，抽象一个翻译接口II18NTermTranslateService

1. /// <summary>
2. /// 词条翻译服务接口
3. /// </summary>
4. public interface II18NTermTranslateService
5. {
6.      string Translate(string text, string language);
7. }

复制代码

设计一个翻译服务提供者类，通过Facade模式，对外统一提供翻译服务TranslateServiceProvider

1. using System;
2. using System.Collections.Generic;
3. using System.Linq;
4. using System.Text;
5. using System.Threading.Tasks;
6. using I18N.SPI;
8. namespace I18N.Translation
9. {
10.     /// <summary>
11.     /// 翻译服务提供者
12.     /// </summary>
13.     public class TranslateServiceProvider
14.     {
15.         public static II18NTermTranslateService GetTranslateService(Translater translater)
16.         {
17.             switch (translater)
18.             {
19.                 case Translater.Youdao:
20.                 default:
21.                     return new YoudaoTranslateService();
22.                 case Translater.Baidu:
23.                     return new BaiduTranslateService();
24.                 case Translater.Google:
25.                     return new GoogleTranslateService();
26.                 case Translater.Azure:
27.                     return new AzureTranslateService();
28.             }
29.         }
31.         public static II18NTermTranslateService GetYoudaoTranslateService()
32.         {
33.             return new YoudaoTranslateService();
34.         }
36.         public static II18NTermTranslateService GetGoogleTranslateService()
37.         {
38.             return new GoogleTranslateService();
39.         }
41.         public static II18NTermTranslateService GetBaiduTranslateService()
42.         {
43.             return new BaiduTranslateService();
44.         }
46.         public static II18NTermTranslateService GetAzureTranslateService()
47.         {
48.             return new AzureTranslateService();
49.         }
50.     }
51. }

复制代码

 这里的Translater是个枚举

1. public enum Translater
2.     {
3.         Youdao,
4.         Baidu,
5.         Google,
6.         Azure
7.     }

复制代码

三、多语言词条翻译服务-Azure翻译服务
这里我们使用Azure认知服务中的服务服务，实现上面抽象好的翻译接口

1. using Newtonsoft.Json;
2. using System;
3. using System.Collections.Generic;
4. using System.Linq;
5. using System.Net.Http;
6. using System.Text;
7. using I18N.SPI;
9. namespace I18N.Translation
10. {
11.     /// <summary>
12.     /// Azure翻译服务
13.     /// </summary>
14.     /// <remarks>
15.     /// https://learn.microsoft.com/zh-cn/azure/cognitive-services/translator/text-translation-overview
16.     /// </remarks>
17.     public class AzureTranslateService : II18NTermTranslateService
18.     {
19.         private readonly string _endpoint = "https://api.cognitive.microsofttranslator.com";
20.         private readonly string _key = "XXXXXXXXXXXXXX";
21.         public string Translate(string text, string language)
22.         {
23.             return Post(text, language);
24.         }
26.         private string Post(string text, string language)
27.         {
28.             using (var client = new HttpClient())
29.             {
30.                 using (var request = new HttpRequestMessage())
31.                 {
32.                     var url = $"/translate?api-version=3.0&to={language}";
33.                     request.Method = HttpMethod.Post;
34.                     request.RequestUri = new Uri($"{_endpoint}{url}");
35.                     object[] body = { new { Text = text } };
36.                     var requestBody = JsonConvert.SerializeObject(body);
37.                     request.Content = new StringContent(requestBody, Encoding.UTF8, "application/json");
38.                     request.Headers.Add("Ocp-Apim-Subscription-Key", _key);
40.                     var response = client.SendAsync(request).ConfigureAwait(false).GetAwaiter().GetResult();
41.                     if (!response.IsSuccessStatusCode)
42.                     {
43.                         return null;
44.                     }
45.                     string result = response.Content.ReadAsStringAsync().Result;
46.                     var translationResults = JsonConvert.DeserializeObject<TranslationResult[]>(result);
47.                     if (translationResults.Length > 0)
48.                     {
49.                         return translationResults[0].Translations.FirstOrDefault()?.Text;
50.                     }
51.                 }
52.             }
53.             return null;
54.         }
55.     }
56. }

复制代码

这里用到了几个参数类

1. namespace I18N.Translation
2. {
3.     public class TranslationResult
4.     {
5.         public DetectedLanguage DetectedLanguage { get; set; }
6.         public Translation[] Translations { get; set; }
7.     }
9.     public class DetectedLanguage
10.     {
11.         public string Language { get; set; }
12.         public float Score { get; set; }
13.     }
14.     public class Translation
15.     {
16.         public string Text { get; set; }
17.         public string To { get; set; }
18.     }
19. }

复制代码

四、多语言词条翻译服务-有道云翻译服务
这里我们同时实现了有道云翻译服务

1. using System;
2. using System.Linq;
3. using System.Collections.Generic;
4. using System.Net.Http;
5. using System.Web;
6. using I18N.SPI;
8. namespace I18N.Translation
9. {
10.     /// <summary>
11.     /// 有道云翻译服务
12.     /// </summary>
13.     /// <remarks>
14.     /// https://ai.youdao.com/DOCSIRMA/html/%E8%87%AA%E7%84%B6%E8%AF%AD%E8%A8%80%E7%BF%BB%E8%AF%91/API%E6%96%87%E6%A1%A3/%E6%96%87%E6%9C%AC%E7%BF%BB%E8%AF%91%E6%9C%8D%E5%8A%A1/%E6%96%87%E6%9C%AC%E7%BF%BB%E8%AF%91%E6%9C%8D%E5%8A%A1-API%E6%96%87%E6%A1%A3.html
15.     /// </remarks>
16.     public class YoudaoTranslateService : II18NTermTranslateService
17.     {
18.         private string appKey = "XXXXXX";
19.         private string appKeyMY = "XXXXXXXXX";
21.         public string Translate(string text, string language)
22.         {
23.             return Post(text, language);
24.         }
26.         public void Translate(List<I18NTerm> terms, string language)
27.         { }
29.         private string Post(string text, string language)
30.         {
31.             var salt = ToUnixTime(DateTime.Now);
32.             var sign = Encryptor.MD5Hash(appKey + text + salt + appKeyMY).ToUpper();
34.             switch (language.ToLower())
35.             {
36.                 case "zh-cn": language = "zh-CHS"; break;
37.                 case "en-us": language = "EN"; break;
38.             }
40.             HttpClient client = new HttpClient();
42.             var encodedText = System.Uri.EscapeUriString(text);
43.             var url = @"https://openapi.youdao.com/api?q=" + encodedText + "&from=auto&to=" + language + "&appKey=" + appKey + "&salt=" + salt + "&sign=" + sign;            
44.             var result = client.GetStringAsync(url).Result;
46.             //{"returnPhrase":["系统"],"query":"系统","errorCode":"0","l":"zh-CHS2en","tSpeakUrl":"https://openapi.youdao.com/ttsapi?q=system&langType=en&sign=F1945F1CB2D0AEEE40B1277E6C871770&salt=1665580681639&voice=4&format=mp3&appKey=48045ce9f1d5f934&ttsVoiceStrict=false","web":[{"value":["System","lineage","Systematic problem-solving","Windows XP"],"key":"系统"},{"value":["Operating System","OS","Linux"],"key":"操作系统"},{"value":["Domain Name System","Domain Name Server","Domain System"],"key":"域名系统"}],"requestId":"cf134fc6-812b-49ab-a97a-85e56e6697cd","translation":["system"],"dict":{"url":"yddict://m.youdao.com/dict?le=eng&q=%E7%B3%BB%E7%BB%9F"},"webdict":{"url":"http://mobile.youdao.com/dict?le=eng&q=%E7%B3%BB%E7%BB%9F"},"basic":{"phonetic":"xì tǒng","explains":["system"]},"isWord":true,"speakUrl":"https://openapi.youdao.com/ttsapi?q=%E7%B3%BB%E7%BB%9F&langType=zh-CHS&sign=DF2CDF4E306FC8C4F8E224C6E7436B26&salt=1665580681639&voice=4&format=mp3&appKey=48045ce9f1d5f934&ttsVoiceStrict=false"}
47.             var dataResult = Newtonsoft.Json.JsonConvert.DeserializeObject<YoudaoResult>(result);
48.             if (dataResult != null)
49.             {
50.                 return dataResult.translation.FirstOrDefault();
51.             }
53.             return null;
54.         }
56.         private long ToUnixTime(DateTime dateTime)
57.         {
58.             var start = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
60.             return Convert.ToInt64((dateTime.ToUniversalTime() - start).TotalMilliseconds);
61.         }
62.     }
63. }

复制代码

有道云的翻译HttpAPI涉及到了几个参数类

1.   public class YoudaoResult
2.     {
3.         /// <summary>
4.         /// 错误返回码
5.         /// </summary>
6.         public string errorCode { get; set; }
8.         /// <summary>
9.         /// 源语言和目标语言
10.         /// </summary>
11.         public string l { get; set; }
13.         /// <summary>
14.         /// 源语言
15.         /// </summary>
16.         public string query { get; set; }
18.         /// <summary>
19.         /// 源语言
20.         /// </summary>
21.         public List<string> translation { get; set; }
22.     }

复制代码

 
以上是和大家分享多语言翻译服务的设计和实现。
 
周国庆
2023/3/19

来源:https://www.cnblogs.com/tianqing/archive/2023/03/20/17232559.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！