{{{
#!html
Spring 學習
Spring 3.1.0
}}}
[[PageOutline]]
引用 ： [http://caterpillar.onlyfun.net/Gossip/SpringGossip/SpringGossip.html]
= 理由 =
閱讀「iT人甘苦談─穩定的工作並非人生的全部」
最後一段描述：「對於掌握程式外包的品質，具有相當程度的信心。….比如開發一個以Java為主的專案.....會要求，團隊必須遵照Spring Framework的應用程式框架開發。..只要依照標準，基本上品質不會差到哪裡去。」
= 簡介 =
Spring 的核心是個輕量級（Lightweight）容器（Container），實現了IoC（Inversion of Control）模式的容器，基於此核心容器所建立的應用程式，可以達到程式元件的鬆散耦合（Loose coupling），讓程式元件可以進行測試（Testability），這些特性都使得整個應用程式可以在架構上與維護上都能得到相當程度的簡化。
* 輕量級（Lightweight）
* 核心在檔案容量上只有不到 1MB 的大小
* 使用核心所需要的資源也是很小的
* 非侵入性（Nonintrusive）框架，它的目的之一，是讓應用程式不感受到框架的存在，減低應用程式從框架移植時的負擔。
* 容器（Container）
* 管理物件的生命週期、物件的組態、相依注入等
* 控制物件在創建時是以 原型（Prototype） 或 單例（Singleton） 的方式來建立。
* IoC = Inversion of Control，控制反轉。
* 在Java開發過程中，IoC意謂著將你設計好的類別交給系統去控制，而不是在你的類別內部自己控制。
* Spring 的核心概念是IoC，更具體而易懂的名詞是依賴注入（Dependency Injection）
* 不必自己在程式碼中維護物件的依賴關係，只需在組態檔中加以設定
除了這些特性之外，Spring 的目標是實現一個全方位的整合框架，在 Spring 框架下實現多個子框架的組合，這些子框架之間彼此可以獨立，也可以使用其它的框架方案加以替代，Spring 希望提供 one-stop shop 的框架整合方案。
* AOP 框架
* 支援AOP（Aspect-oriented programming）
* 持久層
* JDBC、O/R Mapping工具（Hibernate、iBATIS）、事務處理等。
* Web 框架
* 提供 Web 框架的解決方案
* 也可以將自己所熟悉的 Web 框架與 Spring 整合
* 如 Struts、Webwork 等
對於一些服務，例如 JNDI、Mail、排程、遠程等，Spring 不直接提供實作，而是採取抽象層方式進行包裝，讓這些服務在使用時可以有一致的使用模式且更為方便。
= IoC 模式 =
Spring 的核心概念是 IoC，IoC 的抽象概念是「依賴關係的轉移」，像是「高層模組不應該依賴低層模組，而是模組都必須依賴於抽象」是 IoC 的一種表現，「實現必須依賴抽象，而不是抽象依賴實現」也是 IoC 的一種表現，「應用程式不應依賴於容器，而是容器服務於應用程式」也是 IoC 的一種表現。
IoC 全名 Inversion of Control，如果中文硬要翻譯過來的話，就是「控制反轉」。
初看 IoC，從字面上不容易瞭解其意義，我覺得要瞭解 IoC，要先從 Dependency Inversion 開始瞭解，也就是依賴關係的反轉。
Dependency Inversion 簡單的說，在模組設計時，高層的抽象模組通常是與業務相關的模組，它應該具有重用性，而不依賴於低層的實作模組，例如如果低層模組原先是軟碟存取模式，而高層模組是個存檔備份的需求，如果高層模組直接叫用低層模組的函式，則就對低層模組產生了依賴關係。
舉個例子，例如下面這個程式：
{{{
#!java
#include
....
void save() {
....
saveToFloppy()
}
}
}}}
由於save()程式依賴於依賴於saveToFloppy()，如果今天要更換低層的存儲模組為Usb碟，則這個程式沒有辦法重用，必須加以修改才行，低層模組的更動造成了高層模組也必須跟著更動，這不是一個好的設計方式，在設計上希望模組都依賴於模組的抽象，這樣才可以重用高層的業務設計。
如果以物件導向的方式來設計，Dependency Injection 的解釋變為程式不應依賴實作，而是依賴於抽象，實作必須依賴於抽象。來看看下面這個 Java 程式：
{{{
#!java
public class BusinessObject {
private FloppyWriter writer = new FloppyWriter();
....
public void save() {
...
writer.saveToFloppy();
}
}
}}}
在這個程式中，BusinessObject 的存檔依賴於實際的 FloppyWriter，如果今天想要將存檔改為存至 Usb 碟，則必須修改或繼承 BusinessObject 進行擴展，而無法直接使用BusinessObject。
如果透過介面的宣告，可以改進此一情況，例如：
{{{
#!java
public interface IDeviceWriter {
public void saveToDevice();
}
public class BusinessObject {
private IDeviceWriter writer;
public void setDeviceWriter(IDeviceWriter writer) {
this.writer = writer;
}
public void save() {
....
writer.saveToDevice();
}
}
}}}
這樣一來，BusinessObject 就是可重用的，如果今天有存儲至 Floppy 或 Usb 碟的需求，只要實作 IDeviceWriter 即可，而不用修改 BusinessObject：
{{{
#!java
public class FloppyWriter implement IDeviceWriter {
public void saveToDevice() {
....
// 實際儲存至Floppy的程式碼
}
}
public class UsbDiskWriter implement IDeviceWriter {
public void saveToDevice() {
....
// 實際儲存至UsbDisk的程式碼
}
}
}}}
從這個角度來看，[wiki:waue/2011/DI Dependency Injection (Detail)] 的意思即是程式不依賴於實作，而是程式與實作都要依賴於抽象。
IoC 的 Control 是控制的意思，其實其背後的意義也是一種依賴關係的轉移，如果A依賴於B，其意義即是B擁有控制權，您想要轉移這種關係，所以依賴關係的反轉即是控制關係的反轉，藉由控制關係的轉移，可以獲得元件的可重用性，在上面的 Java 程式中，整個控制權從實際的 FloppyWriter 轉移至抽象的 IDeviceWriter 介面上，使得BusinessObject、FloppyWriter、UsbDiskWriter 這幾個實現依賴於抽象的 IDeviceWriter 介面。
程式的業務邏輯部份應是可以重用的，不應受到所使用框架或容器的影響，因為可能轉移整個業務邏輯至其它的框架或容器，如果業務邏輯過於依賴容器，則轉移至其它的框架或容器時，就會發生困難。
IoC 在容器的角度，可以用這麼一句好萊塢名言來代表："Don't call me, I'll call you." 以程式的術語來說的話，就是「不要向容器要求您所需要的（物件）資源，容器會自動將這些物件給您！」。IoC 要求的是容器不侵入應用程式本身，應用程式本身提供好介面，容器可以透過這些介面將所需的資源注至至程式中，應用程式不向容器主動要求資源，故而不會依賴於容器的元件，應用程式本身不會意識到正被容器使用，可以隨時從容器中脫離轉移而不用作任何的修改，而這個特性正是一些業務邏輯中間件最需要的。
=== Dependency Injection ===
[wiki:waue/2011/DI 詳見 Dependency Injection ]
= 基本程式範例 =
* HelloBean.java
{{{
#!java
package onlyfun.caterpillar;
public class HelloBean {
private String helloWord;
public void setHelloWord(String helloWord) {
this.helloWord = helloWord;
}
public String getHelloWord() {
return helloWord;
}
}
}}}
* beans-config.xml
{{{
#!java
Hello!Justin!
}}}
* SpringDemo.java
{{{
#!java
package onlyfun.caterpillar;
import org.springframework.core.io.FileSystemResource;
import org.springframework.core.io.Resource;
import org.springframework.beans.factory.BeanFactory;
import org.springframework.beans.factory.xml.XmlBeanFactory;
public class SpringDemo {
public static void main(String[] args) {
Resource rs =
new FileSystemResource("beans-config.xml");
BeanFactory factory =
new XmlBeanFactory(rs);
HelloBean hello =
(HelloBean) factory.getBean("helloBean");
System.out.println(hello.getHelloWord());
}
}
}}}
== 用 !ApplicationContext ==
用 ApplicationContext 取代 BeanFactory
BeanFactory負責讀取Bean定義檔，管理物件的載入、生成，物件之間的關係維護，負責Bean的生命週期，對於簡單的應用程式來說，使用 BeanFactory就已經足夠，但是若要利用到Spring在框架上的一些功能以及進階的容器功能，則可以使用 ApplicationContext，BeanFactory則通常用於一些資源有限的裝置，像是行動設備。
ApplicationContext的基本功能與BeanFactory很相似，它也負責讀取Bean定義檔，維護Bean之間的關係等，然而ApplicationContext提供的一個應用程式所需的更完整的框架功能：
* 提供取得資源檔案更方便的方法。
* 提供文字訊息解析的方法，並支援國際化（Internationalization, I18N）訊息。
* 可以發佈事件，對事件感興趣的Bean可以接收到這些事件。
Rod Johnson建議使用ApplicationContext來取代BeanFactory，在許多實作ApplicationContext的類別中，最常使用的大概是以下三個：
* !FileSystemXmlApplicationContext
* 可指定XML定義檔的相對路徑或絕對路徑來讀取定義檔。
* !ClassPathXmlApplicationContext
* 從Classpath中來讀取XML定義檔。
* !XmlWebApplicationContext
* 在Web應用程式中的檔案架構中讀取定義檔。
* 因此 SpringDemo.java 變成如下：
{{{
#!java
package onlyfun.caterpillar;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.FileSystemXmlApplicationContext;
public class SpringDemo {
public static void main(String[] args) {
ApplicationContext context =
new FileSystemXmlApplicationContext("beans-config.xml");
HelloBean hello =
(HelloBean) context.getBean("helloBean");
System.out.println(hello.getHelloWord());
}
}
}}}
== 程式簡化版 ==
簡化以上的寫法， bean , xml , main java 間的關係簡化如下程式碼。
並注意以下 兩個 bean 間引用的關係 （BBean , dateBean )
* BBean.java
{{{
#!java
package waue.org;
import java.util.Date;
public class BBean {
private String baa;
private Date date;
public void setBaa(String ba) {
this.baa = ba;
}
public String getBaa() {
return this.baa;
}
public void setDate(Date date) {
this.date = date;
}
public Date getDate() {
return this.date;
}
}
}}}
在以下的Bean定義檔中，先定義了一個dateBean，之後bBean可以直接參考至dateBean，Spring會幫我們完成這個依賴關係：
* A.xml
{{{
#!xml
Hello!
[直接指定參考至其它的Bean，撰寫以下的程式來測試Bean的依賴關係是否完成：
* C.java
{{{
#!java
package waue.org;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.FileSystemXmlApplicationContext;
public class C {
public static void main(String[] args) {
ApplicationContext context =
new FileSystemXmlApplicationContext("A.xml");
BBean hello =
(BBean) context.getBean("bBean");
System.out.print(hello.getBaa());
System.out.print(" It's ");
System.out.print(hello.getDate());
System.out.println(".");
}
}
}}}
* 執行結果如下：
{{{
Hello! It's Sat Oct 22 15:36:48 GMT+08:00 2005.
}}}
= xml 與 properties =
== 不用 bean.xml ==
注意！此段原文可編譯但無法執行，以下編碼已經完全修正，請注意各檔案的路徑
假設 AaBean 的內容如下：
* src/waue/one/AaBean.java
{{{
#!java
package waue.one;
public class AaBean {
private String helloWord;
public AaBean() {
}
public void setHelloWord(String helloWord) {
this.helloWord = helloWord;
}
public String getHelloWord() {
return helloWord;
}
}
}}}
=== 只用 properties ===
XML檔案的階層格式適用於於組態設定，也因此許多的開源專案都將XML作為預設的組態定義方式，但通常也會提供非XML定義檔的方式，像屬性檔案. properties
Spring也可以讓您使用屬性檔案定義Bean，例如定義一個 waue_one.properties：
注意！ waue_one.properties 放在src 目錄底下，而非根目錄（非beans-config.xml 的目錄）
注意！ aaBean.(class) 的()符號不可省略，否則運算時出錯
* src/waue_one.properties
{{{
#!java
aaBean.(class)=waue.one.AaBean
aaBean.helloWord=Properties Welcome!
}}}
* src/waue/one/SpringDemo.java
{{{
#!java
package waue.one;
import org.springframework.beans.factory.BeanFactory;
import org.springframework.beans.factory.support.BeanDefinitionRegistry;
import org.springframework.beans.factory.support.DefaultListableBeanFactory;
import org.springframework.beans.factory.support.PropertiesBeanDefinitionReader;
import org.springframework.core.io.ClassPathResource;
public class SpringDemo {
public static void main(String[] args) {
BeanDefinitionRegistry reg =
new DefaultListableBeanFactory();
PropertiesBeanDefinitionReader reader =
new PropertiesBeanDefinitionReader(reg);
reader.loadBeanDefinitions(
new ClassPathResource("waue_one.properties"));
BeanFactory factory = (BeanFactory) reg;
AaBean hello = (AaBean) factory.getBean("aaBean");
System.out.println(hello.getHelloWord());
}
}
}}}
=== main中直接綁值 ===
不用 xml , 也不用 properties 來設定值，好處是，客戶端與定義檔是隔離的，他們無法接觸定義檔的內容，直接來看個例子：
注意！以下 SpringDemo.java 引用上面的 waue.one.AaBean.java ，
* src/waue/two/SpringDemo.java
{{{
#!java
package waue.two;
import org.springframework.beans.MutablePropertyValues;
import org.springframework.beans.factory.BeanFactory;
import org.springframework.beans.factory.support.BeanDefinitionRegistry;
import org.springframework.beans.factory.support.DefaultListableBeanFactory;
import org.springframework.beans.factory.support.RootBeanDefinition;
import waue.one.AaBean;
public class SpringDemo {
public static void main(String[] args) {
// 設置屬性
MutablePropertyValues properties = new MutablePropertyValues();
properties.addPropertyValue("helloWord", "Hello! Waue!");
// 設置Bean定義
RootBeanDefinition definition = new RootBeanDefinition(AaBean.class,
properties);
// 註冊Bean定義與Bean別名
BeanDefinitionRegistry reg = new DefaultListableBeanFactory();
reg.registerBeanDefinition("fooBean", definition);
BeanFactory factory = (BeanFactory) reg;
AaBean hello = (AaBean) factory.getBean("fooBean");
System.out.println(hello.getHelloWord());
}
}
}}}
== properties / xml ==
藉由這個類別，您可以在.properties中設定一些優先屬性設定，這個設定如果與XML中的屬性定義有相衝突，則以.properties中的設定為主
注意！ 此時 properties 檔必須跟 xml 檔放在一起
注意！ xml 內的value 值無意義，因為都已 properties 為主，而 properties 也不可以因為 xml 已經設定了該property 屬性，而不給 aaBean.helloWord
* /waue_one.properties
{{{
#!java
aaBean.helloWord=Setup Properties with beans-config
}}}
* /beans-config.xml
{{{
#!xml
waue_one.properties
}}}
* src/waue/one/SpringDemo.java (同前)
{{{
#!java
package waue.one;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.FileSystemXmlApplicationContext;
public class SpringDemo {
public static void main(String[] args) throws InterruptedException {
ApplicationContext context =
new FileSystemXmlApplicationContext("beans-config.xml");
AaBean hello =
(AaBean) context.getBean("aaBean");
System.out.println(hello.getHelloWord());
}
}
}}}
* src/waue/one/AaBean.java (同前)
{{{
#!java
package waue.one;
public class AaBean {
private String helloWord;
public AaBean() {
}
public void setHelloWord(String helloWord) {
this.helloWord = helloWord;
}
public String getHelloWord() {
return helloWord;
}
}
}}}
= 進階 bean 設定 =
== bean 給值的前後設定 ==
在Bean的屬性被Spring容器設定之後，您還有機會自訂一些對Bean的修正，您可以實作org.springframework.beans.factory.config.BeanPostProcessor介面：
{{{
#!java
package org.springframework.beans.factory.config;
public interface BeanPostProcessor {
public Object postProcessBeforeInitialization(Object bean, String name) throws BeansException;
public Object postProcessAfterInitialization(Object bean, String name) throws BeansException;
}
}}}
postProcessBeforeInitialization()方法會在Bean初始化動作之前（例如InitializingBean的 afterPropertiesSet()方法或自定義的init方法）被呼叫，而postProcessAfterInitialization()方法會在Bean初始化之後立即被呼叫。
舉個例子來說，您可以實作一個大寫修正器，對於String型態的Bean屬性，無論在定義檔中是設定為大寫或小寫，在Bean屬性設定之後，您可以在大寫修正器中將所有的String改為大寫，例如：
* UpperCaseModifier.java
{{{
#!java
package onlyfun.caterpillar;
import java.lang.reflect.Field;
import org.springframework.beans.BeansException;
import org.springframework.beans.factory.config.BeanPostProcessor;
public class UpperCaseModifier implements BeanPostProcessor {
public Object postProcessBeforeInitialization(
Object bean, String name) throws BeansException {
Field[] fields = bean.getClass().getDeclaredFields();
for(int i = 0; i < fields.length; i++) {
if(fields[i].getType().equals(String.class)) {
fields[i].setAccessible(true);
try {
String original = (String) fields[i].get(bean);
fields[i].set(bean, original.toUpperCase());
} catch (IllegalArgumentException e) {
e.printStackTrace();
} catch (IllegalAccessException e) {
e.printStackTrace();
}
}
}
return bean;
}
public Object postProcessAfterInitialization(
Object bean, String name) throws BeansException {
return bean;
}
}
}}}
假設您定義了這麼一個Bean類別：
* HelloBean.java
{{{
#!java
package onlyfun.caterpillar;
public class HelloBean {
private String helloWord;
public HelloBean() {
}
public void setHelloWord(String helloWord) {
this.helloWord = helloWord;
}
public String getHelloWord() {
return helloWord;
}
}
}}}
ApplicationContext會自動偵測您是否在定義檔中定義了實作BeanPostProcessor介面的類別，例如：
* beans-config.xml
{{{
#!java
Hello!
}}}
Spring容器會在每一個Bean被初始化之前之後分別呼叫upperCaseModifier的 postProcessBeforeInitialization()方法與postProcessAfterInitialization()方法，以對Bean進行指定的相關修正，可以實際來看看以下的測試程式：
* SpringDemo.java
{{{
#!java
package onlyfun.caterpillar;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.FileSystemXmlApplicationContext;
public class SpringDemo {
public static void main(String[] args) {
ApplicationContext context =
new FileSystemXmlApplicationContext("beans-config.xml");
HelloBean hello =
(HelloBean) context.getBean("helloBean");
System.out.println(hello.getHelloWord());
}
}
}}}
執行結果如下：
{{{
HELLO!
}}}
雖然您在定義檔中的helloBean之helloWord屬性是設定小寫字母，但upperCaseModifier將之改為大寫字母了。
== 資料集合 ==
對於像 '''陣列、java.util.List、java.util.Set、java.util.Map''' 等'''集合物件'''，在注入前必須填充入一些物件至集合中，然後再將集合物件注入至所需的Bean中，
* SomeBean ：
{{{
#!java
public class SomeBean {
private String[] someStrArray;
private SomeObj[] someObjArray;
private List someList;
private Map someMap;
....
}
}}}
* B.xml ：陣列,List => ] ; Map =>