11Spring IoC注解式开发(下)(负责注入的注解/全注解开发)

1负责注入的注解

负责注入的注解，常见的包括四个：

@Value
@Autowired
@Qualifier
@Resource

1.1 @Value

当属性的类型是简单类型时，可以使用@Value注解进行注入。
@Value注解可以出现在属性上、setter方法上、以及构造方法的形参上, 方便起见,一般直接作用在属性上.

package com.sunsplanter.bean;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Component
public class User {
    @Value(value = "zhangsan")
    private String name;
    @Value("20")
    private int age;

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
/*@Value和setter方法结合

    private String name;
    private int age;

    @Value("李四")
    public void setName(String name) {
        this.name = name;
    }

    @Value("30")
    public void setAge(int age) {
        this.age = age;
    }
*/

/*@Value和构造方法结合

    private String name;
    private int age;

    public User(@Value("隔壁老王") String name, @Value("33") int age) {
        this.name = name;
        this.age = age;
    }
*/
}

配置文件开启包扫描:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
                           http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
    <context:component-scan base-package="com.sunsplanter.bean"/>
</beans>

测试程序:

@Test
public void testValue(){
    ApplicationContext applicationContext = new ClassPathXmlApplicationContext("spring.xml");
    Object user = applicationContext.getBean("user");
    System.out.println(user);
}

三种方法都可以正确注入简单类型.

1.2 @Autowired与@Qualifier

@Autowired注解可以用来注入非简单类型。被翻译为：自动连线的，或者自动装配。
@Autowired注解可以出现在构造方法上/方法上/形参上/属性上/注解上
@Autowired注解有一个required属性，默认值是true，表示在注入的时候要求被注入的Bean必须是存在的，如果不存在则报错。如果required属性设置为false，表示注入的Bean存在或者不存在都没关系，存在的话就注入，不存在的话，也不报错。

目标: 存在两层: Service层和Dao层. 如前所述,UserService要控制UserDaoForMySQL, 必须要实例化一个UserDaoForMySQL的对象并注入到UserService类中定义的UserDaoForMySQL中.
配置Bean后Spring容器帮我们实例化了这个对象, 之前也学过了如何通过配置Bean标签注入. 本节的目标是通过注解完成自动注入.

结构为:
在这里插入图片描述

Dao层接口UserDao:

package com.dao;

public interface UserDao {
    void insert();
}

实现类UserDaoForMySQL:

package com.dao;

import org.springframework.stereotype.Repository;

@Repository //纳入bean管理
public class UserDaoForMySQL implements UserDao{
    @Override
    public void insert() {
        System.out.println("正在向mysql数据库插入User数据");
    }
}

Service层:

package com.Service;

import com.dao.UserDao;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service // 纳入bean管理
public class UserService {

    @Autowired // 在属性上注入
    private UserDao userDao;

    // 没有提供构造方法和setter方法。

    public void save(){
        userDao.insert();
    }

/* @Autowired和setter方法结合
private UserDao userDao;

    @Autowired
    public void setUserDao(UserDao userDao) {
        this.userDao = userDao;
    }

    public void save(){
        userDao.insert();
    }*/
    
    /*@Autowired和构造方法结合
    private UserDao userDao;

    public UserService(@Autowired UserDao userDao) {
        this.userDao = userDao;
    }

    public void save(){
        userDao.insert();
    }*/
}

配置文件开启包扫描:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
                           http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
    <context:component-scan base-package="com.dao,com.service"/>
</beans>

测试程序:

@Test
public void testAutowired(){
    ApplicationContext applicationContext = new ClassPathXmlApplicationContext("spring.xml");
    UserService userService = applicationContext.getBean("userService", UserService.class);
    userService.save();
}

单独使用@Autowired注解，默认根据类型装配【byType】。但之前也提到过,如果两个相同类型的类在同一包下,则系统分辨不出自动注解哪个bean, 例如:

两个bean类都实现了UserDao接口.无法分辨

解决办法:@Autowired注解和@Qualifier注解联合起来才可以根据名称进行装配，在@Qualifier注解中指定Bean名称。
将Service层代码增加一个@Qualifier注解,指定注入到userDaoForOracle:

private UserDao userDao;

    @Autowired
    @Qualifier("userDaoForOracle") // 这个是bean的名字。
    public void setUserDao(UserDao userDao) {
        this.userDao = userDao;
    }

1.3 @Resource

@Resource注解也可以完成非简单类型注入, 但与@AutoWired的区别如下
@Resource注解是JDK扩展包中的，也就是说属于JDK的一部分。所以该注解是标准注解，更加具有通用性。
@Autowired注解是Spring框架自己的。
@Resource注解默认根据名称装配byName，未指定name时，使用属性名作为name。通过name找不到的话会自动启动通过类型byType装配。
@Autowired注解默认根据类型装配byType，如果想根据名称装配，需要配合@Qualifier注解一起用。
@Resource注解用在属性上、setter方法上。
@Autowired注解用在属性上、setter方法上、构造方法上、构造方法参数上。
@Resource注解属于JDK扩展包，所以不在JDK当中，需要额外引入以下依赖：【如果是JDK8的话不需要额外引入依赖。高于JDK11或低于JDK8需要引入以下依赖。】

Spring6不再支持JavaEE，它支持的是JakartaEE9。（之前所接触的所有的 javax.* 包名统一修改为 jakarta.*包名了。）
若使用Spring6, 引入:

<dependency>
  <groupId>jakarta.annotation</groupId>
  <artifactId>jakarta.annotation-api</artifactId>
  <version>2.1.1</version>
</dependency>

使用:

UserDaoForOracle的名字为userDao，让这个Bean的名字和UserService类中的UserDao属性名一致：

package com.sunsplanter.dao;

import org.springframework.stereotype.Repository;

@Repository(value = "userDaoForOracle")
public class UserDaoForOracle implements UserDao{
    @Override
    public void insert() {
        System.out.println("正在向Oracle数据库插入User数据");
    }
}

package com.sunsplanter.service;

import com.sunsplanter.dao.UserDao;
import jakarta.annotation.Resource;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @Resource(name = "userDaoForOracle")
    private UserDao userDao;

    public void save(){
        userDao.insert();
    }
}

测试程序:

@Test
public void testResources(){
    ApplicationContext applicationContext = new ClassPathXmlApplicationContext("spring.xml");
    UserService userService = applicationContext.getBean("userService", UserService.class);
    userService.save();
}

以上代码使用Resource注解根据name(bean id)进行注入.Resource的的name(bean id为)userDaoForOracle,且注解写在UserDao头上.那么就去寻找一个名为userDaoForOracle的UserDao实现类进行注入.

2 全注解开发

尽管注解开发可以省略定义bean，但只能省略自定义的bean，若引入的是外部对象（如druid），此时依然要在xml中声明一个bean，由于此，不能完全消除配置xml文件的繁琐。

因此引入全注解开发（基于配置类的方式管理bean）
所谓的全注解开发就是不再使用spring配置文件spring.xml了。写一个配置类来代替配置文件. 其中配置类中使用
@configuration
@componentScan
等注解发挥spring.xml的作用

完全注解方式指的是去掉xml文件，使用配置类 + 注解实现
xml文件替换成使用@Configuration注解标记的类
标记IoC注解：@Component,@Service,@Controller,@Repository
标记DI注解：@Autowired @Qualifier @Resource @Value
<context:component-scan标签指定注解范围使用@ComponentScan(basePackages = {“com.atguigu.components”})替代
<context:property-placeholder引入外部配置文件使用@PropertySource({“classpath:application.properties”,“classpath:jdbc.properties”})替代
<bean 标签使用@Bean注解和方法实现
IoC具体容器实现选择AnnotationConfigApplicationContext对象

在这里插入图片描述
对于上例, 新增一个配置类代替spring.xml，至于Service层的代码完全不变：

package com.sunsplanter.config;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;

//标注当前类是配置类，替代spring.xml    
@Configuration
//使用注解读取外部配置，替代 <context:property-placeholder标签
@PropertySource("classpath:jdbc.properties")
//使用@ComponentScan注解,可以配置扫描包,替代<context:component-scan标签
@ComponentScan(basePackages = {"com.sunsplanter.service"})
public class Spring6Configuration {
    
}

@Test
public void testNoXml(){
// AnnotationConfigApplicationContext 根据配置类创建 IOC 容器对象
//ClassPathXmlApplicationContext根据路径中的xml文件创建IOC容器对象
    ApplicationContext applicationContext = new AnnotationConfigApplicationContext(Spring6Configuration.class);
    UserService userService = applicationContext.getBean("userService", UserService.class);
    userService.save();
}

在这里插入图片描述

2.1 将外部类纳入IoC容器管理

场景需求：将Druid连接池对象存储到IoC容器

需求分析：如开头所述：第三方jar包的类，添加到ioc容器，无法使用@Component等相关注解！因为源码jar包内容为只读模式！
思路：DataSource是JavaX中的一个接口，通过实现该接口来获取DataSource对象，将该方法声明为@Bean后，用value值注入创建datasource所需的各种属性。

package com.sunsplanter.config;

import com.alibaba.druid.pool.DruidDataSource;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;
import javax.sql.DataSource;

//标注当前类是配置类，替代application.xml
@Configuration
//引入jdbc.properties文件
@PropertySource({"classpath:jdbc.properties"})
@ComponentScan(basePackages = {"com.sunsplanter"})
public class MyConfiguration {

    //如果第三方类进行IoC管理,无法直接使用@Component相关注解
    //解决方案: xml方式可以使用<bean标签
    //解决方案: 配置类方式,可以使用方法返回值+@Bean注解
    //DataSource是JavaX中的一个接口，通过实现该接口来获取DataSource对象
    @Bean
    public DataSource createDataSource(@Value("${jdbc.user}") String username,
                                       @Value("${jdbc.password}")String password,
                                       @Value("${jdbc.url}")String url,
                                       @Value("${jdbc.driver}")String driverClassName){
        //使用Java代码实例化
        //new出一个Druid连接池对象
        DruidDataSource dataSource = new DruidDataSource();
        //给该对象填上数据库参数后返回，今后需要用从外部调用dataSource即可
        //set方法是DataSource接口中预定义的抽象方法
        dataSource.setUsername(username);
        dataSource.setPassword(password);
        dataSource.setUrl(url);
        dataSource.setDriverClassName(driverClassName);
        //返回结果即可
        return dataSource;
    }
}

2.2 @import注解

**场景1：**将外部类纳入IoC管理

正常情况下，定义一个普通对象类，我们在类上声明为@Bean，今后再编写一个配置类configuration.java,类中配置扫描包,即可自动寻找到所有Bean并自动注入.

然而,一些外部类原作者编写的时候并不可能按我们心意提前写好@Bean注解,并且如2.1所述, 一些写好的外部类根本不允许我们修改. 但我们却仍想将这些外部类纳入IoC容器管理.(即自动生成对象, 自动注入,生命周期管理…)

此时就要用到@import。

自定义一个类没有任何注解（模拟不能添加注解的外部类）

public class MyClass {
	
	public void test() {
		System.out.println("test方法");
	}
}

在配置类Configuration中 import这个myClass类

@configuration
@ComponentScan(basePackages = {"com.sunsplanter"})
public class Configuration{
@Import(MyClass.class)
public class Configuration {
}

测试程序为：

public void main（String[] args）{
	ApplicationContext applicationContext = new AnnotationConfigApplicationContext(Configuration.class);
	//我们已经首先根据配置类Configuration生成了上下文对象，并且在配置类我们声明了：外部类MyClass要纳入此上下文容器管理。
	//因此此时可以根据这个上下文对象getBean。
    MyClass myClass = applicationContext.getBean(MyClass.class);
    myClass.test();
}
}

情景2：存在多个配置类，简化生成上下文容器的流程

@Configuration
public class ConfigA {

  @Bean
  public A a() {
    return new A();
  }
}

@Configuration
@Import(ConfigA.class)
public class ConfigB {

  @Bean
  public B b() {
    return new B();
  }
}

现在，在实例化上下文时不需要同时指定 ConfigA.class 和 ConfigB.class ，只需显式提供 ConfigB ：

public static void main(String[] args) {
  ApplicationContext ctx = new AnnotationConfigApplicationContext(ConfigB.class);

  // now both beans A and B will be available...
  A a = ctx.getBean(A.class);
  B b = ctx.getBean(B.class);
}