【收藏=盖病0呶摺!】Springboot國(guó)際化信息(i18n)解析

國(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值不同,獲取到的文本也不同歪玲。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末迁央,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子滥崩,更是在濱河造成了極大的恐慌岖圈,老刑警劉巖,帶你破解...
    沈念sama閱讀 207,113評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件夭委,死亡現(xiàn)場(chǎng)離奇詭異幅狮,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)株灸,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,644評(píng)論 2 381
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來擎值,“玉大人慌烧,你說我怎么就攤上這事○” “怎么了屹蚊?”我有些...
    開封第一講書人閱讀 153,340評(píng)論 0 344
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)进每。 經(jīng)常有香客問我汹粤,道長(zhǎng),這世上最難降的妖魔是什么田晚? 我笑而不...
    開封第一講書人閱讀 55,449評(píng)論 1 279
  • 正文 為了忘掉前任嘱兼,我火速辦了婚禮,結(jié)果婚禮上贤徒,老公的妹妹穿的比我還像新娘芹壕。我一直安慰自己,他們只是感情好接奈,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,445評(píng)論 5 374
  • 文/花漫 我一把揭開白布踢涌。 她就那樣靜靜地躺著,像睡著了一般序宦。 火紅的嫁衣襯著肌膚如雪睁壁。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,166評(píng)論 1 284
  • 那天,我揣著相機(jī)與錄音潘明,去河邊找鬼糠惫。 笑死,一個(gè)胖子當(dāng)著我的面吹牛钉疫,可吹牛的內(nèi)容都是我干的硼讽。 我是一名探鬼主播,決...
    沈念sama閱讀 38,442評(píng)論 3 401
  • 文/蒼蘭香墨 我猛地睜開眼牲阁,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼固阁!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起城菊,我...
    開封第一講書人閱讀 37,105評(píng)論 0 261
  • 序言:老撾萬榮一對(duì)情侶失蹤备燃,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后凌唬,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體并齐,經(jīng)...
    沈念sama閱讀 43,601評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,066評(píng)論 2 325
  • 正文 我和宋清朗相戀三年客税,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了况褪。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,161評(píng)論 1 334
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡更耻,死狀恐怖测垛,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情秧均,我是刑警寧澤食侮,帶...
    沈念sama閱讀 33,792評(píng)論 4 323
  • 正文 年R本政府宣布,位于F島的核電站目胡,受9級(jí)特大地震影響锯七,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜誉己,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,351評(píng)論 3 307
  • 文/蒙蒙 一眉尸、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧巫延,春花似錦效五、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,352評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至疼阔,卻和暖如春戒劫,著一層夾襖步出監(jiān)牢的瞬間半夷,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,584評(píng)論 1 261
  • 我被黑心中介騙來泰國(guó)打工迅细, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留巫橄,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 45,618評(píng)論 2 355
  • 正文 我出身青樓茵典,卻偏偏與公主長(zhǎng)得像湘换,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子统阿,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,916評(píng)論 2 344

推薦閱讀更多精彩內(nèi)容