國(guó)際化信息理解
國(guó)際化信息也稱為本地化信息 祟霍。 Java 通過 java.util.Locale 類來表示本地化對(duì)象杏头,它通過 “語言類型” 和 “國(guó)家/地區(qū)” 來創(chuàng)建一個(gè)確定的本地化對(duì)象 。舉個(gè)例子吧沸呐,比如在發(fā)送一個(gè)具體的請(qǐng)求的時(shí)候醇王,在header中設(shè)置一個(gè)鍵值對(duì):"Accept-Language":"zh",通過Accept-Language對(duì)應(yīng)值崭添,服務(wù)器就可以決定使用哪一個(gè)區(qū)域的語言寓娩,找到相應(yīng)的資源文件,格式化處理呼渣,然后返回給客戶端棘伴。
MessageSource
Spring 定義了 MessageSource 接口,用于訪問國(guó)際化信息屁置。
getMessage(String code, Object[] args, String defaultMessage, Locale locale)
getMessage(String code, Object[] args, Locale locale)
getMessage(MessageSourceResolvable resolvable, Locale locale)
?MessageSourceAutoConfiguration
?springboot提供了國(guó)際化信息自動(dòng)配置類焊夸,配置類中注冊(cè)了ResourceBundleMessageSource實(shí)現(xiàn)類。
首先MessageSource配置生效依靠一個(gè)ResourceBundleCondition條件蓝角,從環(huán)境變量中讀取spring.messages.basename對(duì)應(yīng)的值阱穗,默認(rèn)值是messages,這個(gè)值就是MessageSource對(duì)應(yīng)的資源文件名稱使鹅,資源文件擴(kuò)展名是.properties揪阶,然后通過PathMatchingResourcePatternResolver從“classpath*:”目錄下讀取對(duì)應(yīng)的資源文件,如果能正常讀取到資源文件并徘,則加載配置類遣钳。
?springmvc自動(dòng)裝配配置類,注冊(cè)了一個(gè)RequestContextFilter過濾器。
?每一次請(qǐng)求蕴茴,LocaleContextHolder都會(huì)保存當(dāng)前請(qǐng)求的本地化信息劝评。
?通過MessageSourceAccessor根據(jù)code獲取具體信息時(shí),如果默認(rèn)配置的本地化對(duì)象為空倦淀,則通過LocaleContextHolder獲取蒋畜。
?上圖的messageSource是應(yīng)用程序上下文對(duì)象(本文創(chuàng)建的是GenericWebApplicationContext實(shí)例),該messageSource對(duì)象會(huì)調(diào)用ResourceBundleMessageSource實(shí)例獲取具體信息撞叽。
ValidationAutoConfiguration
參數(shù)校驗(yàn)hibernate-validator是通過這個(gè)自動(dòng)裝配加載進(jìn)來的姻成。
MethodValidationPostProcessor這個(gè)后置處理處理方法里單個(gè)參數(shù)校驗(yàn)的注解(JSR和Hibernate validator的校驗(yàn)只能對(duì)Object的屬性(也就是Bean的域)進(jìn)行校驗(yàn),不能對(duì)單個(gè)的參數(shù)進(jìn)行校驗(yàn)愿棋。)科展。
LocalValidatorFactoryBean實(shí)現(xiàn)了javax.validation.ValidatorFactory和javax.validation.Validator這兩個(gè)接口,以及Spring的org.springframework.validation.Validator接口糠雨,你可以將這些接口當(dāng)中的任意一個(gè)注入到需要調(diào)用驗(yàn)證邏輯的Bean里才睹。
?默認(rèn)情況下,LocalValidatorFactoryBean創(chuàng)建的validator使用PlatformResourceBundleLocator獲取資源的綁定關(guān)系甘邀,獲取的資源名稱是:ValidationMessages
?用戶自定義的校驗(yàn)信息放在項(xiàng)目classpath目錄下琅攘。
另外hibernate-validator還會(huì)加載默認(rèn)的校驗(yàn)資源文件,名稱是:org.hibernate.validator.ValidationMessages松邪∥肭伲可以看到,默認(rèn)的校驗(yàn)資源捆綁文件包含了不同區(qū)域的信息的配置逗抑。
通過LocalValidatorFactoryBean獲取的validator是如何根據(jù)不同的地區(qū)加載不同校驗(yàn)資源文件呢剧辐?hibernate-validator暴露了一個(gè)消息插補(bǔ)器(MessageInterpolator),spring正是重新代理這個(gè)消息插補(bǔ)器锋八。
?通過LocaleContextMessageInterpolator源碼浙于,可以看到最終還是通過LocaleContextHolder獲取當(dāng)前時(shí)區(qū)信息。
是否可以自定義國(guó)際化校驗(yàn)的資源信息呢挟纱?當(dāng)然是肯定的羞酗,我們只需要重寫LocalValidatorFactoryBean類型bean的創(chuàng)建過程,通過setValidationMessageSource方法指定自定義的資源信息紊服。
MessageSource測(cè)試
基礎(chǔ)測(cè)試
建立Resouce bundle messages
編寫message source測(cè)試方法檀轨,從request中獲取當(dāng)前Locale值
?編寫測(cè)試類,指定當(dāng)前請(qǐng)求的Locale值或者設(shè)置請(qǐng)求頭的header值:Accept-Language:zh
根據(jù)測(cè)試類中請(qǐng)求的Locale值不同欺嗤,獲取到的文本也不同参萄。
格式化測(cè)試
建立Resouce bundle messages
編寫message source測(cè)試方法,從request中獲取當(dāng)前Locale值
?編寫測(cè)試類煎饼,指定當(dāng)前請(qǐng)求的Locale值或者設(shè)置請(qǐng)求頭的header值:Accept-Language:zh
根據(jù)測(cè)試類中請(qǐng)求的Locale值不同讹挎,獲取到的格式化的文本也不同。
靜態(tài)message source測(cè)試
動(dòng)態(tài)注冊(cè)message(可區(qū)分Locale),可用于自定義message source筒溃。
編寫測(cè)試的方法马篮,通過MessageSourceAccessor訪問。
?編寫測(cè)試類怜奖,獲取自定義message source中的信息浑测。
根據(jù)測(cè)試類中請(qǐng)求的Locale值不同,獲取到的文本也不同歪玲。