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