上篇文章我們介紹了
系統國際化改造整體設計思路如下:
- 提供一個工具,識別前後端程式碼中的中文,形成多語言詞條,按語言、介面、模組統一管理多有的多語言詞條
- 提供一個翻譯服務,批次翻譯多語言詞條
- 提供一個詞條服務,支援後端程式碼在執行時根據使用者登入的語言,動態獲取對應的多語言文字
- 提供前端多語言JS生成服務,按介面動態生成對應的多語言JS檔案,方便前端VUE檔案使用。
- 提供程式碼替換工具,將VUE前端程式碼中的中文替換為$t("詞條ID"),後端程式碼中的中文替換為TermService.Current.GetText("詞條ID")
今天,我們繼續介紹多語言詞條服務的設計和實現。
一、多語言詞條設計
什麼是多語言詞條,即程式碼中需要支援多語言的文字。例如後臺提示、前端介面的各類顯示元素(Label、Button文字、Tooltips、標題、列表標題等等)。這些內容統一抽象為多語言詞條。
多語言詞條是產品多語言包的組成部分。支援在不同的語言下,顯示對應的文字。
上圖中:
I18NTerm代表多語言詞條物件,主要描述了多語言詞條的各個屬性,主要的幾個屬性有:
/// <summary> /// 詞條的key /// </summary> public string Code { get; set; } /// <summary> /// 詞條的名稱 /// </summary> public string Name { get; set; } /// <summary> /// 原始文字 /// </summary> public string OriginalText { get; set; } /// <summary> /// 多語言詞條子項 /// </summary> public List<I18NTermItem> TranslateItems { get; set; } = new List<I18NTermItem>(); /// <summary> /// 隸屬的產品 /// </summary> public string Product { get; set; } /// <summary> /// 隸屬的關鍵應用/系統 /// </summary> /// <remarks> /// 用於批次打包國際化JS檔案 /// </remarks> public string SubSystem { get; set; } /// <summary> /// 隸屬的關鍵應用/系統編號 /// </summary> /// <remarks> /// 用於批次打包國際化JS檔案 /// </remarks> public string SubSystemCode { get; set; }
一條詞條,包含多個詞條子項I18NTermItem,每一個詞條子項,都代表了一種語言的翻譯結果
public class I18NTermItem : CacheElement { /// <summary> /// 詞條ID /// </summary> public string TermID { get; set; } /// <summary> /// 語言 /// </summary> public string Language { get; set; } /// <summary> /// 翻譯的文字 /// </summary> public string TranslateText { get; set; } /// <summary> /// 使用者自定義文字 /// </summary> public string CustomText { get; set; } public string GetText() { if (string.IsNullOrEmpty(CustomText)) { return TranslateText; } return CustomText; } }
二、多語言詞條管理服務
有了多語言詞條物件後,需要增加其對應的多語言詞條管理服務,用於對詞條的增刪查改
先定義一個多語言詞條管理的介面II18NTermManageService
public interface II18NTermManageService { void Add(I18NTerm term); void Remove(string termId); void AddTerms(List<I18NTerm> terms); void RemoveTerms(List<string> terms); void Update(I18NTerm term); I18NTerm GetTerm(string termId); List<I18NTerm> GetTerms(); List<I18NTerm> GetTerms(string sourceId); List<I18NTerm> GetTermsByApplication(string applicationId); List<I18NTerm> GetTermByConditions(string applicationId, string sourceId = null, string sourceLocation = null, string Dimension1 = null, string Dimension2 = null, string Dimension3 = null); }
這個介面對應的實現中,可以採用EF完成詞條資料的持久化操作,在這裡不再詳細展示了,大家根據需求自行實現即可。
三、多語言詞條查詢服務
系統在執行時,需要呼叫詞條服務查詢各類詞條的翻譯文字。因此,抽象一個多語言詞條查詢服務介面II18NTermService
/// <summary> /// 詞條查詢服務介面 /// </summary> public interface II18NTermService { /// <summary> /// 根據詞條編號獲取對應的詞條翻譯 /// </summary> /// <param name="termCode">詞條編號</param> /// <param name="defaultText">預設值,如果根據編號找不到詞條或者詞條對應的翻譯將返回預設值</param> /// <returns></returns> string GetText(string termCode, string defaultText); /// <summary> /// 根據詞條編號獲取對應的詞條翻譯並格式化輸出 /// </summary> /// <param name="termCode">詞條編號</param> /// <param name="defaultText">預設值,如果根據編號找不到詞條或者詞條對應的翻譯將返回預設值</param> /// <param name="args">包含零個或多個要格式化的物件的物件陣列</param> /// <returns></returns> string GetTextFormatted(string termCode, string defaultText, params object[] args); /// <summary> /// 根據詞條編號獲取對應的詞條翻譯 /// </summary> /// <param name="termCode">詞條編號</param> /// <param name="language">語言標識</param> /// <param name="defaultText">預設值,如果根據編號找不到詞條或者詞條對應的翻譯將返回預設值</param> /// <returns></returns> string GetTextWithlanguage(string termCode,string language, string defaultText); /// <summary> /// 根據詞條編號獲取對應的詞條翻譯並格式化輸出 /// </summary> /// <param name="termCode">詞條編號</param> /// <param name="language">語言標識</param> /// <param name="defaultText">預設值,如果根據編號找不到詞條或者詞條對應的翻譯將返回預設值</param> /// <param name="args">包含零個或多個要格式化的物件的物件陣列</param> /// <returns></returns> string GetTextFormattedWithlanguage(string termCode, string language, string defaultText, params object[] args); /// <summary> /// 批次獲取詞條,注意:此介面不能在特來電生產環境使用。 /// </summary> /// <param name="termCodes"></param> /// <returns></returns> Dictionary<string,string> BatchGetText(List<string> termCodes); }
這個介面的具體實現中,可以增加詞條的Redis快取和記憶體快取,呼叫II18NTermManageService的實現邏輯,從資料庫中查詢持久化的詞條資料。快取到記憶體和Redis中, 以提升查詢效能。
例如:
/// <summary> /// 獲取詞條翻譯 /// </summary> /// <param name="termCode">詞條編號</param> /// <param name="defaultText">預設值,當找不到對應的詞條時將返回預設值</param> /// <returns></returns> /// <exception cref="ArgumentNullException"></exception> public string GetText(string termCode, string defaultText) { if (string.IsNullOrWhiteSpace(termCode)) throw new ArgumentNullException($"Term Code is null, {termCode}"); if (Teld.Core.Session.Service.AppContext.Current.Language == null) { return defaultText; } string language = T.Core.Session.Service.AppContext.Current.Language.DisplayCode; string key = termCode + "&" + language; if (cache.TryGetValue(key, out var val)) { return val; } var termItem = termManageService.GetTermItem(termCode, language); if (termItem == null) { TermMonitor.NotFound(termCode, language); return defaultText; } else { string text = termItem.GetText(); cache[key] = text; return text; } }
以上是多語言詞條服務的設計和實現。
分享給大家
周國慶
2023/3/11