Spring 3.x 入门学习

来源:互联网 发布:林丹的身体素质数据 编辑:程序博客网 时间:2024/09/21 11:24

一、spring 3.x 介绍

   现在很多的企业级项目中基本上都会用到了Spring框架,那么为什么会出现Spring,Spring是什么?这次的博文我主要为大家简单介绍一下Spring。

Java EE优缺点

       我们都知道在2003年Spring兴起之前,企业普遍使用J2EE技术来开发企业级应用,为什么用J2EE呢?主要原因有以下几个:

1、Java本身的跨平台能力,可移植性强
2、J2EE服务器内置了大量的容器服务,比如事务服务、JNDI服务和连接池服务等等
3、程序员可以基于Java EE API进行企业开发并部署到应用中


       虽然J2EE有着上述优点,但利用J2EE开发有一个致命的缺陷,即研发困难,而且J2EE开发非常容易出问题,比如数据库连接泄露。而Spring的出现则解决了上述问题,至于如何解决,我们会在接下来的文章中深入解释。

Spring是什么

        什么是Spring呢?Spring是为了解决企业应用开发的复杂性而创建的一个轻量级的控制反转(IoC)和面向切面(AOP)的容器框架。Spring使开发者能够编写更干净、更可管理、并且更易于测试的代码。关于Spring具体如何去实现的,这等到我们以后的教程,我会为大家详细分析。     

Spring优点

       简单了解Spring之后,我们看一下Spring的优点

1、方便解耦,简化开发。
2、AOP编程的支持。
3、声明式事务的支持。
4、方便程序的测试。。
5、方便集成各种优秀框架。

6、降低Java EE API的使用难度。


二、IoC概念

       控制反转(Inversion of Control)是一个重要的面向对象编程的法则来削减计算机程序的耦合问题。 它还有一个名字叫做依赖注入(Dependency Injection)。IoC不是什么技术,它是一种设计模式。

 实例演示

       为了更好的说明IoC,我为大家举一个简单的例子,如有这样一个描述:某公司新成立了一个项目组,项目组有若干成员和一个项目组长,项目组成立后第一次开会上,作为项目组长的小李按照惯例首先做了简短的自我介绍。

       根据上述的描述,如果我们写出如下代码和类图:

复制代码
    public class Li {            public void introduce() {            System.out.println("大家好,我是小李");        }    }    public class Team {        public void firstMeeting() {            Li li = new Li();            li.introduce();        }    }
复制代码
<span style="font-family:verdana, Arial, Helvetica, sans-serif;font-size: 16px; line-height: 1.5;">      具体类图如下:</span>


       上述的代码,应该说基本完成了相关的需求,但是仔细考虑之后就会发现,上述的代码是根据具体的场景描述进行的,并没有进行抽象,这样就导致我们不能灵活的安排项目组长去做开场,即根据现在的代码,开场自我介绍被绑定给了小李而不能安排给其他人。为了解决上述的问题,我们引入首先引入Leader接口,相关代码和类图如下: 

复制代码
    public interface Leader {        public void introduce();    }    public class Li implements Leader {        @Override        public void introduce() {            System.out.println("大家好,我是小李");        }    }    public class Team {        public void firstMeeting() {            Leader li = new Li();            li.introduce();        }    }
复制代码

       具体类图如下:

        虽然上述的代码可以让我们安排给其他成员开场,但是我们可以看出Team类同时依赖Leader接口和Li类,并没有达到我们所期望的Team仅仅依赖于Leader接口的目的,如何解决这个问题呢?当然是引入Boss,由Boss决定具体由谁担任项目组长。具体类图和代码如下:

复制代码
    public interface Leader {        public void introduce();    }    public class Li implements Leader {        @Override        public void introduce() {            System.out.println("大家好,我是小李");        }    }        public class Team {        public void firstMetting(Leader leader){            leader.introduce();        }    }        public class Boss {        public void direct(){            Leader leader = new Li();            Team team = new Team();            team.firstMetting(leader);        }    }
复制代码

        具体类图如下:

        通过以上代码和图示,我们可以看出,通过引入老板类,我们将项目小组和具体由谁担任项目组长进行解耦

       对应上述例子,我们再来讲解一下IoC,IoC从字面上看分为控制和反转,控制在上面的实例中就是具体由谁担任项目组长,而反转就是将决定谁担任项目组长转移到Boss类中。通俗理解就是将接口的具体实现类(Li)的控制权从调用类(Team)中分离转交给第三方(Boss)决定。

  三、AOP概念  

OOP回顾

       在介绍AOP之前先来回顾一下大家都比较熟悉的OOP(Object Oriented Programming)。OOP主要是为了实现编程的重用性、灵活性和扩展性。它的几个特征分别是继承、封装、多态和抽象。OOP重点体现在编程架构,强调的是类之间的层次关系。

OOP缺陷

       为了更好的说明OOP的概念,我们接下来讲一个OOP的实例,重点分析OOP存在哪些缺陷,以便更好的理解AOP的相关内容。

       先看如下的一张图:

 

       上面这张图有三个类:Dog,Cat和Duck,他们都有一个方法run。按照OOP的设计理念,我们很容易就会想到抽象出一个Animal父类,同时让这三个子类继承Animal父类。这样的设计可以用如下的图示表示:

 

       在OOP思想中,我们会使用大量的类似上图的编程方式,对类进行抽象、继承、封装和多态来实现编程的重用性、灵活性和扩展性。但是这样的编程仍然有一定的局限性,有时候,OOP并不能很好解决我们再实际开发中遇到的问题。为了说明这个问题,看下面的图示:

 

       看到上面的图,我们暂时还不能发现有什么问题。为了大家便于理解,接下来我来给大家讲解一下上面类图的实现过程。描述如下:马戏团有一条表演的小狗,这条小狗可以跑和跳,但是它完成跑和跳两个动作之前必须是在接到驯兽师发出的命令后,同时完成跑和跳的动作之后,驯兽师会给与响应的奖励,比如一块肉。

       了解了实现过程之后,我们在来看一下具体的代码。 

复制代码
    public class Dog {           public void run() {            System.out.println("驯兽师发出命令!")            System.out.println("小狗开始跑!");            System.out.pringln("驯兽师给与奖励");        }          public void jump() {            System.out.println("驯兽师发出命令!")            System.out.println("小狗开始跳!");            System.out.pringln("驯兽师给与奖励");        }    }
复制代码
<span style="font-family:verdana, Arial, Helvetica, sans-serif;font-size: 16px; line-height: 1.5;">    仔细看上面的代码,我们可以看出<span style="color:#ff0000;">在run方法和jump方法中,存在一些相同的内容(驯兽师发出命令和给与奖励),这些内容并不能完全进行抽象,即不能按照OOP编程思想进行处理。类似这样的情况同样会出现在我们编程中的很多地方,例如:日志记录、性能统计、安全控制、事务处理、异常处理等等</span>。但是这样的情况该如何解决呢?这就引入了AOP编程思想。</span>

 AOP简介

       AOP为Aspect Oriented Programming的缩写,即面向切面编程(也叫面向方面),是一种可以通过预编译方式和运行期动态代理实现在不修改源代码的情况下给程序动态统一添加功能的一种技术。

 AOP实现实例

      为了大家更好的理解AOP如何实现,接下来我们优化一下上述代码。

      首先是Dog类

复制代码
    public interface Animal {        public void run();        public void jump();    }        public class Dog implements Animal{        public void run(){            System.out.println("小狗开始跑!");        }            public void jump(){            System.out.println("小狗开始跳!");        }            }
复制代码

     对比之前的代码我们可以明显看出,我们将关于驯兽师的相关内容从run和jump中进行了抽取,接下来,我们如何在程序运行中将关于驯兽师的动作加入到程序中呢?这就是我们这次用到的AOP实现的核心技术动态代理(Dynamic Proxy)。具体代码如下:

复制代码
    public class MyProxy  implements InvocationHandler{        private Object targetObject;                public Object createProxyInstance(Object targetObject) {            this.targetObject = targetObject;            return Proxy.newProxyInstance(targetObject.getClass().getClassLoader(),                                    targetObject.getClass().getInterfaces(),                                    this);        }                public Object invoke(Object proxy, Method method, Object[] args)                throws Throwable {            command();                    Object ret = method.invoke(targetObject, args);            award();            return ret;        }                private void command() {            System.out.println("驯兽师发出命令!");        }                private void award(){            System.out.println("驯兽师给与奖励!");        }    }
复制代码
<span style="font-family:verdana, Arial, Helvetica, sans-serif;font-size: 16px; line-height: 1.5;">  上述代码实现完成之后,我们改如何调用呢?参考代码如下:</span>
复制代码
    public class Client {        public static void main(String[] args) {            MyProxy hander = new MyProxy();            Animal dog = (Animal)hander.createProxyInstance(new Dog());            dog.run();            dog.jump();        }    }
复制代码
<span style="font-family:verdana, Arial, Helvetica, sans-serif;font-size: 16px; line-height: 1.5;">  执行结果如下:</span>

 

       关于AOP编程的实例演示就完成了,接下来重新回顾一下AOP与OOP的相关概念。

AOP与OOP的关系

       OOP针对业务处理过程的实体(Dog、Cat、Duck)及其属性和行为(run)进行抽象封装,以获得更加清晰高效的逻辑单元划分。而AOP则是针对业务处理过程中(run或jump)的切面(command和award)进行提取,它所面对的是处理过程中的某个步骤或阶段,以获得逻辑过程中各部分之间低耦合性的隔离效果。这两种设计思想在目标上有着本质的差异。




四、spring 3.x 注解




使用 @Repository、@Service、@Controller 和 @Component 将类标识为 Bean

Spring 自 2.0 版本开始,陆续引入了一些注解用于简化 Spring 的开发。@Repository注解便属于最先引入的一批,它用于将数据访问层 (DAO 层 ) 的类标识为 Spring Bean。具体只需将该注解标注在 DAO类上即可。同时,为了让 Spring 能够扫描类路径中的类并识别出 @Repository 注解,需要在 XML 配置文件中启用 Bean的自动扫描功能,这可以通过 <context:component-scan/> 实现。如下所示:

 // 首先使用 @Repository 将 DAO 类声明为 Bean
 package bookstore.dao;
 @Repository
 public class UserDaoImpl implements UserDao{ …… }

 // 其次,在 XML 配置文件中启动 Spring 的自动扫描功能
 <beans … >
    ……
 <context:component-scan base-package=”bookstore.dao” />
……
 </beans>
 

如此,我们就不再需要在 XML 中显式使用 <bean/> 进行 Bean 的配置。Spring 在容器初始化时将自动扫描base-package 指定的包及其子包下的所有 class 文件,所有标注了 @Repository 的类都将被注册为 SpringBean。

为什么 @Repository 只能标注在 DAO 类上呢?这是因为该注解的作用不只是将类识别为Bean,同时它还能将所标注的类中抛出的数据访问异常封装为 Spring 的数据访问异常类型。 Spring本身提供了一个丰富的并且是与具体的数据访问技术无关的数据访问异常结构,用于封装不同的持久层框架抛出的异常,使得异常独立于底层的框架。

Spring 2.5 在 @Repository 的基础上增加了功能类似的额外三个注解:@Component、@Service、@Constroller,它们分别用于软件系统的不同层次:

•@Component 是一个泛化的概念,仅仅表示一个组件 (Bean) ,可以作用在任何层次。
•@Service 通常作用在业务层,但是目前该功能与 @Component 相同。
•@Constroller 通常作用在控制层,但是目前该功能与 @Component 相同。
通过在类上使用 @Repository、@Component、@Service 和 @Constroller 注解,Spring 会自动创建相应的BeanDefinition 对象,并注册到 ApplicationContext 中。这些类就成了 Spring受管组件。这三个注解除了作用于不同软件层次的类,其使用方式与 @Repository 是完全相同的。

另外,除了上面的四个注解外,用户可以创建自定义的注解,然后在注解上标注 @Component,那么,该自定义注解便具有了与所 @Component 相同的功能。不过这个功能并不常用。

当一个 Bean 被自动检测到时,会根据那个扫描器的 BeanNameGenerator 策略生成它的 bean名称。默认情况下,对于包含 name 属性的 @Component、@Repository、 @Service 和 @Controller,会把name 取值作为 Bean 的名字。如果这个注解不包含 name 值或是其他被自定义过滤器发现的组件,默认 Bean名称会是小写开头的非限定类名。如果你不想使用默认 bean 命名策略,可以提供一个自定义的命名策略。首先实现 BeanNameGenerator接口,确认包含了一个默认的无参数构造方法。然后在配置扫描器时提供一个全限定类名,如下所示:

 <beans ...>
 <context:component-scan
    base-package="a.b" name-generator="a.SimpleNameGenerator"/>
 </beans>
 

与通过 XML 配置的 Spring Bean 一样,通过上述注解标识的Bean,其默认作用域是"singleton",为了配合这四个注解,在标注 Bean 的同时能够指定 Bean 的作用域,Spring 2.5引入了 @Scope 注解。使用该注解时只需提供作用域的名称就行了,如下所示:

 @Scope("prototype")
 @Repository
 public class Demo { … }
 

如果你想提供一个自定义的作用域解析策略而不使用基于注解的方法,只需实现 ScopeMetadataResolver 接口,确认包含一个默认的没有参数的构造方法。然后在配置扫描器时提供全限定类名:

 <context:component-scan base-package="a.b"
 scope-resolver="footmark.SimpleScopeResolver" />
 


--------------------------------------------------------------------------------


使用 @PostConstruct 和 @PreDestroy 指定生命周期回调方法

Spring Bean 是受 Spring IoC 容器管理,由容器进行初始化和销毁的(prototype类型由容器初始化之后便不受容器管理),通常我们不需要关注容器对 Bean 的初始化和销毁操作,由 Spring 经过构造函数或者工厂方法创建的Bean就是已经初始化完成并立即可用的。然而在某些情况下,可能需要我们手工做一些额外的初始化或者销毁操作,这通常是针对一些资源的获取和释放操作。Spring 1.x 为此提供了两种方式供用户指定执行生命周期回调的方法。

第一种方式是实现 Spring 提供的两个接口:InitializingBean 和 DisposableBean。如果希望在 Bean初始化完成之后执行一些自定义操作,则可以让 Bean 实现 InitializingBean 接口,该接口包含一个afterPropertiesSet() 方法,容器在为该 Bean 设置了属性之后,将自动调用该方法;如果 Bean 实现了DisposableBean 接口,则容器在销毁该 Bean 之前,将调用该接口的 destroy() 方法。这种方式的缺点是,让 Bean类实现 Spring 提供的接口,增加了代码与 Spring 框架的耦合度,因此不推荐使用。

第二种方式是在 XML 文件中使用 <bean> 的 init-method 和 destroy-method属性指定初始化之后和销毁之前的回调方法,代码无需实现任何接口。这两个属性的取值是相应 Bean类中的初始化和销毁方法,方法名任意,但是方法不能有参数。示例如下:

 <bean id=”userService”
 class=”bookstore.service.UserService”
 init-method=”init” destroy-method=”destroy”>
    …
 </bean>
 

Spring 2.5 在保留以上两种方式的基础上,提供了对 JSR-250 的支持。JSR-250规范定义了两个用于指定声明周期方法的注解:@PostConstruct 和@PreDestroy。这两个注解使用非常简单,只需分别将他们标注于初始化之后执行的回调方法或者销毁之前执行的回调方法上。由于使用了注解,因此需要配置相应的 Bean 后处理器,亦即在 XML 中增加如下一行:

 <context:annotation-config />
 

比较上述三种指定生命周期回调方法的方式,第一种是不建议使用的,不但其用法不如后两种方式灵活,而且无形中增加了代码与框架的耦合度。后面两种方式开发者可以根据使用习惯选择其中一种,但是最好不要混合使用,以免增加维护的难度。


--------------------------------------------------------------------------------


使用 @Required 进行 Bean 的依赖检查

依赖检查的作用是,判断给定 Bean 的相应 Setter 方法是否都在实例化的时候被调用了。而不是判断字段是否已经存在值了。Spring进行依赖检查时,只会判断属性是否使用了 Setter 注入。如果某个属性没有使用 Setter注入,即使是通过构造函数已经为该属性注入了值,Spring 仍然认为它没有执行注入,从而抛出异常。另外,Spring 只管是否通过 Setter执行了注入,而对注入的值却没有任何要求,即使注入的 <null/>,Spring 也认为是执行了依赖注入。

<bean> 标签提供了 dependency-check 属性用于进行依赖检查。该属性的取值包括以下几种:

•none -- 默认不执行依赖检查。可以在 <beans> 标签上使用 default-dependency-check 属性改变默认值。
•simple -- 对原始基本类型和集合类型进行检查。
•objects -- 对复杂类型进行检查(除了 simple 所检查类型之外的其他类型)。
•all -- 对所有类型进行检查。
旧版本使用 dependency-check 在配置文件中设置,缺点是粒度较粗。使用 Spring2.0 提供的 @Required注解,提供了更细粒度的控制。@Required 注解只能标注在 Setter 方法之上。因为依赖注入的本质是检查 Setter方法是否被调用了,而不是真的去检查属性是否赋值了以及赋了什么样的值。如果将该注解标注在非 setXxxx() 类型的方法则被忽略。

为了让 Spring 能够处理该注解,需要激活相应的 Bean 后处理器。要激活该后处理器,只需在 XML 中增加如下一行即可。

 <context:annotation-config/>
 

当某个被标注了 @Required 的 Setter 方法没有被调用,则 Spring 在解析的时候会抛出异常,以提醒开发者对相应属性进行设置。


--------------------------------------------------------------------------------


使用 @Resource、@Autowired 和 @Qualifier 指定 Bean 的自动装配策略

自动装配是指,Spring 在装配 Bean 的时候,根据指定的自动装配规则,将某个 Bean 所需要引用类型的 Bean 注入进来。<bean> 元素提供了一个指定自动装配类型的 autowire 属性,该属性有如下选项:

•no -- 显式指定不使用自动装配。
•byName -- 如果存在一个和当前属性名字一致的 Bean,则使用该 Bean 进行注入。如果名称匹配但是类型不匹配,则抛出异常。如果没有匹配的类型,则什么也不做。
•byType-- 如果存在一个和当前属性类型一致的 Bean ( 相同类型或者子类型 ),则使用该 Bean 进行注入。byType能够识别工厂方法,即能够识别 factory-method 的返回类型。如果存在多个类型一致的Bean,则抛出异常。如果没有匹配的类型,则什么也不做。
•constructor -- 与 byType 类似,只不过它是针对构造函数注入而言的。如果当前没有与构造函数的参数类型匹配的 Bean,则抛出异常。使用该种装配模式时,优先匹配参数最多的构造函数。
•autodetect -- 根据 Bean 的自省机制决定采用 byType 还是 constructor 进行自动装配。如果 Bean 提供了默认的构造函数,则采用 byType;否则采用 constructor 进行自动装配。
当使用 byType 或者 constructor 类型的自动装配的时候,自动装配也支持引用类型的数组或者使用了泛型的集合,这样,Spring就会检查容器中所有类型匹配的 Bean,组成集合或者数组后执行注入。对于使用了泛型的 Map 类型,如果键是 String 类型,则Spring 也会自动执行装配,将所有类型匹配的 Bean 作为值,Bean 的名字作为键。

我们可以给 <beans> 增加 default-autowire属性,设置默认的自动封装策略。默认值为"no"。如果使用自动装配的同时,也指定了 property 或者 constructor-arg标签,则显式指定的值将覆盖自动装配的值。目前的自动封装不支持简单类型,比如基本类型、String、Class,以及它们的数组类型。

在按类型匹配的时候 ( 可能是 byType、constructor、autodetect),同一个类型可能存在多个 Bean,如果被注入的属性是数组、集合或者 Map,这可能没有问题,但是如果只是简单的引用类型,则会抛出异常。解决方法有如下几种:

•取消该 Bean 的自动装配特性,使用显式的注入。我们可能不希望某个 Bean 被当作其他 Bean执行自动封装时的候选对象,我们可以给该 <bean> 增加autowire-candidate="false"。(autowire-candidate 属性和 autowire属性相互独立,互不相干。某个 Bean 可以将 autowire-candidate 设置为 false,同时使用 autowire 特性。)另外,我们可以设置 <beans> 的 default-autowire-candidates属性,可以在该属性中指定可以用于自动装配候选 Bean 的匹配模式,比如default-autowire-candidates="*serv,*dao",这表示所有名字以 serv 或者 dao 结尾的 Bean被列为候选,其他则忽略,相当于其他 Bean 都指定为 autowire-candidate="false",此时可以显式为<bean> 指定 autowire-candidate="true"。在 <bean> 上指定的设置要覆盖<beans> 上指定的设置。
•如果在多个类型相同的 Bean 中有首选的 Bean,那么可以将该 <bean>的 primary 属性设置为 "true" ,这样自动装配时便优先使用该 Bean 进行装配。此时不能将autowire-candidate 设为 false。
•如果使用的是 Java 5 以上版本,可以使用注解进行更细粒度的控制。
使用 @Autowired 和 @Qualifier 注解执行自动装配

使用 @Autowired 注解进行装配,只能是根据类型进行匹配。@Autowired 注解可以用于 Setter方法、构造函数、字段,甚至普通方法,前提是方法必须有至少一个参数。@Autowired 可以用于数组和使用泛型的集合类型。然后 Spring会将容器中所有类型符合的 Bean 注入进来。@Autowired 标注作用于 Map 类型时,如果 Map 的 key 为 String类型,则 Spring 会将容器中所有类型符合 Map 的 value 对应的类型的 Bean 增加进来,用 Bean 的 id 或 name作为 Map 的 key。

@Autowired 标注作用于普通方法时,会产生一个副作用,就是在容器初始化该 Bean 实例的时候就会调用该方法。当然,前提是执行了自动装配,对于不满足装配条件的情况,该方法也不会被执行。

当标注了 @Autowired 后,自动注入不能满足,则会抛出异常。我们可以给 @Autowired 标注增加一个required=false 属性,以改变这个行为。另外,每一个类中只能有一个构造函数的 @Autowired.required() 属性为true。否则就出问题了。如果用 @Autowired 同时标注了多个构造函数,那么,Spring 将采用贪心算法匹配构造函数 ( 构造函数最长)。

@Autowired 还有一个作用就是,如果将其标注在 BeanFactory 类型、ApplicationContext类型、ResourceLoader 类型、ApplicationEventPublisher 类型、MessageSource 类型上,那么Spring 会自动注入这些实现类的实例,不需要额外的操作。

当容器中存在多个 Bean 的类型与需要注入的相同时,注入将不能执行,我们可以给 @Autowired 增加一个候选值,做法是在@Autowired 后面增加一个 @Qualifier 标注,提供一个 String 类型的值作为候选的 Bean 的名字。举例如下:

 @Autowired(required=false)
 @Qualifier("ppp")
 public void setPerson(person p){}
 

@Qualifier 甚至可以作用于方法的参数 ( 对于方法只有一个参数的情况,我们可以将 @Qualifer 标注放置在方法声明上面,但是推荐放置在参数前面 ),举例如下:

 @Autowired(required=false)
 public void sayHello(@Qualifier("ppp")Person p,String name){}
 

我们可以在配置文件中指定某个 Bean 的 qualifier 名字,方法如下:

 <bean id="person" class="footmark.spring.Person">
    <qualifier value="ppp"/>
 </bean>
 

如果没有明确指定 Bean 的 qualifier 名字,那么默认名字就是 Bean 的名字。通常,qualifier 应该是有业务含义的,例如 "domain","persistent" 等,而不应该是类似 "person" 方式。

我们还可以将 @Qualifier 标注在集合类型上,那么所有 qualifier 名字与指定值相同的 Bean 都将被注入进来。

最后,配置文件中需要指定每一个自定义注解的属性值。我们可以使用 <meta> 标签来代替 <qualifier/>标签,如果 <meta> 标签和 <qualifier/> 标签同时出现,那么优先使用<qualifier> 标签。如果没有 <qualifier> 标签,那么会用 <meta>提供的键值对来封装 <qualifier> 标签。示例如下:

 <bean class="footmark.HelloWorld">
 <qualifier type="MovieQualifier">
 <attribute key="format" value="VHS"/>
 <attribute key="genre" value="Comedy"/>
 </qualifier>
 </bean>
 <bean class="footmark.HelloWorld">
 <meta key="format" value="DVD"/>
 <meta key="genre" value="Action"/>
 </bean>
 

@Autowired 注解对应的后处理注册与前面相似,只需在配置文件中增加如下一行即可:

 <context:annotation-config/>
 

如果 @Autowired 注入的是 BeanFactory、ApplicationContext、ResourceLoader等系统类型,那么则不需要 @Qualifier,此时即使提供了 @Qualifier 注解,也将会被忽略;而对于自定义类型的自动装配,如果使用了@Qualifier 注解并且没有名字与之匹配的 Bean,则自动装配匹配失败。

使用 JSR-250 中的 @Resource 和 @Qualifier 注解

如果希望根据 name 执行自动装配,那么应该使用 JSR-250 提供的 @Resource 注解,而不应该使用 @Autowired 与 @Qualifier 的组合。

@Resource 使用 byName 的方式执行自动封装。@Resource 标注可以作用于带一个参数的 Setter方法、字段,以及带一个参数的普通方法上。@Resource 注解有一个 name 属性,用于指定 Bean 在配置文件中对应的名字。如果没有指定name 属性,那么默认值就是字段或者属性的名字。@Resource 和 @Qualifier 的配合虽然仍然成立,但是 @Qualifier对于 @Resource 而言,几乎与 name 属性等效。

如果 @Resource 没有指定 name 属性,那么使用 byName 匹配失败后,会退而使用 byType继续匹配,如果再失败,则抛出异常。在没有为 @Resource 注解显式指定 name 属性的前提下,如果将其标注在 BeanFactory类型、ApplicationContext 类型、ResourceLoader 类型、ApplicationEventPublisher类型、MessageSource 类型上,那么 Spring 会自动注入这些实现类的实例,不需要额外的操作。此时 name 属性不需要指定 (或者指定为""),否则注入失败;如果使用了 @Qualifier,则该注解将被忽略。而对于用户自定义类型的注入,@Qualifier 和name 等价,并且不被忽略。

<bean> 的 primary 和 autowire-candidate 属性对 @Resource、@Autowired 仍然有效。


--------------------------------------------------------------------------------

使用 @Configuration 和 @Bean 进行 Bean 的声明

虽然 2.0 版本发布以来,Spring 陆续提供了十多个注解,但是提供的这些注解只是为了在某些情况下简化 XML 的配置,并非要取代XML 配置方式。这一点可以从 Spring IoC 容器的初始化类可以看出:ApplicationContext 接口的最常用的实现类是ClassPathXmlApplicationContext 和 FileSystemXmlApplicationContext,以及面向Portlet 的 XmlPortletApplicationContext 和面向 web 的XmlWebApplicationContext,它们都是面向 XML 的。Spring 3.0新增了另外两个实现类:AnnotationConfigApplicationContext 和AnnotationConfigWebApplicationContext。从名字便可以看出,它们是为注解而生,直接依赖于注解作为容器配置信息来源的 IoC 容器初始化类。由于 AnnotationConfigWebApplicationContext 是AnnotationConfigApplicationContext 的 web 版本,其用法与后者相比几乎没有什么差别,因此本文将以AnnotationConfigApplicationContext 为例进行讲解。

AnnotationConfigApplicationContext 搭配上 @Configuration 和 @Bean注解,自此,XML 配置方式不再是 Spring IoC容器的唯一配置方式。两者在一定范围内存在着竞争的关系,但是它们在大多数情况下还是相互协作的关系,两者的结合使得 Spring IoC容器的配置更简单,更强大。

之前,我们将配置信息集中写在 XML 中,如今使用注解,配置信息的载体由 XML 文件转移到了 Java类中。我们通常将用于存放配置信息的类的类名以 “Config” 结尾,比如AppDaoConfig.java、AppServiceConfig.java 等等。我们需要在用于指定配置信息的类上加上@Configuration 注解,以明确指出该类是 Bean 配置的信息源。并且 Spring 对标注 Configuration的类有如下要求:

•配置类不能是 final 的;
•配置类不能是本地化的,亦即不能将配置类定义在其他类的方法内部;
•配置类必须有一个无参构造函数。
AnnotationConfigApplicationContext将配置类中标注了 @Bean 的方法的返回值识别为 Spring Bean,并注册到容器中,受 IoC 容器管理。@Bean 的作用等价于XML 配置中的 <bean/> 标签。示例如下:

 @Configuration
 public class BookStoreDaoConfig{
    @Bean
    public UserDao userDao(){ return new UserDaoImpl();}
    @Bean
    public BookDao bookDao(){return new BookDaoImpl();}
 }
 

Spring 在解析到以上文件时,将识别出标注 @Bean 的所有方法,执行之,并将方法的返回值 ( 这里是 UserDaoImpl 和BookDaoImpl 对象 ) 注册到 IoC 容器中。默认情况下,Bean 的名字即为方法名。因此,与以上配置等价的 XML 配置如下:

 <bean id=”userDao” class=”bookstore.dao.UserDaoImpl”/>
 <bean id=”bookDao” class=”bookstore.dao.BookDaoImpl”/>
 

@Bean 具有以下四个属性:

•name -- 指定一个或者多个 Bean 的名字。这等价于 XML 配置中 <bean> 的 name 属性。
•initMethod -- 容器在初始化完 Bean 之后,会调用该属性指定的方法。这等价于 XML 配置中 <bean> 的 init-method 属性。
•destroyMethod -- 该属性与 initMethod 功能相似,在容器销毁 Bean 之前,会调用该属性指定的方法。这等价于 XML 配置中 <bean> 的 destroy-method 属性。
•autowire-- 指定 Bean 属性的自动装配策略,取值是 Autowire类型的三个静态属性。Autowire.BY_NAME,Autowire.BY_TYPE,Autowire.NO。与 XML 配置中的autowire 属性的取值相比,这里少了 constructor,这是因为 constructor 在这里已经没有意义了。
@Bean 没有直接提供指定作用域的属性,可以通过 @Scope 来实现该功能,关于 @Scope 的用法已在上文列举。

下面讲解基于注解的容器初始化。AnnotationConfigApplicationContext 提供了三个构造函数用于初始化容器。

•AnnotationConfigApplicationContext():该构造函数初始化一个空容器,容器不包含任何 Bean 信息,需要在稍后通过调用其 register() 方法注册配置类,并调用 refresh() 方法刷新容器。
•AnnotationConfigApplicationContext(Class<?>... annotatedClasses):这是最常用的构造函数,通过将涉及到的配置类传递给该构造函数,以实现将相应配置类中的 Bean 自动注册到容器中。
•AnnotationConfigApplicationContext(String...basePackages):该构造函数会自动扫描以给定的包及其子包下的所有类,并自动识别所有的 SpringBean,将其注册到容器中。它不但识别标注 @Configuration 的配置类并正确解析,而且同样能识别使用@Repository、@Service、@Controller、@Component 标注的类。
除了使用上面第三种类型的构造函数让容器自动扫描 Bean 的配置信息以外,AnnotationConfigApplicationContext 还提供了 scan()方法,其功能与上面也类似,该方法主要用在容器初始化之后动态增加 Bean 至容器中。调用了该方法以后,通常需要立即手动调用 refresh()刷新容器,以让变更立即生效。

需要注意的是,AnnotationConfigApplicationContext 在解析配置类时,会将配置类自身注册为一个Bean,因为 @Configuration 注解本身定义时被 @Component 标注了。因此可以说,一个 @Configuration同时也是一个 @Component。大多数情况下,开发者用不到该 Bean,并且在理想情况下,该 Bean应该是对开发者透明的。@Configuration 的定义如下所示:

 @Target({ElementType.TYPE})
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
 @Component
 public @interface Configuration {
 String value() default "";
 }
 

在一般的项目中,为了结构清晰,通常会根据软件的模块或者结构定义多个 XML 配置文件,然后再定义一个入口的配置文件,该文件使用<import/> 将其他的配置文件组织起来。最后只需将该文件传给 ClassPathXmlApplicationContext的构造函数即可。针对基于注解的配置,Spring 也提供了类似的功能,只需定义一个入口配置类,并在该类上使用 @Import注解引入其他的配置类即可,最后只需要将该入口类传递给 AnnotationConfigApplicationContext。具体示例如下:

 @Configuration
 @Import({BookStoreServiceConfig.class,BookStoreDaoConfig.class})
 public class BookStoreConfig{ … }
 


--------------------------------------------------------------------------------


混合使用 XML 与注解进行 Bean 的配置

设计 @Configuration 和 @Bean 的初衷,并不是为了完全取代 XML,而是为了在 XML 之外多一种可行的选择。由于Spring 自发布以来,Spring 开发小组便不断简化 XML 配置,使得 XML 配置方式已经非常成熟,加上 Spring 2.0以后出现了一系列命名空间的支持,使得 XML 配置方式成为了使用简单、功能强大的 Bean 定义方式。而且,XML配置的一些高级功能目前还没有相关注解能够直接支持。因此,在目前的多数项目中,要么使用纯粹的 XML 配置方式进行 Bean的配置,要么使用以注解为主,XML 为辅的配置方式进行 Bean 的配置。

之所以会出现两者共存的情况,主要归结为三个原因:其一,目前绝大多数采用 Spring 进行开发的项目,几乎都是基于 XML配置方式的,Spring 在引入注解的同时,必须保证注解能够与 XML 和谐共存,这是前提;其二,由于注解引入较晚,因此功能也没有发展多年的XML 强大,因此,对于复杂的配置,注解还很难独当一面,在一段时间内仍然需要 XML 的配合才能解决问题。除此之外,Spring 的 Bean的配置方式与 Spring 核心模块之间是解耦的,因此,改变配置方式对 Spring 的框架自身是透明的。Spring 可以通过使用 Bean后处理器 (BeanPostProcessor) 非常方便的增加对于注解的支持。这在技术实现上非常容易的事情。

要使用混合配置方式,首先需要判断以哪一种配置方式为主。对这个问题的不同回答将会直接影响到实现的方式。然而大可不必为此伤脑筋,因为不论是以XML 为主,还是以注解为主,配置方式都是简单而且容易理解的。这里不存在错误的决定,因为仅仅是表现方式不一样。我们首先假设以 XML配置为主的情况。

对于已经存在的大型项目,可能初期是以 XML 进行 Bean 配置的,后续逐渐加入了注解的支持,这时我们只需在 XML 配置文件中将被@Configuration 标注的类定义为普通的 <bean>,同时注册处理注解的 Bean 后处理器即可。示例如下:

 // 假设存在如下的 @Configuration 类:
 package bookstore.config;
 import bookstore.dao.*;
 @Configuration
 public class MyConfig{
 @Bean
    public UserDao userDao(){
        return new UserDaoImpl();
    }
 }
此时,只需在 XML 中作如下声明即可:
 <beans … >
    ……
    <context:annotation-config />
    <bean class=”demo.config.MyConfig”/>
 </beans>
 

由于启用了针对注解的 Bean 后处理器,因此在 ApplicationContext 解析到 MyConfig 类时,会发现该类标注了@Configuration 注解,随后便会处理该类中标注 @Bean 的方法,将这些方法的返回值注册为容器总的 Bean。

对于以上的方式,如果存在多个标注了 @Configuration 的类,则需要在 XML 文件中逐一列出。另一种方式是使用前面提到的自动扫描功能,配置如下:

 <context:component-scan base-package=”bookstore.config” />
 

如此,Spring 将扫描所有 demo.config 包及其子包中的类,识别所有标记了@Component、@Controller、@Service、@Repository 注解的类,由于 @Configuration注解本身也用 @Component 标注了,Spring 将能够识别出 @Configuration 标注类并正确解析之。

对于以注解为中心的配置方式,只需使用 @ImportResource 注解引入存在的 XML 即可,如下所示:

 @Configuration
 @ImportResource(“classpath:/bookstore/config/spring-beans.xml”)
 public class MyConfig{
……
 }
 // 容器的初始化过程和纯粹的以配置为中心的方式一致:
 AnnotationConfigApplicationContext ctx =
              new AnnotationConfigApplicationContext(MyConfig.class);

……



原文:深入Spring详解:http://www.cnblogs.com/zs234/p/3267623.html

Spring注解:http://blog.csdn.net/wangjq_123456/article/details/8562379#t1

0 0
原创粉丝点击