張 舒
(北京全路通信信號研究設計院集團有限公司,北京 100070)
目前越來越多的項目有了國際化需求,國際化主要是指根據(jù)語言選擇,顯示符合不同國家閱讀習慣的頁面和數(shù)據(jù)。國際化功能不僅需要將前臺界面固定使用的文本元素進行翻譯,對于程序動態(tài)產生的數(shù)據(jù)也需要進行翻譯展示。針對固定文本信息的翻譯,可以使用通用的i18n組件,根據(jù)用戶當前選擇語言類型,從語言配置文件中提取相應的內容。后臺數(shù)據(jù)的翻譯功能,目前主流方案主要有以下兩種。
使用翻譯網(wǎng)站提供的在線翻譯api。這種方式不需要自備翻譯數(shù)據(jù)集,方便靈活。但是當需要前后臺交互并涉及到業(yè)務邏輯時,雖然可以將前臺輸入內容進行反向翻譯統(tǒng)一成同一種語言內容,但是無法保證傳遞給邏輯業(yè)務數(shù)據(jù)內容的唯一可識別性。因此該方法僅適用于只展示動態(tài)數(shù)據(jù),不對動態(tài)數(shù)據(jù)進行業(yè)務邏輯的情況。此外,正常網(wǎng)絡訪問也是使用此方法的必備條件。
構建數(shù)據(jù)字典,包括鍵值及對應的翻譯語言內容。前后臺交互及后臺業(yè)務使用鍵值,前臺顯示時使用翻譯內容。此方案完美解決了輸入內容唯一可識別的需求,但是需要將待翻譯的字段擴展為鍵值和翻譯內容兩個字段。這種方式要在程序設計時就考慮進去,如果是在業(yè)務開發(fā)完成或部分完成后增加,需要重新梳理并修改前后臺數(shù)據(jù)結構,增大了開發(fā)工作量。
基于以上情況,因此需要設計一種易于配置并且具有高可復用性的框架實現(xiàn)動態(tài)數(shù)據(jù)翻譯工作。
動態(tài)數(shù)據(jù)翻譯框架設計如圖1所示。
圖1 翻譯框架設計Fig.1 Translation framework design
此框架設計遵循分層原則,劃分不同層的功能職責。其中Aspect用于對請求的參數(shù)及返回值攔截,調用翻譯服務進行字段翻譯更新數(shù)據(jù)內容;Service層(服務層)提供翻譯服務,承擔該框架的主要業(yè)務;Dao層(數(shù)據(jù)訪問層)實現(xiàn)數(shù)據(jù)持久化功能,與數(shù)據(jù)源交互。框架內默認設置翻譯服務包括中文、英文,如需擴展語言類型,使用時需要填寫在配置文件中并更新數(shù)據(jù)庫結構及內容。此功能是通過使用Cglib動態(tài)擴展java類及其接口實現(xiàn)。應用此框架,后臺接收到請求后的運行時序如下。
1)解析請求的語言類型;
2)具有入?yún)⒎g標簽的方法進行入?yún)⒔Y構掃描,國際化功能處理成統(tǒng)一可識別鍵值;
3)核心業(yè)務邏輯處理;
受胎率用SPSS19.0統(tǒng)計軟件進行卡方檢驗,精子活率和精子頂體完整率用單因素方差分析,結果用“平均值±標準差”表示。P<0. 05表示差異顯著,P>0. 05表示差異不顯著。
4)具有返回值翻譯標簽的方法進行返回值結構掃描,國際化功能處理成翻譯后的內容;
5)返回替換翻譯值后的響應內容。
應用此方案,基于動態(tài)數(shù)據(jù)翻譯的請求http請求過程如圖2所示,對于B/S架構的前臺而言,僅需在http請求頭中增加語言類型屬性。
圖2 http請求過程Fig.2 HTTP request process
此方案的優(yōu)點如下。
1)對于已存在的項目進行國際化功能添加時,不會變動原有數(shù)據(jù)結構,與業(yè)務解耦。
2)使用注解標注需要翻譯的接口、翻譯類型(正向翻譯/反向翻譯)以及待翻譯字段,使用AOP進行請求攔截和翻譯織入,可以縮減代碼,控制開發(fā)成本。
3)對于需要增擴翻譯的語言種類和語言內容,可以動態(tài)擴展字典表并進行文件配置,無需增添代碼。
動態(tài)數(shù)據(jù)翻譯框架與已有程序的結構兼容情況如圖3所示。
圖3 翻譯框架兼容Fig.3 Compatibility of translation framework
動態(tài)數(shù)據(jù)翻譯框架搭建步驟如下。
1) 建立數(shù)據(jù)表,內容包括鍵值、需要翻譯的語言類型,比如中文、英文。其中鍵值是標記翻譯內容的唯一后臺通用語言,用于在后臺服務中進行數(shù)據(jù)交換和數(shù)據(jù)存儲。
2) 翻譯字典查詢業(yè)務,提供正向翻譯和反向翻譯功能。正向翻譯是指輸入鍵值和語言種類,返回對應的語言內容;反向翻譯是指輸入翻譯內容和語言種類,返回唯一鍵值。語言種類包括中文、英文、以及自定義的語言類型。對于后者,程序讀取配置文件并通過Cglib自動進行裝配,讀取數(shù)據(jù)源數(shù)據(jù)提供對應的翻譯功能。
3)自定義注解TranslateRequest,Translate Response和Translate。其中TranslateRequest標記需要對入?yún)⑦M行反向翻譯的接口,Translate Response標記需要對返回值進行翻譯的接口,Translate標記結構體中需要參與翻譯的字段。
4)AOP切面級別攔截接口的請求和返回值。對于請求進行攔截,根據(jù)請求頭所帶語言類型,將語言內容反向翻譯為唯一鍵值,在服務中進行數(shù)據(jù)交換;對于接口返回值進行攔截,根據(jù)請求頭所帶語言類型,將返回內容中的唯一鍵值進行翻譯,替換成翻譯內容作為接口調用的響應內容。
1)前臺在http請求頭增加Language字段,標記當前前臺選擇語言類型,作為后臺接口輸入?yún)?shù)反向翻譯以及輸出參數(shù)翻譯的標準。
2)數(shù)據(jù)庫中添加翻譯字典。
3)并不是所有的接口和參數(shù)都有翻譯需求,因此只為有翻譯需求的接口和字段添加注解。在需要對入?yún)⑦M行反向翻譯的接口進行TranslateRequest標記,在需要對返回值進行翻譯的接口進行TranslateResponse標記,結構體中需要參與翻譯的字段進行Translate標記。這樣操作可以最大化減少不必要的翻譯工作。
4)如果需要增擴翻譯語言類型,需要在application.yml文件中以json的key-value格式寫入dict字段。如:dict: "{id-ID: 'C_ID'}",其中key是前后臺交互的語言類型,value是對應的數(shù)據(jù)庫列名。
需要正向翻譯的方法及返回值結構如圖4所示。
圖4 參考用例代碼Fig.4 Code of reference use case
外部調用該接口,根據(jù)請求頭Language字段值不同,返回內容不同,測試結果如圖5所示。
圖5 翻譯測試結果Fig.5 Translation test results
本文設計了一種動態(tài)數(shù)據(jù)翻譯框架,可以應用于有翻譯需求的軟件開發(fā),尤其適用于增量式開發(fā)和有前后臺交互需求的情況。借助AOP技術實現(xiàn)國際化翻譯工作與核心業(yè)務的分離,使用注解方式提高框架的易用性和可復用性。通過使用本框架,可以有效提高系統(tǒng)的開發(fā)效率,降低人力和時間成本。該方案已經應用于海外鐵路的信息化產品中并且使用效果良好,希望本框架可以為更多具有多語言動態(tài)數(shù)據(jù)翻譯需求的項目提供服務或設計思路。