第一個Spring程式




 


首先我們要先取得Spring的相關檔案，Spring的檔案放在SourceForge上，網址是：http://sourceforge.net/project/showfiles.php?group_id=73357



撰寫此文時，Spring最新的版本是1.1.1，有兩個下載版本，一個是spring-framework-1.1.1-with- dependencies.zip，一個是spring-framework-1.1.1.zip，with-dependencies的包括一些 ant、jakarta-commons、struts、velocity等等其它開源Java專案的相依檔案，如果您也需要這些相關檔案，可以下載這個 版本，如果您已經有這些相關檔案，則只需要下載spring-framework-1.1.1.zip這個檔案。



下載zip檔案並解壓縮之後，在dist目錄下就是使用Spring所需要的相關檔案，如果下載的是with-dependencies版本，則在lib目錄中的是您可能會用到的相依檔案。在dist目錄下，spring-core.jar是Spring的核心，對於撰寫簡單的單機程式來說，使用這個核心即可，如果日後需要使用到Spring其它的子框架支援，再將其它的jar檔案加入即可，例如spring-aop.jar、spring-webmvc.jar等等。您也可以直接使用spring.jar這個檔案，它包括了所有Spring支援的功能所需要的所有類別，而不再需要加入個別的jar檔案。



就我們 的第一個Spring程式，只要spring-core.jar這個檔案即可，它唯一相依的其它專案檔案，是commons-logging.jar，您 可以在lib目錄的jakarta-commons目錄中找到，將這兩個檔案的位置加入至CLASSPATH中，我們就可以開始撰寫第一個Spring程式。



來撰寫我們的第一個組件（component），它只是一個簡單的JavaBean，用來向新的使用者打招呼：



package onlyfun.caterpillar;




 


public class HelloBean {



    private String helloWord = "Hello!World!";



   



    public void setHelloWord(String helloWord) {



        this.helloWord = helloWord;



    }



    public String getHelloWord() {



        return helloWord;



    }



}




 


HelloBean有預設的"Hello!World!"字串，我們也可以透過setter來設定新的招呼語，不過我們不親自撰寫程式來作這些事，而是在組態檔案定義，由Spring來為我們作設定的動作，我們撰寫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="helloBean" class="onlyfun.caterpillar.HelloBean">



        <property name="helloWord"><value>Hello!Justin!</value></property>



    </bean>



</beans>




 


bean.xml中定義了JavaBean的別名與來源類別，標籤中設定了我們希望注入至JavaBean的字串值，bean.xml必須在您的CLASSPATH可以存取到的目錄中，也許是現行的工作目錄，在Web程式中可以是在classes目錄下，我們這邊使用的是單機程式的方式， 所以將之置於現行的工作目錄中（CLASSPATH都會設定 . 吧），接著我們撰寫一個簡單的測試程式：



package onlyfun.caterpillar;




 


import java.io.*;



import org.springframework.beans.factory.BeanFactory;



import org.springframework.beans.factory.xml.XmlBeanFactory;




 


public class SpringTest {



    public static void main(String[] args) throws IOException {



        InputStream is = new FileInputStream("bean.xml");



        BeanFactory factory = new XmlBeanFactory(is);



       



        HelloBean hello = (HelloBean) factory.getBean("helloBean");



        System.out.println(hello.getHelloWord());



    }



}




 


這是從比較低層次的角度來使用Spring的IoC容器功能，藉由BeanFactory來讀取組態檔案並完成依賴的關聯注入，這邊的依賴是什麼？指的是 HelloBean相依於String物件，透過setter所保留的介面，我們使用setter injection來完成這個依賴注入，而不是將招呼語寫死在HelloBean，BeanFactory是整個Spring的重點所在，整個Spring的核心都圍繞著它，在這邊使用的是XmlBeanFactory，負責讀取XML組態檔案，當然我們也可以使用properties檔案。



BeanFactory讀取Bean的組態設定並完成關係維護之後，我們可以藉由getBean()方法並指定Bean的別名來取得實例，來看看實際運行之後的效果：



2004/10/21 上午 10:28:00



org.springframework.beans.factory.xml.XmlBeanDefinitionReader loadBeanDefinitions



資訊: Loading XML bean definitions from resource for InputStream



2004/10/21 上午 10:28:00



org.springframework.beans.factory.support.AbstractBeanFactory getBean



資訊: Creating shared instance of singleton bean 'helloBean'



Hello!Justin!




 


如果今天您要想改變招呼語，則只要更改bean.xml就可以了，不用修改主要的程式，從比較一般的角度來看，就意味著如果您想要改變一些物件之間的依賴關係，則只要修改組態檔即可，而不用修改組件的任何一行程式。