Spring學(xué)習(xí)筆記
*******************************************************
作者:陳剛,程序員,廣西省桂林人,廣西師范大學(xué)數(shù)學(xué)系97屆畢業(yè)。
blog:http://blog.csdn.net/glchengang
Email:glchengang@yeah.net
*******************************************************
1、概念理解
對Spring耳聞已久,但一直沒有時間和心情去看它,最近它的聲音是越來越大了,Java視線http://forum.javaeye.com/有不高手在談?wù)撍S谑浅弥锌臻e時間,我也花了兩個晚上看了看Spring,看的是夏昕的<Spring開發(fā)指南>http://www.xiaxin.net/Spring_Dev_Guide.rar,文章寫得不錯。以下談?wù)勎业膶W(xué)習(xí)感受
一、Spring的IoC(Inversion of Control)。
這是Spring中得有特點(diǎn)的一部份。IoC又被翻譯成“控制反轉(zhuǎn)”,也不知道是誰翻譯得這么別扭,感覺很深奧的詞。其實(shí),原理很簡單,用一句通俗的話來說:就是用XML來定義生成的對象。IoC其實(shí)是一種設(shè)計模式,Spring只是實(shí)現(xiàn)了這種設(shè)計模式。
這種設(shè)計模式是怎么來的呢?是實(shí)踐中逐漸形成的。
第一階段:用普通的無模式來寫Java程序。一般初學(xué)者都要經(jīng)過這個階段。
第二階段:頻繁的開始使用接口,這時,接口一般都會伴隨著使用工廠模式。
第三階段:使用IoC模式。工廠模式還不夠好:(1)因?yàn)榈念惖纳纱a寫死在程序里,如果你要換一個子類,就要修改工廠方法。(2)一個接口常常意味著一個生成工廠,會多出很多工廠類。
可以把IoC模式看做是工廠模式的升華,可以把IoC看作是一個大工廠,只不過這個大工廠里要生成的對象都是在XML文件中給出定義的,然后利用Java的“反射”編程,根據(jù)XML中給出的類名生成相應(yīng)的對象。從實(shí)現(xiàn)來看,IoC是把以前在工廠方法里寫死的對象生成代碼,改變?yōu)橛蒟ML文件來定義,也就是把工廠和對象生成這兩者獨(dú)立分隔開來,目的就是提高靈活性和可維護(hù)性。
IoC中最基本的Java技術(shù)就是“反射”編程。反射又是一個生澀的名詞,通俗的說反射就是根據(jù)給出的類名(字符串)來生成對象。這種編程方式可以讓對象在生成時才決定要生成哪一種對象。我在最近的一個項目也用到了反射,當(dāng)時是給出一個.properties文本文件,里面寫了一些全類名(包名+類名),然后,要根據(jù)這些全類名在程序中生成它們的對象。反射的應(yīng)用是很廣泛的,象Hibernate、String中都是用“反射”做為最基本的技術(shù)手段。
在過去,反射編程方式相對于正常的對象生成方式要慢10幾倍,這也許也是當(dāng)時為什么反射技術(shù)沒有普通應(yīng)用開來的原因。但經(jīng)SUN改良優(yōu)化后,反射方式生成對象和通常對象生成方式,速度已經(jīng)相差不大了(但依然有一倍以上的差距)。
所以要理解IoC,你必須先了解工廠模式和反射編程,否則對它產(chǎn)生的前因后果和實(shí)現(xiàn)原理都是無法理解透徹的。只要你理解了這一點(diǎn),你自己也完全可以自己在程序中實(shí)現(xiàn)一個IoC框架,只不是這還要涉及到XML解析等其他知識,稍微麻煩一些。
IoC最大的好處是什么?因?yàn)榘褜ο笊煞旁诹薠ML里定義,所以當(dāng)我們需要換一個實(shí)現(xiàn)子類將會變成很簡單(一般這樣的對象都是現(xiàn)實(shí)于某種接口的),只要修改XML就可以了,這樣我們甚至可以實(shí)現(xiàn)對象的熱插撥(有點(diǎn)象USB接口和SCIS硬盤了)。
IoC最大的缺點(diǎn)是什么?(1)生成一個對象的步驟變復(fù)雜了(其實(shí)上操作上還是挺簡單的),對于不習(xí)慣這種方式的人,會覺得有些別扭和不直觀。(2)對象生成因?yàn)槭鞘褂梅瓷渚幊蹋谛噬嫌行p耗。但相對于IoC提高的維護(hù)性和靈活性來說,這點(diǎn)損耗是微不足道的,除非某對象的生成對效率要求特別高。(3)缺少IDE重構(gòu)操作的支持,如果在Eclipse要對類改名,那么你還需要去XML文件里手工去改了,這似乎是所有XML方式的缺憾所在。
總的來說IoC無論原理和實(shí)現(xiàn)都還算是很簡單的。一些人曾認(rèn)為IoC沒什么實(shí)際作用,這種說法是可以理解的,因?yàn)槿绻阍诰幊讨泻苌偈褂媒涌冢蚝苌偈褂霉S模式,那么你根本就沒有使用IoC的強(qiáng)烈需要,也不會體會到IoC可貴之處。有些人也說要消除工廠模式、單例模式,但是都語焉不詳、人云亦云。但如果你看到IoC模式和用上Spring,那么工廠模式和單例模式的確基本上可以不用了。但它消失了嗎?沒有!Spring的IoC實(shí)現(xiàn)本身就是一個大工廠,其中也包含了單例對象生成方式,只要用一個設(shè)置就可以讓對象生成由普通方式變單一實(shí)例方式,非常之簡單。
總結(jié):
(1)IoC原理很簡單,作用的針對性也很強(qiáng),不要把它看得很玄乎。
(2)要理解IoC,首先要了解“工廠、接口、反射”這些概念。
二、Spring的MVC
如果你已經(jīng)熟悉Struts,那么不必把MVC做為重點(diǎn)學(xué)習(xí)內(nèi)容。基本上我認(rèn)為Spring MVC是一個雞肋,它的技術(shù)上很先進(jìn),但易用性上沒有Struts好。而且Struts有這么多年的基礎(chǔ)了,Spring很難取代Struts的地位。這就是先入為主的優(yōu)秀,一個項目經(jīng)理選用一種框架,不能單純的從它的技術(shù)上考慮,還有開發(fā)效率,人員配置等都是考慮因素。但做為研究性的學(xué)習(xí),Spring的MVC部份還是蠻有價值的。
三、數(shù)據(jù)庫層的模板
Spring主要是提供了一些數(shù)據(jù)庫模板(模板也是一種Java設(shè)計模式),讓數(shù)據(jù)部分的代碼更簡潔,那些try...catch都可以不見了。這個的確是個好東東。
四、AOP
AOP又稱面向方面編程,它的實(shí)現(xiàn)原理還是用了反射:通過對某一個種類的方法名做監(jiān)控來實(shí)現(xiàn)統(tǒng)一處理。比如:監(jiān)控以“insert”字符串開頭的方法名,在這種方法執(zhí)行的前后進(jìn)行某種處理(數(shù)據(jù)庫事務(wù)等)。但這里我有一個疑問?不一定所有以insert開頭的方法都是數(shù)據(jù)庫操作,哪么當(dāng)某個insert開頭的方法不是數(shù)據(jù)庫操作,你又對它進(jìn)行了數(shù)據(jù)事務(wù)的操作,這樣的錯誤如何防止???我對這方面了解不深,還是只知道一個大概。
曾看過一個程序員發(fā)出這樣的感慨:“框架一個接一個,學(xué)也學(xué)不完,而且有必要嗎?這樣一層層的加上框架,還不如直接寫JSP來得直接,效率還高”。我想這種困惑很多人都有吧?但如果你經(jīng)過的項目漸多,就會發(fā)現(xiàn),維護(hù)項目要比開發(fā)項目更艱難,代價更大。那種用JSP直接來寫,層次又不清楚的開發(fā),往往最后得到一個不可再修改的軟件,一團(tuán)亂麻,移一發(fā)而動全身。但軟件不象電視機(jī),做好了就不會改動了,軟件是一個變化的事物,用戶的需求隨時會改變,這時你會體會到分層和使用框架的好處了,它們?yōu)槟阕隽塑浖泻芏嗪蜆I(yè)務(wù)無關(guān)的工作,你可以只關(guān)注業(yè)務(wù),并減少代碼量。唯一缺點(diǎn)就是有一個學(xué)習(xí)的代價,框架配置上也較麻煩。
學(xué)習(xí)框架,我認(rèn)為應(yīng)該:第一步,了解這個框架中的一些關(guān)鍵概念,它的具體含義是什么。第二步,了解這個框架的精華在哪里,它能對開發(fā)起到什么樣的作用,最好能對它的原理有一定的了解。第三步,用這個框架來寫幾個例子,實(shí)際體會一下。我現(xiàn)在還是剛剛大概完成了前兩步,這幾天會再看看Spring的文檔并用Spring寫幾個例子,到時一起發(fā)出來。
另外,很贊賞<Spring開發(fā)指南>的作者夏昕的觀點(diǎn),將自已的經(jīng)驗(yàn)寫成文檔公開出來,不過一個人的力量終究太弱。最好能夠形成一個組織,對一種新技術(shù),由一兩個人出一個大綱,大家把它分了,更寫一章,然后由兩三個人總集起。我個人感覺,由于英文語言的關(guān)系,新技術(shù)引進(jìn)到國內(nèi)的還是太慢了,至少要比國外慢上一年以上,成立一個開源文檔組織還是很有意義的事。
第一章 Spring的下載和安裝
下載主頁http://www.springframework.org/download.html ,或者直接使用鏈接地址:http://voxel.dl.sourceforge.net/sourceforge/springframework/spring-framework-1.1.4-with-dependencies.zip
Spring的下載包有兩種:spring-framework-1.1.4-with-dependencies.zip和spring-framework-1.1.4.zip,上面的第二個鏈接就是下載前者,建議你也下載前者,因?yàn)榍罢弑群笳叨嗔艘恍?/SPAN>Spring要用到的第三方包,如hibernate、j2ee、dom4j、aopalliance、jakarta-commons等。下載包名稱的dependencies就是“依賴”的意思。
1、解壓后的目錄結(jié)構(gòu)如下:
目錄說明:
l dist Spring自已的核心庫
l docs 有一些文檔。
l lib 是一些用到的第三方庫。
l mock 仿制品?????????????我也不知道
l samples 一些項目例子
l src Spring的源代碼
l test 測試用例
2、新建一個Eclipse項目
(1)項目名myspring
(2)直接單擊“下一步”,再單擊“完成”
(3)在項目下創(chuàng)建一個lib目錄
(4)將Spring的解壓縮目錄dist和lib都復(fù)制到這個lib目錄中,然后前者改名成spring,后者先暫時不動吧,以后用到時才管它。
3、將spring庫加入到庫引用
將spring庫加入到庫引用中,有如下兩種方法。
方法一:單擊“添加JAR”把spring的核心包加入。
方法二:上面的“方法一”簡單易行,但如果一個項目要引入的包種類很多,那么就顯示得較亂。還有一種操作麻煩,但較清晰一些的方法。這種方法是使用Eclipse中的“用戶庫”的方式,如下圖所示:
最后的結(jié)果如下圖所示,然后單擊“確定”
返回上一界面后,再單擊“完成”,得到如下圖所示的效果
最后,項目里的spring包的引用都在一個目錄下,顯示層次感強(qiáng)很多。
以后如果要引入myspring/lib/lib目錄下的第三方包,也按方法二較好:將第三方包的目錄復(fù)制到myspring/lib下,再參照方法二,將其加入庫引用中即可
4、設(shè)置日志包的庫引用
jakarta-commons和log4j包主要是做為Spring的運(yùn)行時輸出log(日志)用,如果不設(shè)置日志包,那么日志就沒法輸出到控制臺,不利于開發(fā)和調(diào)試。設(shè)置方式如下:
(1)就照上面的方法,放myspring/lib/lib目錄下的log4j目錄和jakarta-commons目錄往上移一層到myspring/lib目錄下。最后設(shè)置的結(jié)果如下圖所示,這里我們把log4j移到了others目錄,因?yàn)?/SPAN>log4j就一個JAR包,專門為它象jakarta-commons創(chuàng)建一個目錄和用戶庫太不值了,以后可能還會有這種引用單個包的時候,到時都放到others目錄里好了。
(2)日志的庫引用完成之后,還要創(chuàng)建一個日志的配置文件:log4j.properties,其文件內(nèi)容如下:
log4j.rootLogger=DEBUG, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%c{1} - %m%n
log4j.properties文件的創(chuàng)建位置在src目錄下,如下圖所示:
如果沒有設(shè)置日志設(shè)置或設(shè)置不對,在使用控制臺時會出現(xiàn)下面所示的紅字。
java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory
第二章 Spring中IoC的入門實(shí)例
Spring的模塊化是很強(qiáng)的,各個功能模塊都是獨(dú)立的,我們可以選擇的使用。這一章先從Spring的IoC開始。所謂IoC就是一個用XML來定義生成對象的模式,我們看看如果來使用的。
1、數(shù)據(jù)模型。
1、如下圖所示有三個類,Human(人類)是接口,Chinese(中國人)是一個子類,American(美國人)是另外一個子類。
源代碼如下:
package cn.com.chengang.spring;
public interface Human {
void eat();
void walk();
}
package cn.com.chengang.spring;
public class Chinese implements Human {
/* (非 Javadoc)
* @see cn.com.chengang.spring.Human#eat()
*/
public void eat() {
System.out.println("中國人對吃很有一套");
}
/* (非 Javadoc)
* @see cn.com.chengang.spring.Human#walk()
*/
public void walk() {
System.out.println("中國人行如飛");
}
}
package cn.com.chengang.spring;
public class American implements Human {
/* (非 Javadoc)
* @see cn.com.chengang.spring.Human#eat()
*/
public void eat() {
System.out.println("美國人主要以面包為主");
}
/* (非 Javadoc)
* @see cn.com.chengang.spring.Human#walk()
*/
public void walk() {
System.out.println("美國人以車代步,有四肢退化的趨勢");
}
}
2、對以上對象采用工廠模式的用法如下
創(chuàng)建一個工廠類Factory,如下。這個工廠類里定義了兩個字符串常量,所標(biāo)識不同的人種。getHuman方法根據(jù)傳入?yún)?shù)的字串,來判斷要生成什么樣的人種。
package cn.com.chengang.spring;
public class Factory {
public final static String CHINESE = "Chinese";
public final static String AMERICAN = "American";
public Human getHuman(String ethnic) {
if (ethnic.equals(CHINESE))
return new Chinese();
else if (ethnic.equals(AMERICAN))
return new American();
else
throw new IllegalArgumentException("參數(shù)(人種)錯誤");
}
}
下面是一個測試的程序,使用工廠方法來得到了不同的“人種對象”,并執(zhí)行相應(yīng)的方法。
package cn.com.chengang.spring;
public class ClientTest {
public static void main(String[] args) {
Human human = null;
human = new Factory().getHuman(Factory.CHINESE);
human.eat();
human.walk();
human = new Factory().getHuman(Factory.AMERICAN);
human.eat();
human.walk();
}
}
控制臺的打印結(jié)果如下:
3、采用Spring的IoC的用法如下:
1、在項目根目錄下創(chuàng)建一個bean.xml文件
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
<bean id="Chinese" class="cn.com.chengang.spring.Chinese"/>
<bean id="American" class="cn.com.chengang.spring.American"/>
</beans>
bean.xml的位置如下圖,注意不要看花眼把它看成是lib目錄下的了,它是在myspring目錄下的。
2、修改ClientTest程序如下:
package cn.com.chengang.spring;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.FileSystemXmlApplicationContext;
public class ClientTest {
public final static String CHINESE = "Chinese";
public final static String AMERICAN = "American";
public static void main(String[] args) {
// Human human = null;
// human = new Factory().getHuman(Factory.CHINESE);
// human.eat();
// human.walk();
// human = new Factory().getHuman(Factory.AMERICAN);
// human.eat();
// human.walk();
ApplicationContext ctx = new FileSystemXmlApplicationContext("bean.xml");
Human human = null;
human = (Human) ctx.getBean(CHINESE);
human.eat();
human.walk();
human = (Human) ctx.getBean(AMERICAN);
human.eat();
human.walk();
}
}
從這個程序可以看到,ctx就相當(dāng)于原來的Factory工廠,原來的Factory就可以刪除掉了。然后又把Factory里的兩個常量移到了ClientTest類里,整個程序結(jié)構(gòu)基本一樣。
再回頭看原來的bean.xml文件的這一句
<bean id="Chinese" class="cn.com.chengang.spring.Chinese"/>
id就是ctx.getBean的參數(shù)值,一個字符串。class就是一個類(包名+類名)。然后在ClientTest類里獲得Chinese對象就是這么一句
human = (Human) ctx.getBean(CHINESE);
因?yàn)?/SPAN>getBean方法返回的是Object類型,所以前面要加一個類型轉(zhuǎn)換。
4、總結(jié)
(1)也許有人說,IoC和工廠模式不是一樣的作用嗎,用IoC好象還麻煩一點(diǎn)。
舉個例子,如果用戶需求發(fā)生變化,要把Chinese類修改一下。那么前一種工廠模式,就要更改Factory類的方法,并且重新編譯布署。而IoC只需要將class屬性改變一下,并且由于IoC利用了Java反射機(jī)制,這些對象是動態(tài)生成的,這時我們就可以熱插撥Chinese對象(不必把原程序停止下來重新編譯布署)
(2)也許有人說,即然IoC這么好,那么我把系統(tǒng)所有對象都用IoC方式來生成。
注意,IoC的靈活性是有代價的:設(shè)置步驟麻煩、生成對象的方式不直觀、反射比正常生成對象在效率上慢一點(diǎn)。因此使用IoC要看有沒有必要,我認(rèn)為比較通用的判斷方式是:用到工廠模式的地方都可以考慮用IoC模式。
(3)在上面的IoC的方式里,還有一些可以變化的地方。比如,bean.xml不一定要放在項目錄下,也可以放在其他地方,比如cn.com.chengang.spring包里。不過在使用時也要變化一下,如下所示:
new FileSystemXmlApplicationContext("src/cn/com/chengang/spring/bean.xml");
另外,bean.xml也可以改成其他名字。這樣我們在系統(tǒng)中就可以分門別類的設(shè)置不同的bean.xml。
(4)關(guān)于IoC的低侵入性。
什么是低侵入性?如果你用過Struts或EJB就會發(fā)現(xiàn),要繼承一些接口或類,才能利用它們的框架開發(fā)。這樣,系統(tǒng)就被綁定在Struts、EJB上了,對系統(tǒng)的可移植性產(chǎn)生不利的影響。如果代碼中很少涉及某一個框架的代碼,那么這個框架就可以稱做是一個低侵入性的框架。
Spring的侵入性很低,Humen.java、Chinese.java等幾個類都不必繼承什么接口或類。但在ClientTest里還是有一些Spring的影子:FileSystemXmlApplicationContext類和ctx.getBean方式等。
現(xiàn)在,低侵入性似乎也成了判定一個框架的實(shí)現(xiàn)技術(shù)好壞的標(biāo)準(zhǔn)之一。
(5)關(guān)于bean.xml的用法
bean.xml的用法還有很多,其中內(nèi)容是相當(dāng)豐富的。假設(shè)Chinese類里有一個humenName屬性(姓名),那么原的bean.xml修改如下。此后生成Chinese對象時,“陳剛”這個值將自動設(shè)置到Chinese類的humenName屬性中。而且由于singleton為true這時生成Chinese對象將采用單例模式,系統(tǒng)僅存在一個Chinese對象實(shí)例。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
<bean id="Chinese" class="cn.com.chengang.spring.Chinese" singleton="true">
<property name="humenName">
<value>陳剛</value>
</property>
</bean>
<bean id="American" class="cn.com.chengang.spring.American"/>
</beans>
關(guān)于bean.xml的其它用法,不再詳細(xì)介紹了,大家自己拿Spring的文檔一看就明白了。
第三章 IoC中的國際化(CVS版本:V002)
從這一章開始,我將把實(shí)例的項目打開一個CVS版本,不知誰能提供一個FTP空間?
3.1 前言
標(biāo)題準(zhǔn)確來說應(yīng)該是“使用Spring中的IoC功能來實(shí)現(xiàn)我們所開發(fā)項目系統(tǒng)的國際化”,國際化不是針對IoC的,而是針對你開發(fā)的整個系統(tǒng)。
如果你使用過Eclipse的國際化,或者用過Eclipse的“外部化字符串”向?qū)В?/SPAN>Eclipse主菜單:源代碼->外部化字符串),那么對Spring提供的國際化功能應(yīng)該是非常容易理解,兩者基本一樣,或者說各種Java程序的國際化方式都基本一樣。
先談?wù)?/SPAN>Eclipse國際化的兩個組成部分:*.properties的資源文件、獲取資源文件內(nèi)容的Message類。
而Spring則和Eclipse的處理類似:資源文件兩者是一樣的,不同語言的翻譯放在不同的資源文件里,連起名規(guī)則都一樣;Eclipse的Message類要自己寫(代碼通用,復(fù)制以前項目的即可,或用Eclipse的向?qū)梢粋€也行),Spring則已經(jīng)有寫好的Message類,我們在IoC的xml文件里注冊一下即可使用(也可以實(shí)現(xiàn)Spring的MessageSource接口,自己來寫一個Message類,代碼并不復(fù)雜,不過這沒什么必要,用Spring提供的就行了)。
無論是Eclipse的Message類,還是Spring的自帶的Message類,或是我們自己寫一個Message類,都是使用JDK的java.util.ResourceBundle類來實(shí)現(xiàn)*.properties文件的讀取。
下面用實(shí)例來體會一下,先給出本章完成之后的項目結(jié)構(gòu)的截圖:
3.2 簡單實(shí)例
假設(shè)我們有如下程序,程序的作用是打印出一個字符串
package cn.com.chengang.spring;
public class MessageTest {
public static void main(String[] args) {
String str = "ChenGang";
System.out.println(str);
}
}
現(xiàn)在,我們要讓這個程序能夠根據(jù)使用者的語言情況輸出不同的字符,比如:對英文使用者輸出“ChenGang”,對中文使用者輸出“陳剛”,對臺灣使用輸出“陳剛”等等。這個需求的實(shí)現(xiàn)方法如下:
1、創(chuàng)建一系列的資源文件
在cn.com.chengang.spring包下創(chuàng)建以下文件:
(1)messages.properties(默認(rèn):英文),內(nèi)容僅一句,如下
chengang=Giles
“chengang”是鍵值,Giles是要輸出的英文字符串
(2)messages_zh_CN.properties(簡體中文)
chengang=\u9648\u521A
“\u9648\u521A”是UNICODE碼,對應(yīng)的中文是“陳剛”
(3)messages_ zh_TW.properties(繁體中文)
chengang=\u9673\u525B
“\u9673\u525B”對應(yīng)的中文是“陳剛”
附注:由于中文是要轉(zhuǎn)換成UNICODE碼,在編輯和閱讀上有諸多不便,如果是用Eclipse做IDE,則有一個編輯資源文件的插件jinto,下載網(wǎng)址是http://www.guh-software.de/,用它打開的資源文件如下圖所示,可以看到三個資源在一個界面反映了出來。
如果你不用Eclipse,而是用Editplugs+JDK的方式來編程(現(xiàn)在還有這樣的原始人嗎?),你也可以用JDK自帶的native2ascii.exe程序來將中文字串轉(zhuǎn)成UNICODE碼。Ant中還提供了一個相應(yīng)的任務(wù):<native2ascii encoding="GBK" src="${src}" dest="${build}"/>,其中GBK是一個中國的字符集。
2、修改bean.xml
將Spring自帶的org.springframework.context.support.ResourceBundleMessageSource類注冊到bean.xml中,這個類的作用是獲取資源文件的內(nèi)容,注冊到IoC的bean.xml文件中是為了自動獲得此類的對象(Spring做了一些簡化編程的處理)。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
<bean id="Chinese" class="cn.com.chengang.spring.Chinese"/>
<bean id="American" class="cn.com.chengang.spring.American"/>
<bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource">
<property name="basenames">
<list>
<value>cn.com.chengang.spring.messages</value>
</list>
</property>
</bean>
</beans>
代碼說明:
l id="messageSource" 的設(shè)置是不變的、必須的。
l ResourceBundleMessageSource是Spring的一個Message類。這里還有一個選擇,用ReloadableResourceBundleMessageSource類,此類可以提供不用重啟即可重新加載資源文件的特性(前者對資源文件只加載一次)。對于那種有熱修改資源文件的需求,后者比較合適,只是后者在效率上有可能有損耗,因?yàn)橹辽僖嘁恍z查資源文件是否改變的代碼(這只是我的猜測,我沒有仔佃去讀這段的源碼)。
l “basenames”是不變的、必須的。它是ResourceBundleMessageSource的一個屬性,在源代碼中的定義是“private String[] basenames;”,可見它是一個字符串?dāng)?shù)組。
l “cn.com.chengang.spring.messages”是把資源文件的位置傳入到basenames屬性中。注意:三個資源文件只需要將共同的主名(紅色字體)傳入:messages.properties、messages_zh_CN.properties、messages_zh_TW.properties。
3、使用。修改MessageTest類,如下
package cn.com.chengang.spring;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.FileSystemXmlApplicationContext;
public class MessageTest {
public static void main(String[] args) {
ApplicationContext ctx = new FileSystemXmlApplicationContext("bean.xml");
String str = ctx.getMessage("chengang", null, null);
System.out.println(str);
}
}
代碼說明:
(1)main方法里
l 第一句取得bean.xml文件的配置信息。
l 第二句從資源文件里得到鍵值chengang對應(yīng)的字符串。
l 第三句將字符串打印出來,結(jié)果是打印的是“陳剛”,說明讀取的是messages_zh_CN.properties資源文件。
(2)ctx.getMessage("chengang", null, null);有三個參數(shù):
l 第一個是資源文件的鍵值;
l 第二個是資源文件字符串的參數(shù),由于本字符串沒有參數(shù),所以用一個null(后面給出了一個用到字符串參數(shù)的實(shí)例);
l 第三個是一個java.util. Locale類型的參數(shù)。參數(shù)為null,則表示根據(jù)使用者的語言環(huán)境來選擇Locale,因?yàn)槲矣玫氖侵形陌娴?/SPAN>windows,所以在取字符串時它自動選擇了messages_zh_CN.properties資源文件。
這其中還有一個控制點(diǎn)在JVM,JVM會根據(jù)當(dāng)前操作系統(tǒng)的語言環(huán)境進(jìn)行相應(yīng)處理,我們可以通過在JVM啟動參數(shù)中追加“-Duser.language=zh_TW”來設(shè)定當(dāng)前JVM語言類型,通過JVM級的設(shè)定,也可以實(shí)現(xiàn)自動切換所使用的資源文件類型。
所以這里面的控制語言的方式有三種:從最低層的操作系統(tǒng)的Locale設(shè)定,到更上一層的JVM的Locale設(shè)定,再到程序一級的Locale設(shè)定。
3.3 資源文件的其他使用方式:
package cn.com.chengang.spring;
import java.util.Locale;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.FileSystemXmlApplicationContext;
import org.springframework.context.support.ResourceBundleMessageSource;
public class MessageTest {
public static void main(String[] args) {
ApplicationContext ctx = new FileSystemXmlApplicationContext("bean.xml");
String str = ctx.getMessage("chengang", null, null);
System.out.println(str); //輸出“陳剛”
/*
* 使用了messages.properties
*/
str = ctx.getMessage("chengang", null, new Locale(""));
System.out.println(str);//輸出“Giles”
/*
* 使用了messages_zh_CN.properties
*/
str = ctx.getMessage("chengang", null, new Locale("zh", "CN"));
System.out.println(str);//輸出“陳剛”
/*
* 使用了messages_zh_TW.properties
*/
str = ctx.getMessage("chengang", null, new Locale("zh", "TW"));
System.out.println(str);//輸出“陳剛”
/*
* 使用了messages_zh_TW.properties,從這里可見資源文件的起名可以很隨意,
* 比如我們建立一個messages_123.properties,在傳參數(shù)時候就可以這樣:
* new Locale("123"),一樣也可以取出messages_123.properties中的值
*/
str = ctx.getMessage("chengang", null, new Locale("zh_TW"));
System.out.println(str);//輸出“陳剛”
/*
* 當(dāng)找不到相應(yīng)的資源文件時,使用了messages_zh_CN.properties
*/
str = ctx.getMessage("chengang", null, new Locale("abcd"));
System.out.println(str);//輸出“陳剛”
/**
* 不通過IoC注冊,直接使用ResourceBundleMessageSource類的寫法。
*/
ResourceBundleMessageSource s = new ResourceBundleMessageSource();
s.setBasename("cn.com.chengang.spring.messages");
str = s.getMessage("chengang", null, null);
System.out.println(str);//輸出“陳剛”
}
}
代碼說明:
前面說過控制語言的方式有三種:從最低層的操作系統(tǒng)的Locale設(shè)定,到更上一層的JVM的Locale設(shè)定,再到程序一級的Locale設(shè)定。我認(rèn)為最佳的方法是在程序一級進(jìn)行控制:定義一個統(tǒng)一的Locale靜態(tài)變量,然后整個系統(tǒng)中只使用這一個變量,以后就可以通過界面操作設(shè)置此Locale變量的值,讓用戶來選擇他所需的軟件語言。而且我們也可以將此靜態(tài)變量設(shè)成null值,來自動選擇資源文件。
另外,Locale里也定義了一些常量,我們可以直接使用而不必去new一個Locale對象,如:“Locale.ENGLISH”。
3.4 再一個實(shí)例
這個實(shí)例演示了如何使用多個資源文件,以及如何使用字符串參數(shù)
(1)在cn.com.chengang.spring包下再創(chuàng)建一個資源文件messagesOther_zh_CN.properties
chengang.info=\u9648\u521A\uFF0C\u7F51\u540D\uFF1A{0}\uFF0C\u82F1\u6587\u540D\uFF1A{1}\uFF0CBlog\uFF1A{2}
其中UNICODE字符串對應(yīng)的中文是:“陳剛,網(wǎng)名:{0},英文名:{1},Blog:{2}”,這個字符串一共有三個參數(shù)。
(2)修改 bean.xml文件
因?yàn)?/SPAN>basenames屬性是一個數(shù)組,當(dāng)然也就可以接收多個資源文件設(shè)定。具體修改如下面的紅字部份
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
<bean id="Chinese" class="cn.com.chengang.spring.Chinese"/>
<bean id="American" class="cn.com.chengang.spring.American"/>
<bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource">
<property name="basenames">
<list>
<value>cn.com.chengang.spring.messages</value>
<value>cn.com.chengang.spring.messagesOther</value>
</list>
</property>
</bean>
</beans>
(3)修改MessageTest類,加入幾行使用的代碼
String[] strArgs = new String[3];
strArgs[0]="混北民工";
strArgs[1]="Giles";
strArgs[2]="http://blog.csdn.net/glchengang";
str = ctx.getMessage("chengang.info", strArgs, null);
System.out.println(str);
打印出來的結(jié)果就是:“陳剛,網(wǎng)名:混北民工,英文名:Giles,Blog:http://blog.csdn.net/glchengang”
3.5 國際化的實(shí)踐建議
l 建議一個包對應(yīng)一個資源文件。不要整個系統(tǒng)都使用一個資源文件來翻譯,這樣單個文檔的體積就太大了,不利于維護(hù);當(dāng)然,也不必一個類對應(yīng)一個資源文件,這樣資源文件又太多了。
l 建議資源文件和其翻譯類/包在同一目錄下。不過,如果是要將軟件打成一外JAR包或WAR包,建議把資源文件分離出來,這樣可以修改資源文件,而不必再次打包。
l 建議字符串項的鍵值上加上其所在的類名。比如:上面的chengang和chengang.info最好是取名成MessageTest.chengang和MessageTest.chengang.info。這樣查找使用此鍵值的類會方便很多。
參考文獻(xiàn)
l 夏昕的<<Spring開發(fā)指南>> http://www.xiaxin.net/Spring_Dev_Guide.rar
posted on 2005-03-05 14:20 辰 閱讀(2087) 評論(2) 編輯 收藏 所屬分類: J2ee