一起來讀官方檔案-----SpringIOC（02）

1.3，Bean總覽

Spring IoC容器管理一個或多個bean，這些bean是使用您提供給容器的配置元資料創建的（例如，以XML 定義的形式 ），

在容器本身內，這些bean定義表示為BeanDefinition物件，其中包含（除其他資訊外）以下元資料：

包限定的類名：通常，定義了Bean的實際實作類，
Bean行為配置元素，用于宣告Bean在容器中的行為（作用域，生命周期回呼等），
參考其他bean進行其作業所需的bean，這些參考也稱為協作者或依賴項，
要在新創建的物件中設定的其他配置設定-例如，池的大小限制或在管理連接池的Bean中使用的連接數，

該元資料轉換為構成每個bean定義的一組屬性，下表描述了這些屬性：

除了包含有關如何創建特定bean的資訊的bean定義外，這些ApplicationContext實作還允許注冊在容器外部（由用戶）創建的現有物件，這是通過方法訪問ApplicationContext的BeanFactory的getBeanFactory()來完成，該方法回傳BeanFactory的DefaultListableBeanFactory實作，DefaultListableBeanFactory 通過registerSingleton(..)和 registerBeanDefinition(..)方法支持此注冊，但是，典型的應用程式僅使用通過常規bean定義元資料定義的bean，

自定義類  不帶任何注解
    public class LearnBean {
    	public LearnBean(String name) {
    	}
    	public String getString(){
    		return "learnSpring";
    	}
    }
    
第一種：AnnotationConfigApplicationContext自帶的registerBean方法，可以傳入class和構造引數

	AnnotationConfigApplicationContext annotationConfigApplicationContext = 
	                            new AnnotationConfigApplicationContext();
	annotationConfigApplicationContext.registerBean(LearnBean.class,"");
	annotationConfigApplicationContext.refresh();
	LearnBean bean = (LearnBean) annotationConfigApplicationContext.getBean("learnBean");
	System.out.println(bean.getString());
	
第二種：還可以傳入 class和beanDefinition也就是配置元資料 這個和 getBeanFactory().registerBeanDefinition(..)是一個意思

    AnnotationConfigApplicationContext annotationConfigApplicationContext = 
                                new AnnotationConfigApplicationContext();
	
	RootBeanDefinition rootBeanDefinition = new RootBeanDefinition(LearnBean.class);
	ConstructorArgumentValues constructorArgumentValues = new ConstructorArgumentValues();
	constructorArgumentValues.addIndexedArgumentValue(0,"111");
	rootBeanDefinition.setConstructorArgumentValues(constructorArgumentValues);
	annotationConfigApplicationContext.registerBeanDefinition("learnBean",rootBeanDefinition);

	annotationConfigApplicationContext.refresh();

	LearnBean bean = (LearnBean) annotationConfigApplicationContext.getBean("learnBean");
	System.out.println(bean.getString());
	
	
注意：如果不寫
	annotationConfigApplicationContext.refresh();
就會報錯
Exception in thread "main" java.lang.IllegalStateException: org.springframework.context.annotation.AnnotationConfigApplicationContext@68de145 has not been refreshed yet
	at org.springframework.context.support.AbstractApplicationContext.assertBeanFactoryActive(AbstractApplicationContext.java:1096)
	at org.springframework.context.support.AbstractApplicationContext.getBean(AbstractApplicationContext.java:1108)
	at org.springframework.example.DebuggerSpringMain.main(DebuggerSpringMain.java:40)
	
	

Bean元資料和手動提供的單例實體需要盡早注冊，以便容器在自動裝配和其他自省步驟中正確地推理它們，雖然在某種程度上支持覆寫現有元資料和現有單例實體，但是在運行時（與對工廠的實時訪問同時）對新bean的注冊不被正式支持，并且可能導致并發訪問例外，bean容器中的狀態不一致或都，

很顯然注冊太晚，就無法和Spring基礎的步驟融合，一些依賴注入無法完成

1.3.1，bean的命名

每個bean具有一個或多個識別符號，這些識別符號在承載Bean的容器內必須唯一，
一個bean通常只有一個識別符號，但是，如果需要多個，則可以將多余的別名視為別名，

在基于XML組態檔，您可以使用id屬性，name屬性，或兩者來指定bean識別符號，id屬性使您可以精確指定一個ID，
按照慣例，這些名稱是字母數字（“myBean”，“someService”等），但它們也可以包含特殊字符，如果要為bean引入其他別名，還可以在name屬性中指定它們，并用逗號（,），分號（;）或空格分隔，
作為歷史記錄，在Spring3.1之前的版本中，該id屬性被定義為一種xsd:ID型別，該型別限制了可能的字符，從3.1開始，它被定義為xsd:string型別，
請注意，Bean id唯一性仍由容器強制執行，盡管不再由XML決議器執行，

您不需要為bean 提供name或id，如果不提供 name或id顯式提供，則容器將為該bean生成一個唯一的名稱，
但是，如果您希望通過使用ref元素或服務定位器樣式查找通過名稱參考那個bean，那么您必須提供一個名稱，使用內部bean 和 自動裝配合的時候 通常不需要使用名稱，

###### Bean命名約定
約定是在命名bean時將標準Java約定用于實體欄位名稱，
也就是說，bean名稱以小寫字母開頭，并從那里用駝峰式大小寫，
這樣的名字的例子包括accountManager， accountService，userDao，loginController，等等，

一致地命名Bean使您的配置更易于閱讀和理解，
另外，如果您使用Spring AOP，則在將切點應用于名稱相關的一組bean時，它會很有幫助，

通過在類路徑中進行組件掃描，Spring會按照前面描述的規則為未命名的組件生成Bean名稱：本質上，采用簡單的類名稱并將其初始字符轉換為小寫，
但是，在（不尋常的）特殊情況下，如果有多個字符并且第一個和第二個字符均為大寫字母，則會保留原始大小寫，
這些規則與java.beans.Introspector.decapitalize（由Spring在此處使用）定義的規則相同，

在Bean定義之外別名Bean

在bean定義本身中，可以通過使用id屬性指定的最多一個名稱和屬性中任意數量的其他名稱的組合來為bean提供多個名稱name，這些名稱可以是同一個bean的等效別名，并且在某些情況下很有用，例如，通過使用特定于該組件本身的bean名稱，讓應用程式中的每個組件都參考一個公共依賴項，

但是，在實際定義bean的地方指定所有別名并不總是足夠的，有時需要為在別處定義的bean引入別名，在大型系統中通常是這種情況，在大型系統中，配置在每個子系統之間分配，每個子系統都有自己的物件定義集，在基于XML的配置元資料中，您可以使用元素來完成此任務，以下示例顯示了如何執行此操作：

<alias name="fromName" alias="toName"/>
在這種情況下，(在同一個容器中)名為fromName的bean在使用了這個別名定義之后，也可以被稱為toName，

例如，
子系統A的配置元資料可能參考一個名為subsystem-DataSource的資料源，
子系統B的配置元資料可以參考名為subsystembl-DataSource的資料源，
在撰寫使用這兩個子系統的主應用程式時，主應用程式以myApp-dataSource的名稱參考資料源，
要讓這三個名稱參考同一個物件，您可以在配置元資料中添加以下別名定義:

<alias name="myApp-dataSource" alias="subsystemA-dataSource"/>
<alias name="myApp-dataSource" alias="subsystemB-dataSource"/>

現在，每個組件和主應用程式都可以通過唯一的名稱參考資料源，并且可以保證不與任何其他定義沖突（有效地創建名稱空間），但是它們參考的是同一bean，

Java-configuration

如果使用Java-configuration，則@Bean注解可用于提供別名，有關詳細資訊，請參見使用@Bean注解，

1.3.2，實體化bean

bean定義本質上是創建一個或多個物件的訣竅，當被請求時，容器查看已命名bean的配方，并使用該bean定義封裝的配置元資料來創建(或獲取)實際物件，

如果使用基于XML的配置元資料，則可以在元素的class屬性中指定要實體化的物件的型別（或類），此 class屬性（在內部是實體的Class屬性BeanDefinition）通常是必需的，

以下兩種情況會用到Class屬性：

通常，在容器本身通過反射呼叫其建構式直接創建bean的情況下，
指定要構造的bean類，這在某種程度上等同于使用new運算子的Java代碼，

要指定包含為創建物件而呼叫的靜態工廠方法的實際類，
在容器呼叫類上的靜態工廠方法來創建bean的情況下就不太常見了，
從靜態工廠方法呼叫回傳的物件型別可以是相同的類，也可以完全是另一個類，

內部類名稱
如果希望為靜態嵌套類配置bean定義，則必須使用嵌套類的二進制名稱，

例如，如果你在com中有一個叫做什么的類，
這個東西類有一個名為OtherThing的靜態嵌套類，
bean定義上的class屬性的值將是com.example.SomeThing$OtherThing，

請注意名稱中使用了$字符來分隔嵌套的類名和外部類名，

<bean id="innerClass1" class="org.springframework.example.config.MyBean$InnerClass"/>

用建構式實體化

當通過構造方法創建一個bean時，所有普通類都可以被Spring使用并與之兼容，也就是說，正在開發的類不需要實作任何特定的介面或以特定的方式進行編碼，只需指定bean類就足夠了，但是，根據您用于該特定bean的IoC的型別，您可能需要一個默認（空）建構式，

Spring IoC容器幾乎可以管理您要管理的任何類，它不僅限于管理真正的JavaBean，大多數Spring用戶更喜歡實際的JavaBean，它僅具有默認（無引數）建構式，并具有根據容器中的屬性建模的適當的setter和getter，您還可以在容器中具有更多奇特的非bean樣式類，例如，如果您需要使用絕對不符合JavaBean規范的舊式連接池，則Spring也可以對其進行管理，

使用基于XML的配置元資料，您可以如下指定bean類：

<bean id="exampleBean" class="examples.ExampleBean"/>
<bean name="anotherExample" class="examples.ExampleBeanTwo"/>

有關用于向建構式提供引數（如果需要）并在構造物件之后設定物件實體屬性的機制的詳細資訊，請參見 注入依賴項，

用靜態工廠方法實體化

在定義使用靜態工廠方法創建的bean時，請使用class屬性指定包含static工廠方法的類，并使用命名factory-method為屬性的屬性來指定工廠方法本身的名稱，您應該能夠呼叫此方法（使用可選引數，如稍后所述）并回傳一個活動物件，該物件隨后將被視為已通過建構式創建，這種bean定義的一種用法是static用舊代碼呼叫工廠，

以下bean定義指定通過呼叫工廠方法來創建bean，該定義不指定回傳物件的型別（類），而僅指定包含工廠方法的類，在此示例中，該createInstance() 方法必須是靜態方法，以下示例顯示如何指定工廠方法：

<bean id="clientService"
    class="examples.ClientService"
    factory-method="createInstance"/>

public class ClientService {
    private static ClientService clientService = new ClientService();
    private ClientService() {}

    public static ClientService createInstance() {
        return clientService;
    }
}

使用實體工廠方法實體化

類似于通過靜態工廠方法進行實體化，使用實體工廠方法進行實體化會從容器中呼叫現有bean的非靜態方法來創建新bean，要使用此機制，請將class屬性留空，并在factory-bean屬性中指定當前（或父容器或祖先容器）中包含要創建物件的實體方法的bean的名稱，使用factory-method屬性設定工廠方法本身的名稱，以下示例顯示了如何配置此類Bean：

<bean id="serviceLocator" class="examples.DefaultServiceLocator">
</bean>

<bean id="clientService"
    factory-bean="serviceLocator"
    factory-method="createClientServiceInstance"/>

public class DefaultServiceLocator {

    private static ClientService clientService = new ClientServiceImpl();

    public ClientService createClientServiceInstance() {
        return clientService;
    }
}

一個工廠類也可以包含一個以上的工廠方法，如以下示例所示：

<bean id="serviceLocator" class="examples.DefaultServiceLocator">
    <!-- inject any dependencies required by this locator bean -->
</bean>

<bean id="clientService"
    factory-bean="serviceLocator"
    factory-method="createClientServiceInstance"/>

<bean id="accountService"
    factory-bean="serviceLocator"
    factory-method="createAccountServiceInstance"/>

public class DefaultServiceLocator {

    private static ClientService clientService = new ClientServiceImpl();

    private static AccountService accountService = new AccountServiceImpl();

    public ClientService createClientServiceInstance() {
        return clientService;
    }

    public AccountService createAccountServiceInstance() {
        return accountService;
    }
}

這種方法表明，工廠Bean本身可以通過依賴項注入（DI）進行管理和配置，詳細資訊，請參見依賴性和配置，

在Spring檔案中，“ factory bean”是指在Spring容器中配置并通過實體或 靜態工廠方法創建物件的bean ，相反， FactoryBean（注意大寫）是指特定于Spring的 FactoryBean 實作類，

確定Bean的運行時型別

確定特定bean的運行時型別并非易事，Bean元資料定義中的指定類只是初始類參考，可能與宣告的工廠方法結合使用，或者是FactoryBean可能導致Bean的運行時型別不同的類，或者在實體的情況下根本不設定-級別工廠方法（通過指定factory-bean名稱決議），另外，AOP代理可以使用基于介面的代理包裝bean實體，而目標Bean的實際型別（僅是其實作的介面）的暴露程度有限，

找出特定bean的實際運行時型別的推薦方法是BeanFactory.getType呼叫指定的bean名稱，這考慮了上述所有情況，并回傳了BeanFactory.getBean要針對相同bean名稱回傳的物件的型別，

標籤：Java

上一篇：Spring Boot 集成阿里云 OSS 進行檔案存盤

下一篇：Serverless 初體驗：快速開發與部署一個Hello World（Java版）