Bboss國(guó)際化實(shí)踐

1、Bboss國(guó)際化實(shí)踐界面文字、圖片、logo、按鈕國(guó)際化消息提示框國(guó)際化CSS樣式文件、JS文件國(guó)際化 后臺(tái)輸出數(shù)據(jù)和日志國(guó)際化業(yè)務(wù)數(shù)據(jù)（貨幣單位、字典數(shù)據(jù)）國(guó)際化 范圍思路基于平臺(tái)業(yè)務(wù)系統(tǒng)國(guó)際化輔助第三方系統(tǒng)國(guó)際化目 標(biāo)國(guó)際化思路和目標(biāo)基礎(chǔ)框架提供國(guó)際化機(jī)制和通用用國(guó)際化組件公共開(kāi)發(fā)平臺(tái)國(guó)際化制定標(biāo)準(zhǔn)國(guó)際化UI規(guī)范公共控件（標(biāo)簽庫(kù)，js庫(kù)）國(guó)際化平臺(tái)提供菜單國(guó)際化機(jī)制提供靈活的資源文件加載機(jī)制：可加載web應(yīng)用目錄下資源文件可加載classpath對(duì)應(yīng)目錄及子目錄下資源文件bboss框架國(guó)際化機(jī)制特點(diǎn)國(guó)際化機(jī)制提供多種國(guó)別代碼識(shí)別機(jī)制: Session,瀏覽器設(shè)置，Cookie。采用插件來(lái)實(shí)

2、現(xiàn)不同的國(guó)別代碼識(shí)別機(jī)制采用國(guó)際通用的properties文件來(lái)配置和管理國(guó)際化信息提供國(guó)際化屬性配置文件緩沖機(jī)制，確保運(yùn)行時(shí)性能最優(yōu)化，并提供熱加載機(jī)制（在線修改，實(shí)時(shí)加載），確保開(kāi)發(fā)效率最大化提供屬性配置文件模塊化管理機(jī)制，每個(gè)模塊可以有自己的屬性配置文件國(guó)際化機(jī)制和組件與平臺(tái)IOC框架、MVC框架、標(biāo)簽庫(kù)天然結(jié)合提供靈活的國(guó)際化菜單信息獲取api菜單國(guó)際化機(jī)制特點(diǎn)國(guó)際化機(jī)制與平臺(tái)國(guó)際化機(jī)制共用國(guó)別代碼識(shí)別、設(shè)置管理機(jī)制以平臺(tái)國(guó)際化機(jī)制為基礎(chǔ)實(shí)現(xiàn)平臺(tái)菜單國(guó)際化機(jī)制（緩沖機(jī)制、熱加載機(jī)制等等）提供菜單國(guó)際化的導(dǎo)航標(biāo)簽：一級(jí)top導(dǎo)航國(guó)際化標(biāo)簽，左側(cè)菜單國(guó)際化導(dǎo)航標(biāo)簽，當(dāng)前位置國(guó)際化導(dǎo)航標(biāo)簽主

3、子系統(tǒng)即可共用相同的菜單國(guó)際化屬性配置文件，也可以有自己的菜單國(guó)際化屬性配置文件菜單國(guó)際化內(nèi)容有：系統(tǒng)名稱、系統(tǒng)logo圖片、菜單標(biāo)題、菜單描述、菜單鼠標(biāo)事件圖片國(guó)際化屬性文件命名、配置、存儲(chǔ)規(guī)范國(guó)際化配置屬性文件命名規(guī)范messages_模塊名稱_國(guó)別代碼.properties模塊名稱:系統(tǒng)模塊的英文簡(jiǎn)稱，可選，可以不要國(guó)別代碼:國(guó)家的英文代碼，例如zh_CN,en_US實(shí)例:messages_module_en_US.propertiesmessages_module_zh_CN.properties屬性命名規(guī)范：類似于java包路徑的命名規(guī)則，實(shí)例如下pdp.module.current

4、position=您的當(dāng)前位置：pdp.module.personcenter=個(gè)人中心國(guó)際化屬性文件命名、配置、存儲(chǔ)規(guī)范國(guó)際化配置Web應(yīng)用目錄中的屬性文件存儲(chǔ)、配置、加載與mvc框架結(jié)合的國(guó)際化屬性文件存儲(chǔ)和配置屬性文件存儲(chǔ)在WEB-INF目錄或者WEB-INF子目錄下國(guó)際化屬性文件命名、配置、存儲(chǔ)規(guī)范國(guó)際化配置Web應(yīng)用目錄中屬性文件存儲(chǔ)、配置、加載與mvc框架結(jié)合的國(guó)際化屬性文件配置和加載在web.xml文件的mvc攔截器中配置，多個(gè)文件用逗號(hào)分隔，這些屬性配置文件在mvc框架初始化時(shí)進(jìn)行加載國(guó)際化屬性文件命名、配置、存儲(chǔ)規(guī)范國(guó)際化配置Web應(yīng)用目錄中屬性文件存儲(chǔ)、配置、加載可以獨(dú)立加

5、載存儲(chǔ)在web應(yīng)用目錄下的屬性配置文件，方法如下：注意：mvc的配置方法、獨(dú)立加載方法，包括后面要介紹的的從classpath中直接加載屬性配置文件時(shí)，屬性文件名稱都不能帶國(guó)別標(biāo)識(shí)和.properties后綴。需要指定兩個(gè)參數(shù)，第一個(gè)參數(shù)就是國(guó)際化文件在web應(yīng)用下的存儲(chǔ)路徑，第二個(gè)參數(shù)ServletContext對(duì)象，必須指定否則無(wú)法獲取web應(yīng)用絕對(duì)目錄地址國(guó)際化屬性文件命名、配置、存儲(chǔ)規(guī)范國(guó)際化配置菜單國(guó)際化配置和加載菜單國(guó)際化包括：系統(tǒng)名稱、系統(tǒng)logo圖片、菜單標(biāo)題、菜單描述、菜單鼠標(biāo)事件圖片，相應(yīng)配置都在系統(tǒng)菜單配置文件中進(jìn)行，我們以module.xml文件作為示例來(lái)說(shuō)明：菜單國(guó)際

6、化語(yǔ)言范圍配置：在module.xml的根元素system上進(jìn)行配置，languages屬性指定了菜單國(guó)際化支持的語(yǔ)言種類，多個(gè)用逗號(hào)分隔在sysmenu上指定messagesource屬性，來(lái)指定菜單的一些全局國(guó)際化配置文件的地址，多個(gè)用逗號(hào)分隔，比如：當(dāng)前位置的前綴配置，個(gè)人中心配置等等，多個(gè)系統(tǒng)可以共有一個(gè)配置文件，系統(tǒng)只加載一次在sysmenu的子元素description上指定i18n:+國(guó)別標(biāo)識(shí)來(lái)設(shè)定系統(tǒng)標(biāo)題的國(guó)際化設(shè)置國(guó)際化屬性文件命名、配置、存儲(chǔ)規(guī)范國(guó)際化配置菜單國(guó)際化配置和加載系統(tǒng)首頁(yè)和系統(tǒng)logo的國(guó)際化配置，在publicitem上指定i18n:+國(guó)別標(biāo)識(shí)來(lái)設(shè)定首頁(yè)標(biāo)題的

7、國(guó)際化設(shè)置，在publicitem中content元素上指定i18n:+國(guó)別標(biāo)識(shí)來(lái)設(shè)定系統(tǒng)logo的國(guó)際化設(shè)置國(guó)際化屬性文件命名、配置、存儲(chǔ)規(guī)范國(guó)際化配置菜單國(guó)際化配置和加載系統(tǒng)模塊(module)和菜單(item)標(biāo)題，module和item的配置類似，以item為例進(jìn)行說(shuō)明：在item元素上指定i18n:+國(guó)別標(biāo)識(shí)來(lái)設(shè)定菜單標(biāo)題的國(guó)際化：國(guó)際化屬性文件命名、配置、存儲(chǔ)規(guī)范國(guó)際化配置菜單國(guó)際化文件配置和加載系統(tǒng)菜單(item) 鼠標(biāo)事件國(guó)際化配置，菜單鼠標(biāo)事件包括click，over，up，out四個(gè)，在相應(yīng)的xml元素上指定i18n:+國(guó)別標(biāo)識(shí)來(lái)設(shè)定相應(yīng)事件圖片的國(guó)際化設(shè)置：說(shuō)明：菜單中原

8、有的相關(guān)配置將被默認(rèn)作為zh_CN的配置，因此zh_CN的國(guó)際化配置無(wú)需單獨(dú)額外配置，比如publicitem name=首頁(yè) i18n:en_US=“Index” 中，name屬性的值就是對(duì)于與zh_Cn的國(guó)際化配置，如果其他語(yǔ)言沒(méi)有指定，那么默認(rèn)輸出中文值。國(guó)際化屬性文件命名、配置、存儲(chǔ)規(guī)范國(guó)際化配置Classpath國(guó)際化文件的配置和加載Classpath中國(guó)際化文件無(wú)需進(jìn)行額外配置，可以直接通過(guò)國(guó)際化組件進(jìn)行加載：說(shuō)明：如果要加載多個(gè)配置文件，請(qǐng)用逗號(hào)分隔MessageSource messageSource = MessageSourceUtil.getMessageSource(o

9、rg/frameworkset/servlet/i18n/messages_module);國(guó)際化國(guó)別語(yǔ)言設(shè)置國(guó)際化組件可以從session，request請(qǐng)求頭（瀏覽器設(shè)置），Cookie（目前未提供）中獲取事先設(shè)置好的語(yǔ)言對(duì)象Locale，這里以session方式為例進(jìn)行說(shuō)明：首先要在bboss-mvc.xml設(shè)置session locale對(duì)象解析插件并指定sessionlocalkey名稱國(guó)際化國(guó)別語(yǔ)言設(shè)置在登錄頁(yè)進(jìn)行語(yǔ)言選擇和設(shè)置：國(guó)際化國(guó)別語(yǔ)言設(shè)置在登錄頁(yè)選擇的語(yǔ)言設(shè)置到session中即可：國(guó)際化組件和標(biāo)簽平臺(tái)和框架提供了一系列國(guó)際化組件和標(biāo)簽來(lái)簡(jiǎn)化系統(tǒng)國(guó)際化工作的開(kāi)展，組件和標(biāo)

10、簽的使用也非常簡(jiǎn)單：Java組件：org.frameworkset.web.servlet.support.RequestContextUtilsorg.frameworkset.spi.support.MessageSourceorg.frameworkset.web.servlet.i18n.WebMessageSourceUtil/獲取語(yǔ)言代碼String local_request = RequestContextUtils.getRequestContextLocalName(request);/獲取語(yǔ)言對(duì)象Locale locale = RequestContextUtils.ge

11、tRequestContextLocale(request);/加載classpath下的國(guó)際化配置文件MessageSource messageSource = WebMessageSourceUtil.getMessageSource(org/frameworkset/servlet/i18n/messages_module);/傳入code和locale對(duì)象，獲取對(duì)應(yīng)語(yǔ)言的的值String message = messageSource.getMessage(pdp.module.personcenter, locale);Java組件使用方法國(guó)際化組件和標(biāo)簽平臺(tái)和框架提供了一系列國(guó)際化

12、組件和標(biāo)簽來(lái)簡(jiǎn)化系統(tǒng)國(guó)際化工作的開(kāi)展，組件和標(biāo)簽的使用也非常簡(jiǎn)單：Java組件：org.frameworkset.web.servlet.support.RequestContextUtilsorg.frameworkset.spi.support.MessageSourceorg.frameworkset.web.servlet.i18n.WebMessageSourceUtil/從web應(yīng)用目錄下加載國(guó)際化屬性配置文件（兩個(gè)以上文件用逗號(hào)分隔），獲取MessageSource對(duì)象第一個(gè)參數(shù)代表所有的配置文件，第二個(gè)參數(shù)為ServletContext對(duì)象，必須指定否則無(wú)法獲取web應(yīng)用絕對(duì)目

13、錄地址MessageSource ms = WebMessageSourceUtil.getMessageSource(/WEB-INF/messages_pdp,+/WEB-INF/messages_pdp_common,/WEB-INF/conf/appbom/messages_appbom, pageContext.getServletContext() ;String message =ms .getMessage(Trans.Log.TransformationIsToAllocateStep,newObjecta,b,Locale.SIMPLIFIED_CHINESE);屬性為：T

14、rans.Log.TransformationIsToAllocateStep= 轉(zhuǎn)換大約分配了 步驟 0 類型的 1輸出為：轉(zhuǎn)換大約分配了 步驟 a 類型的 bJava組件使用方法-web應(yīng)用目錄下文件模式國(guó)際化組件和標(biāo)簽平臺(tái)和框架提供了一系列國(guó)際化組件和標(biāo)簽來(lái)簡(jiǎn)化系統(tǒng)國(guó)際化工作的開(kāi)展，組件和標(biāo)簽的使用也非常簡(jiǎn)單：標(biāo)簽組件local（在頁(yè)面上輸出國(guó)別代碼），message（獲取國(guó)際化信息），使用方法如下：前提：在jsp頭部導(dǎo)入標(biāo)簽定義文件： 輸出相應(yīng)的語(yǔ)言代碼，例如：zh_CNprobe.jsp.wrongparams=轉(zhuǎn)換大約分配了5個(gè)步驟輸出屬性probe.jsp.wrongparams

15、對(duì)應(yīng)的值：轉(zhuǎn)換大約分配了5個(gè)步驟國(guó)際化組件和標(biāo)簽平臺(tái)和框架提供了一系列國(guó)際化組件和標(biāo)簽來(lái)簡(jiǎn)化系統(tǒng)國(guó)際化工作的開(kāi)展，組件和標(biāo)簽的使用也非常簡(jiǎn)單：標(biāo)簽組件local（在頁(yè)面上輸出國(guó)別代碼），message（獲取國(guó)際化信息），使用方法如下：probe.jsp.wrongparams=轉(zhuǎn)換大約分配了步驟0類型的1，2，3輸出屬性probe.jsp.wrongparams對(duì)應(yīng)的值為：轉(zhuǎn)換大約分配了步驟a類型的b，c，d輸出屬性probe.jsp.wrongparams對(duì)應(yīng)的值為：轉(zhuǎn)換大約分配了步驟a類型的b，c，d國(guó)際化組件和標(biāo)簽平臺(tái)和框架提供了一系列國(guó)際化組件和標(biāo)簽來(lái)簡(jiǎn)化系統(tǒng)國(guó)際化工作的開(kāi)展，組件和標(biāo)

16、簽的使用也非常簡(jiǎn)單：標(biāo)簽組件Title增加titlecode屬性，標(biāo)題國(guó)際化代碼，如果代碼在mvc國(guó)際化相關(guān)配置文件中不存在，則輸出code。使用方法如下：/probe.jsp.wrongparams=主鍵名稱國(guó)際化組件和標(biāo)簽平臺(tái)和框架提供了一系列國(guó)際化組件和標(biāo)簽來(lái)簡(jiǎn)化系統(tǒng)國(guó)際化工作的開(kāi)展，組件和標(biāo)簽的使用也非常簡(jiǎn)單：mvc容器國(guó)際化屬性java獲取方法public static String getI18nMessage(String code,Object args,String defaultMessage,HttpServletRequest request)Locale locale

17、 = RequestContextUtils.getRequestContextLocal(request);MessageSource messageSource = WebApplicationContextUtils.getWebApplicationContext();if(messageSource != null)return messageSource.getMessage(code, locale);/return messageSource.getMessage(code, defaultMessage, locale);/return messageSource.getMessage(code, args, locale);/return messageSource.getMessage(code, args, defaultMessage, locale);elseif(defaultMessage != null)return defaultMessage;elsereturn code;國(guó)際化組件熱加載機(jī)制配置國(guó)際化組件提供了簡(jiǎn)單實(shí)用的國(guó)際化屬性文件熱加載機(jī)制，可以方便地開(kāi)啟和關(guān)閉熱加載機(jī)制。 檢測(cè)文