Spring IoC容器至少包含一个bean定义,但大多数状况下会有多个bean定义。当使用 基于XML的配置元数据时,将在顶层的<beans/>
元素中配置一个 或多个<bean/>
元素。spring
bean定义与应用程序中实际使用的对象一一对应。一般状况下bean的定义包括:服务 层对象、数据访问层对象(DAO)、相似Struts Action
的 表示层对象、Hibernate SessionFactory
对象、JMS Queue
对象等等。一般bean的定义并不与容器中的领域 对象相同,由于领域对象的建立和加载必须依赖具体的DAO和业务逻辑。.数组
1.如下是一个基于XML的配置元数据的基本结构:函数
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd"> <bean id="..." class="..."> <!-- collaborators and configuration for this bean go here --> </bean> <bean id="..." class="..."> <!-- collaborators and configuration for this bean go here --> </bean> <!-- more bean definitions go here --> </beans>
Spring IoC容器的实例化很是简单,以下面的例子:ui
ApplicationContext context = new ClassPathXmlApplicationContext( new String[] {"services.xml", "daos.xml"}); // an is also a (via inheritance) BeanFactory factory = context;ApplicationContextBeanFactory
将XML配置文件分拆成多个部分是很是有用的。为了加载多个XML文件生成一个 ApplicationContext实例,能够将文件路径做为字符串数组传给ApplicationContext构造器 。而bean factory将经过调用bean defintion reader从多个文件中读取bean定义。this
一般状况下,Spring团队倾向于上述作法,由于这样各个配置并不会查觉到它们 与其余配置文件的组合。另一种方法是使用一个或多个的<import/>
元素 来从另一个或多个文件加载bean定义。全部的<import/>
元素必 须在<bean/>
元素以前完成bean定义的导入。 让咱们看个例子:编码
<beans> <import resource="services.xml"/> <import resource="resources/messageSource.xml"/> <import resource="/resources/themeSource.xml"/> <bean id="bean1" class="..."/> <bean id="bean2" class="..."/> </beans>
在上面的例子中,咱们从3个外部文件:services.xml
、 messageSource.xml
及themeSource.xml
来加载bean定义。这里采用的都是相对路径,所以,此例中的services.xml
必定要与导入文件放在同一目录或类路径,而messageSource.xm l
和themeSource.xml
的文件位置必须放在导入文件所 在目录下的resources
目录中。正如你所看到的那样,开头的斜杠 ‘/’实际上可忽略。所以不用斜杠‘/’可能会更好一点。根据Spring XML配置文件的 Schema(或DTD),被导入文件必须是彻底有效的XML bean定义文件,且根节点必须为 <beans/>
元素。spa
Spring IoC容器将管理一个或多个bean,这些bean 将经过配置文件中的bean定义被建立(在XML格式中为<bean/>
元素)。翻译
在容器内部,这些bean定义由BeanDefinition
对象来表示,该定义将包含如下信息:code
全限定类名:这一般就是已定义bean的实际实现类。component
bean行为的定义,这些定义将决定bean在容器中的行为(做用域、生命周期回调等等)
对其余bean的引用,这些引用bean也能够称之为协做bean(collaborators) 或依赖bean(dependencies).
建立bean实例时的其余配置设置。好比使用bean来定义链接池,能够经过属性或者构 造参数指定链接数,以及链接池大小限制等。
上述内容直接被翻译为每一个bean定义包含的一组properties。下面的表格列出了部分 内容的详细连接:
5.表 bean定义
名称 | 功能 |
---|---|
class | |
name | |
scope | |
constructor arguments | |
properties | |
autowiring mode | |
dependency checking mode | |
lazy-initialization mode | |
initialization method | |
destruction method |
除了经过bean定义来描述要建立的指定bean的属性以外,某些 BeanFactory
的实现也容许将那些非BeanFactory建立的、已有的用户 对象注册到容器中,好比使用DefaultListableBeanFactory
的registerSingleton(..)
方法。不过大多数应用仍是采用 元数据定义为主。
bean命名约定
bean的命名采用标准的Java命名约定,即小写字母开头,首字母大写间隔 的命名方式。如accountManager
、 accountService
、userDao
及loginController
,等等。
对bean采用统一的命名约定将会使配置更加简单易懂。并且在使用Spring AOP时 ,若是要发通知(advice)给与一组名称相关的bean时,这种简单的命名方式将会令你受益不浅。
每一个bean都有一个或多个id
(或称之为标识符或名称,在术语 上能够理解成一回事)。这些id
在当前IoC容器中必须惟一。若是 一个bean有多个id,那么其余的id在本质上将被认为是别名。
当使用基于XML的配置元数据时,将经过id
或 name
属性来指定bean标识符。id
属性具备惟一性, 并且是一个真正的XML ID属性,所以其余xml元素在引用该id时,能够利用XML解析器的 验证功能。一般状况下最好为bean指定一个id。尽管XML规范规定了XML ID命名的有效 字符,可是bean标识符的定义不受该限制,由于除了使用指定的XML字符来做为id,还可 觉得bean指定别名,要实现这一点能够在name
属性中使用逗号、 冒号或者空格将多个id分隔。
值得注意的是,为一个bean提供一个name并非必须的,若是没有指定,那么容 器将为其生成一个唯一的name。对于不指定name属性的缘由咱们会在后面介绍(好比 内部bean就不须要)。
在对bean进行定义时,除了使用id
属性来指定名称 以外,为了提供多个名称,须要经过name
属性来加以指定 。而全部的这些名称都指向同一个bean,在某些状况下提供别名很是有用,好比 为了让应用的每个组件能更容易的对公共组件进行引用。
然而,在定义bean时就指定全部的别名并非老是恰当的。有时咱们指望 能在当前位置为那些在别处定义的bean引入别名。在XML配置文件中,可用 <alias/>
元素来完成bean别名的定义。如:
<alias name="fromName" alias="toName"/>
这里若是在容器中存在名为fromName
的bean定义, 在增长别名定义以后,也能够用toName
来引用。
考虑一个更为具体的例子,组件A在XML配置文件中定义了一个名为 componentA-dataSource的DataSource bean。但组件B却想在其XML文件中 以componentB-dataSource的名字来引用此bean。并且在主程序MyApp的XML配 置文件中,但愿以myApp-dataSource的名字来引用此bean。最后容器加载三个 XML文件来生成最终的ApplicationContext,在此情形下,可经过在MyApp XML 文件中添加下列alias元素来实现:
<alias name="componentA-dataSource" alias="componentB-dataSource"/> <alias name="componentA-dataSource" alias="myApp-dataSource" />
这样一来,每一个组件及主程序就可经过惟一名字来引用同一个数据源而互不干扰。
内部类名
若是须要你但愿将一个静态
的内部类配置为 一个bean的话,那么内部类的名字须要采用二进制的写法。
好比说,在com.example
包下有一个叫 Foo
的类,而Foo
类有一个静态
的内部类叫Bar
,那么在bean定义的时候, class
属性必须这样写:
com.example.Foo$Bar
注意这里咱们使用了$
字符将内部类和外部类进行分隔
从本质上来讲,bean定义描述了如何建立一个或多个对象实例。当须要的时候, 容器会从bean定义列表中取得一个指定的bean定义,并根据bean定义里面的配置元数据 使用反射机制来建立(或取得)一个实际的对象。
当采用XML描述配置元数据时,将经过<bean/>
元素的 class
属性来指定实例化对象的类型。class
属性 (对应BeanDefinition
实例的 Class
属性)一般是必须的(不过也有两种例外的情形,“使用实例工厂方法实例化”和“bean定义的继承”)。class属性主要有两种用途 :在大多数状况下,容器将直接经过反射调用指定类的构造器来建立bean(这有点相似于 在Java代码中使用new操做符);在极少数状况下,容器将调用 类的静态
工厂方法来建立bean实例,class 属性将用来指定实际具备静态
工厂方法的类(至于调用静态工厂 方法建立的对象类型是当前class仍是其余的class则可有可无)。
当采用构造器来建立bean实例时,Spring对class并无特殊的要求, 咱们一般使用的class都适用。也就是说,被建立的类并不须要实现任何特定的 接口,或以特定的方式编码,只要指定bean的class属性便可。不过根据所采用 的IoC类型,class可能须要一个默认的空构造器。
此外,IoC容器不只限于管理JavaBean,它能够管理任意 的类。不过大多数使用Spring的人喜欢使用实际的JavaBean(具备默认的(无参)构造器 及setter和getter方法),但在容器中使用非bean形式(non-bean style)的类也是可 以的。好比遗留系统中的链接池,很显然它与JavaBean规范不符,但Spring也能管理它。
当使用基于XML的元数据配置文件,能够这样来指定bean类:
<bean id="exampleBean" class="examples.ExampleBean"/> <bean name="anotherExample" class="examples.ExampleBeanTwo"/>
给构造函数指定参数以及为bean实例设置属性将在随后的 部分中谈及。
当采用静态工厂方法建立bean时,除了须要指定class
属性外,还须要经过factory-method
属性来指定建立bean实例 的工厂方法。Spring将调用此方法(其可选参数接下来介绍)返回实例对象,就此而言, 跟经过普通构造器建立类实例没什么两样。
下面的bean定义展现了如何经过工厂方法来建立bean实例。注意,此定义并 未指定返回对象的类型,仅指定该类包含的工厂方法。在此例中, createInstance()
必须是一个static方法。
<bean id="exampleBean" class="examples.ExampleBean2" factory-method="createInstance"/>
给工厂方法指定参数以及为bean实例设置属性将在随后的部份中谈及。
与 使用静态工厂方法实例化相似,用来进行实例化的非静态实例工厂方法位 于另一个bean中,容器将调用该bean的工厂方法来建立一个新的bean实例。为使 用此机制,class
属性必须为空,而factory-bean
属性必须指定为当前(或其祖先)容器中包含工厂方法的bean的名称,而该 工厂bean的工厂方法自己必须经过factory-method
属性来设定。
<!-- the factory bean, which contains a method called --> <bean id="serviceLocator" class="com.foo.DefaultServiceLocator"> <!-- inject any dependencies required by this locator bean --> </bean> <!-- the bean to be created via the factory bean --> <bean id="exampleBean" factory-bean="serviceLocator" factory-method="createInstance"/>createInstance()
虽然设置bean属性 的机制仍然在这里被说起,但隐式的作法是由工厂bean本身来管理以及经过依 赖注入(DI)来进行配置。
Spring文档中的factory bean指的是配置在Spring容器中经过使用 实例 或 静态工厂方法建立对象的一种bean。而文档中的FactoryBean
(注意首字母大写)指的是Spring特有的 FactoryBean
。
从本质上讲,BeanFactory
仅仅只是一个 维护bean定义以及相互依赖关系的高级工厂接口。经过BeanFactory
咱们能够访问bean定义。下面的例子建立了一个bean工厂,此工厂 将从xml文件中读取bean定义:
Resource res = new FileSystemResource("beans.xml"); BeanFactory factory = new XmlBeanFactory(res);
基本上就这些了,接着使用getBean(String)
方法就能够取得bean的实例;BeanFactory
提供的方法极其简单。 BeanFactory
接口提供 了很是多的方法,可是对于咱们的应用来讲,最好永远不要调用它们,固然也包括 使用getBean(String)
方法,这样能够避免咱们对 Spring API的依赖。