【Spring进阶系列丨第七篇】Spring框架新注解分类及详解

文章目录

一、Spring新注解

1.1、Configuration注解

1.1.1、定义一个类

publicclassSpringMainConfig{}

1.1.2、使用Configuration注解修饰类

@ConfigurationpublicclassSpringMainConfig{}

1.1.3、作用

​ 使用Configuration注解修饰的类表示的是：当前类是一个配置类。该类的作用和beans.xml是一样的，换句话说，该注解所修饰的类就是用来代替beans.xml文件的。

1.2、Bean注解

1.2.1、定义bean

publicclassUser{privateInteger id;privateString name;publicUser(Integer id,String name){this.id = id;this.name = name;}}

1.2.2、在主配置类中注册bean

​ 在以前，使用xml去注册bean的时候，使用的是bean标签，形如：

<beanid="user"class="cn.bdqn.User"/>

​ 现在改为使用注解，使用的是@Bean注解。

@ConfigurationpublicclassSpringMainConfig{// 给容器中注册一个bean;类型为方法返回值的类型，默认方法名作为id，即bean的名字默认是方法名@BeanpublicUseruser(){returnnewUser(1,"段康家");}}

1.2.3、测试容器中是否有该bean

@TestpublicvoidtestUser()throwsException{ApplicationContext ac =newAnnotationConfigApplicationContext(SpringMainConfig.class);User user =(User) ac.getBean("user");System.out.println(user);// User{id=1, name='段康家'}}

1.2.4、注册bean的同时可以指定bean名称

@ConfigurationpublicclassSpringMainConfig{// 给容器中注册一个Bean;类型为返回值的类型，id默认是用方法名作为id// 可以再注册Bean的同时，不用方法名作为id,可以指定bean的名称。@Bean("user01")publicUseruser(){returnnewUser(1,"段康家");}}

1.2.5、补充内容

1.2.5.1、案例1【方法有参数】

// 定义UserDao接口publicinterfaceUserDao{}

// 定义UserDao接口的实现类publicclassUserDaoImpl01implementsUserDao{}

// 定义UserServicepublicclassUserServiceImpl{privateUserDao userDao;// 构造方法接收UserDao类型的对象publicUserServiceImpl(UserDao userDao){this.userDao = userDao;}}

重点看主配置类：

@ConfigurationpublicclassSpringMainConfig{// 给容器中注册一个Bean;类型为返回值的类型，id默认是用方法名作为id@BeanpublicUserServiceImpluserService(UserDao userDao){returnnewUserServiceImpl(userDao);}@BeanpublicUserDaouserDao01(){returnnewUserDaoImpl01();}}

@TestpublicvoidtestUser()throwsException{ApplicationContext ac =newAnnotationConfigApplicationContext(SpringMainConfig.class);UserServiceImpl userService =(UserServiceImpl) ac.getBean("userService");System.out.println(userService);}

说明：测试后发现程序能够正常运行，说明UserDao能够正常的以构造函数参数的形式注入到UserServiceImpl类中。

总结：当我们使用Bean注解配置方法时，如果方法有参数，spring框架会去容器中查找有没有可用的bean对象。查找的方式和Autowired注解的作用是一样的。即：Spring会从容器中根据类型注入

1.2.5.2、案例2

当然还有一种情况是：容器中注册了多个相同类型的Bean，那么Spring又是如何注入的呢？在8.2.5.1案例基础之上再添加一个UserDaoImpl02。

publicclassUserDaoImpl02implementsUserDao{}

在再主配置类中注册该UserDaoImpl02的Bean.

通过看图可以知道，有问题，不能够实现自动注入，该怎么办呢？两种方式：

a、修改方法的参数

b、指定Bean的名称

总结：本质上来说，解决方案1和解决方案2是一样的。

c、使用Qualifier注解。

​ 实际上在7.3.2章节中，已经讲到了关于Qualifier注解的使用，通过该注解实现的功能是：当系统中存在多个相同类型的bean的时候，Spring就会注入失败，这个时候就需要再根据名称实现注入，而使用Qualifier注解可以达到根据给定名称的bean实现注入 。在以前讲解的过程中，我们是把该注解应用到了对类的成员变量上 ，但是需要注意的细节是：该注解应用到成员变量上时，注入时不能单独使用，需要搭配Autowired注解 。 但是，这里有一个例外，那么就是该注解也可以应用在方法参数上。

​

​ 特别注意：当把Qualifier注解应用在方法参数上时，可以单独使用

1.3、ComponentScan注解

==作用：==指定spring在创建容器时要扫描的包。作用就如同在配置文件中这样的定义：

<beans><context:component-scanbase-package="cn.bdqn"/></beans>

1.3.1、案例1

第一步：定义三个Bean，分别是CatController、CatService、CatMapper，并分别用@Controller、@Service、@Repository修饰。

packagecn.bdqn.controller;@ControllerpublicclassCatController{}

packagecn.bdqn.service;@ServicepublicclassCatServiceImpl{}

packagecn.bdqn.mapper;@RepositorypublicclassCatMapper{}

第二步：要想真正的注册到容器中，就必须要让容器扫描到此注解所修饰的类所在的包。

@Configuration@ComponentScan(value ={"cn.bdqn"})publicclassSpringMainConfig{}

第三步：测试容器中是否注册了该bean。

@TestpublicvoidtestComponentScan()throwsException{ApplicationContext ac =newAnnotationConfigApplicationContext(SpringMainConfig.class);// 获取Spring容器中已经注册好的bean,把所有bean的名字获取出来String[] names = ac.getBeanDefinitionNames();for(String name:names){System.out.println(name);}}/**
    结果：
        catController
        catMapper
        catServiceImpl
*/

总结：默认情况下，Spring会扫描cn.bdqn包以及子包下面所有的使用@Controller、@Service、@Repository、@Component所修饰的bean注册到容器中

1.3.2、案例2

需求：我现在不想扫描被@Controller所修饰的类注册到容器中，即让Spring扫描不到即可。言外之意就是：把所有被@Controller所修饰的类给排除掉。

说明：定义的CatController、CatServiceImpl、CatMapper不变，使用的是案例1。唯一要修改的配置是主配置文件类。为@ComponentScan注解添加excludeFilters属性即可。

含义：excludeFilters的作用指定扫描的时候按照什么规则排除那些组件。

做法：修改主配置类，即

@Configuration@ComponentScan(
  value ={"cn.bdqn"},
  excludeFilters ={@ComponentScan.Filter(type =FilterType.ANNOTATION,
                                          value ={Controller.class})})publicclassSpringMainConfig{}

测试：测试代码同案例1

/**
    catMapper
    catServiceImpl
**/

1.3.3、案例3

需求：我现在只想扫描被@Controller所修饰的类注册到容器中，被其他修饰的注解不扫描。

说明：定义的CatController、CatServiceImpl、CatMapper不变，使用的是案例1。唯一要修改的配置是主配置文件类。为@ComponentScan注解添加includeFilters属性即可。

含义：includeFilters的作用指定扫描的时候只需要包含哪些组件。

做法：修改主配置类，即

@Configuration@ComponentScan(value ={"cn.bdqn"},
               includeFilters ={@ComponentScan.Filter(type =FilterType.ANNOTATION,
                                          value ={Controller.class,Service.class})})publicclassSpringMainConfig{}

测试：测试代码同案例1

/**
    catController
    catMapper
    catServiceImpl
    测试，发现，不仅仅Controller被扫描进来了，包括Service，Mapper也都扫描进来了，好像不起作用，没有生效，原因是在于在使用includeFilters做只包含的时候，还需要关闭默认的过滤规则【在默认情况下，Spring是扫描指定包及子包下的被@Component、@Controller、@Service等bean的。】
*/

主配置文件类修改如下：

@Configuration@ComponentScan(value ={"cn.bdqn"},
               includeFilters ={@ComponentScan.Filter(type =FilterType.ANNOTATION,
                                          value ={Controller.class,Service.class})},
               useDefaultFilters =false)publicclassSpringMainConfig{}

测试：

/**
    catController
    测试发现：结果正常，符合预期结果，只扫描到了Controller注解。
*/

1.4、Scope注解

​ 作用：可以改变bean的作用域。在Spring中，Bean的默认作用域是单例的。

1.4.1、定义Bean

publicclassUser{privateInteger id;privateString name;publicUser(Integer id,String name){this.id = id;this.name = name;}}

1.4.2、注册Bean并定义作用域

@ConfigurationpublicclassSpringMainConfig{@Bean@ScopepublicUseruser(){System.out.println("对象创建啦");returnnewUser(1,"HelloWorld");}}

1.4.3、测试

@TestpublicvoidtestComponentScan()throwsException{ApplicationContext ac =newAnnotationConfigApplicationContext(SpringMainConfig.class);}/**
    对象创建啦
*/

​ 结果：注册的Bean默认是单实例的，Spring容器将会在启动的时候调用方法创建对象后放入容器中，以后每次需要拿对象了就直接从容器中拿，而且每次拿的还是同一个。

1.4.4、将Bean的作用域改为多例

@ConfigurationpublicclassSpringMainConfig{@Bean@Scope("prototype")publicUseruser(){System.out.println("对象创建啦");returnnewUser(1,"HelloWorld");}}

1.4.5、测试1

@TestpublicvoidtestPrototype()throwsException{ApplicationContext ac =newAnnotationConfigApplicationContext(SpringMainConfig.class);}/**
    测试后发现容器启动的时候，多例对象并不会创建。
*/

1.4.6、测试2

@TestpublicvoidtestPrototype()throwsException{ApplicationContext ac =newAnnotationConfigApplicationContext(SpringMainConfig.class);User user01 =(User) ac.getBean("user");User user02 =(User) ac.getBean("user");}/**
    对象创建啦
    对象创建啦
*/

​ 总结：对于多实例来说，Spring容器在启动的时候并不会去调用方法创建对象并放在容器中，而是每次获取的时候才会调用方法创建对象，并且每次获取到的对象还不一样。

1.5、Lazy注解

作用：用此注解修饰的Bean表示的该Bean需要被懒加载，即不会随着Spring容器的启动而去创建。

1.5.1、注册Bean

@ConfigurationpublicclassSpringMainConfig{@Bean@Lazy(value =true)// 开启懒加载publicUseruser(){System.out.println("对象创建啦");returnnewUser(1,"HelloWorld");}}

1.5.2、测试

@TestpublicvoidtestSingleton()throwsException{ApplicationContext ac =newAnnotationConfigApplicationContext(SpringMainConfig.class);}/**
    控制台什么都没有输出，因为我们的Bean被Layz注解修饰了，即使Spring容器启动了，我们的Bean也不会去创建，只有等到了真正要用到该bean了才去创建。
*/

1.5.3、总结

• 这个Lazy注解是针对单实例Bean才有效，因为也只有单实例Bean才会默认在容器启动的时候创建对象。
• 懒加载：容器启动不创建对象，只有在第一次使用(获取)Bean的时候采取创建对象，并初始化。
• 该注解的作用等价于。

1.6、Conditional注解【了解】

作用： 根据一定的条件进行判断，当满足这个条件时给容器注入Bean。

==位置：==既可以修饰类也可以修饰方法。

==需求：==当前操作系统如果是window，则注入WindoBean，如果是linux系统，则注入LinuxBean。

首先查看下@Conditional注解的源代码，即：

public@interfaceConditional{// 该注解的属性值是一个Class类型的数组，数组的Class元素类型必须继承Condition接口，即元素的类型必// 须是Condition类型。Class<?extendsCondition>[]value();}

继续Condition接口的源代码：

publicinterfaceCondition{// 提供一个返回boolean值的方法，返回true则注入bean，false则不注入booleanmatches(ConditionContext context,AnnotatedTypeMetadata metadata);}

1.6.1、定义两个Bean

// Window的beanpublicclassWindowBean{privateString name;publicWindowBean(String name){this.name = name;}}

// Linux的BeanpublicclassLinuxBean{privateString name;publicLinuxBean(String name){this.name = name;}}

1.6.2、定义两个类实现Condition接口

// Window环境的条件publicclassWindowConditionimplementsCondition{// context：上下文环境publicbooleanmatches(ConditionContext context,AnnotatedTypeMetadata metadata){String osName = context.getEnvironment().getProperty("os.name");if(osName.contains("Windows")){returntrue;}returnfalse;}}

// Linux环境条件publicclassLinuxConditionimplementsCondition{@Overridepublicbooleanmatches(ConditionContext context,AnnotatedTypeMetadata metadata){String osName = context.getEnvironment().getProperty("os.name");if(osName.contains("linux")){returntrue;}returnfalse;}}

1.6.3、注册Bean

@ConfigurationpublicclassSpringMainConfig{// 如果当前环境是Winows环境则注入WindowBean@Bean@Conditional(value ={WindowCondition.class})publicWindowBeanwindowBean(){returnnewWindowBean("这个是window操作系统");}// 如果当前环境是Linux环境则注入LinuxBean@Bean@Conditional(value ={LinuxCondition.class})publicLinuxBeanlinuxBean(){returnnewLinuxBean("这个是Linux操作系统");}}

1.6.4、测试1

@TestpublicvoidtestBean()throwsException{ApplicationContext ac =newAnnotationConfigApplicationContext(SpringMainConfig.class);// 查看Spring容器中所有注册的BeanString[] names = ac.getBeanDefinitionNames();for(String name:names){System.out.println(name);}}/**
    windowBean
    由于现在是在window操作系统上测试，故仅仅注册了WindowBean。
*/

1.6.5、测试2

测试下如果程序运行在linux下，是否能够注入LinuxBean？测试过程，即：运行程序的时候手动的指定运行时参数信息，步骤如下：

测试后，发现，打印的结果是：LinuxBean。

1.6.6、总结

• 使用Conditional注解修饰在方法上，只有当条件满足的时候，即返回true，才会将所修饰的方法调用并且会创建Bean对象添加到容器中。
• 使用Conditional也可以修饰类，比如修饰主配置类，那么假如这个主配置类中定义了很多的Bean，如果该注解修饰了一个类，则只有条件满足的时候，即返回true，那么主配置类中所定义的Bean才会注册到容器中。即：@Conditional标注在类上就决定了该类中的一批bean是否能够注入。

1.7、Import注解

1.7.1、用法一

​ 简单来说，Import注解可以去修饰常规组件类，意思是：所谓的常规组件类就是一个普通的Java类， 而如果这个普通的Java类被@Import注解修饰，那么也可以将这个Java类注册到Spring容器中，成为Bean。

1.7.1.1、定义Bean

publicclassDog{}

1.7.1.2、注册Bean

@Configuration@Import(value ={Dog.class})publicclassSpringMainConfig{}

1.7.1.3、测试容器中是否有该Bean

@TestpublicvoidtestDogBean()throwsException{ApplicationContext ac =newAnnotationConfigApplicationContext(SpringMainConfig.class);// 查看Spring容器中所有注册的BeanString[] names = ac.getBeanDefinitionNames();for(String name:names){System.out.println(name);}}/**
    cn.bdqn.Dog
*/

1.7.1.4、注意

使用Import注解导入一个常规组件的时候，这个Bean的名称是类的全路径

1.7.2、用法二

​ 即Import可以导入被@Configuration注解所修饰的类，换句话说，Import注解可以去导入其他的配置类，存在的一个细节是：假如这个配置类里面也注册了多个Bean，那么同样也会将这些个Bean一并注册到Spring容器中。

1.7.2.1、定义Bean

// 奥迪publicclassAuDi{}

// 宝马publicclassBMW{}

1.7.2.2、新建配置类并注册Bean

// 针对系统中存在的车的一个配置类@ConfigurationpublicclassCar{@BeanpublicAuDiauDi(){returnnewAuDi();}@BeanpublicBMWbmw(){returnnewBMW();}}

1.7.2.3、Import导入配置类

@Configuration@Import(value ={Car.class})publicclassSpringMainConfig{}

1.7.2.4、测试容器有哪些Bean

​ 测试代码如同8.7.1.3，结果如下：

/**
    cn.bdqn.Car    ---> 配置类
    auDi        ---> 配置类中的奥迪Bean
    bmw            ---> 配置类中的宝马Bean
*/

1.7.2.5、总结

• 测试后发现，如果Import导入的是一个配置类，那么Spring会将这个配置类、以及配置类中定义的Bean都会注册到容器中。
• 同时，有Import注解修饰的那个配置类是主配置类，被Import注解导入的配置类也叫子配置类。例如用法二，SpringMainConfig这个配置类就是主配置类，Car这个配置类称之为子配置类。
• 这样做的好处：可以将不同功能、不同业务的Bean单独分开配置，而不是统一的都配置到一个配置类中，单独配置，结构清晰，功能划分的也很清楚。

1.8、PropertySource注解

==作用：可以设置properties文件的位置，这样的话，就可以通过Value注解读取配置文件的内容。==该注解的作用等同于：

<context:property-placeholderlocation="classpath:db.properties"/>

位置：该注解通常和@Configuration注解一起使用。

1.8.1、定义Pig.properties文件

id=1
name=丁春秋

1.8.2、主配置类

@Configuration// 主配置类@ComponentScan("cn.bdqn")// 扫描包，目的是能够扫描到Pig类@PropertySource(value ={"pig.properties"})//加载配置文件publicclassSpringMainConfig{}

1.8.3、测试

@TestpublicvoidtestPig()throwsException{ApplicationContext ac =newAnnotationConfigApplicationContext(SpringMainConfig.class);Pig pig =(Pig) ac.getBean("pig");System.out.println(pig);// 1,name}

好书推荐

《Java官方入门教程（第9版·Java 17）》

本书针对Java SE 17做了全面细致的更新，将引导你轻松学习最新的核心Java编程技能。开篇讲述基础知识，内容涉及如何创建、编译和运行Java程序。此后浓墨重彩地描述构成Java语言核心的关键字、语法和结构。本书还涵盖Java的一些更高级特性，如多线程编程、泛型、lambda表达式、模块、记录、密封类和Swing。另外，还介绍了Java的交互式编程工具JShell。本书通俗易懂、简明扼要、详略得当，成为全球数百万读者的选择。

作者简介

[美]赫伯特·希尔特(Herbert Schildt)
Herbert是Java语言领域的权威专家，拥有伊利诺伊大学的学士和硕士学位。被International Developer杂志评为“全球最著名的编程书籍创作者之一”“。他撰写的编程书籍在全球范围内销售了数百万册，已被翻译 成所有主要的非英语语言。他撰写了大量Java方面的书籍，包括Java: The Complete Reference、Herb Schildt’s Java Programming Cookbook、Introducing JavaFX 8 Programming和 Swing: A Beginner’s Guide。还撰写了许多关于C、C++和C#的图书。Ed Burns在Secrets of the Rock Star Programmers: Riding the IT Crest一书中将Herbert列为明星程序员。尽管对计算机的所有方面都感兴趣，但Herbert主要关注计算机语言。

购书链接：点此进入