第一個Spring程式 作者：林信良

第一個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就可以了，不用修改主要的程式，從比較一般的角度來看，就意味著如果您想要改變一些物件之間的依賴關係，則只要修改組態檔即可，而不用修改組件的任何一行程式。