spring

1. 关于Spring

Spring框架主要解决了创建对象、管理对象的问题。

在传统的开发中，当需要某个对象时，使用new关键字及类型的构造方法即可创建对象，例如：

Random random = new Random();

如果以上代码存在于某个方法中。则random就只是个局部变量，当方法运行结束，此变量就会被销毁！

在实际项目开发，许多对象被创建出来之后，应该长期存在于内存中，而不应该销毁，当需要使用这些对象时，通过某种方式获取对象即可，而不应该重新创建对象！

除了对象存在的时间（时长）以外，在实际项目开发中，还需要关注各个类型之间的依赖关系！例如：

public class UserMapper {
    
    public void insert() {
        // 向数据表中的“用户表”中插入数据
    }
    
}

public class UserController {
    
    public UserMapper userMapper;
    
    public void reg() {
        userMapper.insert();
    }
    
}

在以上示例代码中，可视为“UserController是依赖于UserMapper的”，也可以把UserMapper称之为“UserController的依赖项”。

当需要创建以上类型时，如果只是单纯的把UserController创建出来了，却没有关注其内部userMapper属性的值，甚至该属性没有值，则是错误的做法！

如果要使得UserController中的UserMapper属性是有值的，也非常简单，例如：

public class UserController {
    
    public UserMapper userMapper = new UserMapper();
    
    public void reg() {
        userMapper.insert();
    }
    
}

但是，在实际项目中，除了UserController以外，还会有其它的组件也可能需要使用到UserMapper，如果每个组件中都使用new UserMapper()的语法来创建对象，就不能保证UserMapper对象的唯一性，就违背了设计初衷。

为了更好的创建对象和管理对象，应该使用Spring框架！

2. 创建基于Spring的工程

当某个项目需要使用Spring框架时，推荐使用Maven工程。

创建名为spring01的Maven工程，创建完成后，会自动打开pom.xml文件，首先，应该在此文件中添加<dependencies>节点，此节点是用于添加依赖项的：

<dependencies>

</dependencies>

然后，Spring框架的依赖项的代码需要编写在以上节点的子级，而依赖项的代码推荐从 https://mvnrepository.com/ 网站查询得到，Spring的依赖项名称是spring-context，则在此网站搜索该名称，以找到依赖项的代码，代码示例：

<!-- https://mvnrepository.com/artifact/org.springframework/spring-context -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>5.3.14</version>
</dependency>

将以上依赖项的代码复制到<dependencies>节点之下即可。

然后，点击IDEA中悬浮的刷新Maven的图标，或展开右侧的Maven面板点击刷新按钮，即可自动下载所需要的jar包文件（这些文件会被下载到本机的Maven仓库中，同一个依赖项的同一个版本只会下载一次）。

3. 通过Spring创建对象–通过@Bean方法

演示案例：spring01

操作步骤：

• 创建cn.tedu.spring.SpringBeanFactory类
• 在类中添加方法，方法的返回值类型就是你希望Spring创建并管理的对象的类型，并在此方法中自行编写返回有效对象的代码
• 在此类上添加@Configuration注解
• 在此方法上添加@Bean注解

以上步骤的示例代码：

package cn.tedu.spring;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.Random;

@Configuration
public class SpringBeanFactory {

    @Bean
    public Random random() {
        return new Random();
    }

}

接下来，创建某个类用于执行：

public class SpringRunner {

    public static void main(String[] args) {
        // 1. 加载Spring
        AnnotationConfigApplicationContext ac
                = new AnnotationConfigApplicationContext(SpringBeanFactory.class);

        // 2. 从Spring中获取对象
        Random random = (Random) ac.getBean("random");

        // 3. 测试使用对象，以便于观察是否获取到了有效的对象
        System.out.println("random > " + random);
        System.out.println("random.nextInt() > " + random.nextInt());

        // 4. 关闭
        ac.close();
    }

}

接下来，运行SpringRunner类的main()方法即可看到执行效果。

关于以上代码：

• 在AnnotationConfigApplicationContext的构造方法中，应该将SpringBeanFactory.class作为参数传入，否则就不会加载SpringBeanFactory类中内容
  • 其实，在以上案例中，SpringBeanFactory类上的@Configuration注解并不是必须的
• 在getBean()时，传入的字符串参数"random"是SpringBeanFactory类中的方法的名称
• 在SpringBeanFactory类中的方法必须添加@Bean注解，其作用是使得Spring框架自动调用此方法，并管理此方法返回的结果
• 关于getBean()方法，此方法被重载了多次，典型的有：
  • Object getBean(String beanName)
    • 通过此方法，传入的beanName必须是有效的，否则将导致NoSuchBeanDefinitionException
  • T getBean(Class<T> beanClass);
    • 使用此方法时，传入的类型在Spring中必须有且仅有1个对象，如果没有匹配类型的对象，将导致NoSuchBeanDefinitionException，如果有2个，将导致NoUniqueBeanDefinitionException
  • T getBean(String beanName, Class<T> beanClass)
    • 此方法仍是根据传入的beanName获取对象，并且根据传入的beanClass进行类型转换
• 使用的@Bean注解可以传入String类型的参数，如果传入，则此注解对应的方法的返回结果的beanName就是@Bean注解中传入的String参数值

4. 通过Spring创建对象–组件扫描

演示案例：spring02

先使用同样的步骤创建spring02工程。

操作步骤：

• 在pom.xml中添加spring-context的依赖项

• 自行创建某个类，例如创建cn.tedu.spring.UserMapper类，并在类的声明之前添加@Component注解

• 与前次案例相似，创建可执行的类，与前次案例的区别在于：

  • 在AnnotationConfigApplicationContext的构造方法中传入的是UserMapper类的包名，即：

    AnnotationConfigApplicationContext ac
        	= new AnnotationConfigApplicationContext("cn.tedu.spring");
    

  • 调用getBean()时，传入的名称是将UserMapper类的名称的首字母改为小写，即：

    UserMapper userMapper = ac.getBean("userMapper", UserMapper.class);
    

关于以上代码：

• 在创建AnnotationConfigApplicationContext时传入的参数是一个basePackages，即多个“根包”，它会使得Spring框架扫描这个包及其子孙包中的所有类，并尝试创建这些包中的组件的对象
  • AnnotationConfigApplicationContext的构造方法设计的是String...类型的参数，即可变参数，当需要输入多个包名时，各包名使用逗号隔开即可
  • 推荐传入的包名是更加具体的，但不需要特别精准，只需要保证不会扫描到非自定义的包即可，例如包名肯定不会包含项目的依赖项的包
• 即使有了组件扫描，Spring也不会直接创建包下所有类的对象，仅当类上添加了组件注解，才会被Spring视为“组件”，Spring才会创建对应的类的对象
• 当getBean()时，由Spring创建的组件类的对象，默认的名称都是将首字母改为小写
  • 以上规则仅适用于：类名中的第1个字母是大写，且第2个字母是小写的情况，如果类名不符合这种情况，则getBean()时传入的名称就是类名（与类名完全相同的字符串）

关于组件：

• 在Spring框架中，可用的组件注解有：
  • @Component：通用组件注解
  • @Controller：应该添加在“控制器类”上
  • @Service：应该添加在“业务类”上
  • @Repository：应该添加在“数据存取类”上
• 另外，@Configuration是一种特殊的组件，应该添加在“配置类”上，当执行组件扫描时，添加了@Configuration注解的类也会被创建对象

其它：

• 可以在@Component等组件注解（不包含@Configuration）中配置字符串参数，以显式的指定Bean的名称

• 可以使用一个配置类，在配置类上通过@ComponentScan来指定组件扫描的包，并在加载Spring时，传入此配置类即可，例如：

  package cn.tedu.spring;
  
  import org.springframework.context.annotation.ComponentScan;
  import org.springframework.context.annotation.Configuration;
  
  @Configuration
  @ComponentScan("cn.tedu.spring")
  public class SpringConfig {
  }
  

  // 以下是加载Spring的代码片段
  AnnotationConfigApplicationContext ac
  		= new AnnotationConfigApplicationContext(SpringConfig.class);
  

  在使用@ComponentScan时，也可以传入多个包名，例如：

  @ComponentScan({"cn.tedu.spring.controller", "cn.tedu.spring.service"})
  

5. 关于2种通过Spring创建对象的做法

以上分别介绍了使用@Bean方法和使用组件扫描的方式使得Spring创建对象的做法，在实际应用中：

• 使用@Bean方法可用在所有场景，但是使用过程相对繁琐
• 使用组件扫描的做法只适用于自定义的类型（这些类是你自己编写出来的），使用过程非常便捷

所以，当需要被Spring创建对象的类型是自定义的，应该使用组件扫描的做法，如果不是自定义的，只能使用@Bean方法。这2种做法在实际的项目开发中都会被使用到！

6. Spring管理的对象的作用域

由Spring管理的对象的作用域默认是单例的（并不是单例模式），对于同一个Bean，无论获取多少次，得到的都是同一个对象！如果希望某个被Spring管理的对象不是单例的，可以在类上添加@Scope("prototype")注解。

并且，在单例的情况下，默认不是懒加载的，还可以通过@Lazy注解控制它是否为懒加载模式！所谓的懒加载，就是“不要逼不得已不创建对象”。

7. Spring管理的对象的生命周期

由Spring创建并管理对象，则开发人员就没有了对象的控制权，无法对此对象的历程进行干预，而Spring允许在类中自定义最多2个方法，分别表示初始化方法和销毁方法，并且，Spring会在创建对象之后就执行初始化方法，在销毁对象之前执行销毁方法。

关于这2个方法，你可以按需添加，例如，当你只需要干预销毁过程时，你可以只定义销毁的方法，不需要定义初始化方法。

关于这2个方法的声明：

• 访问权限：推荐使用public
• 返回值类型：推荐使用void
• 方法名称：自定义
• 参数列表：推荐为空

然后，需要在初始化方法的声明之前添加@PostConstruct注解，在销毁方法的声明之前添加@PreDestroy注解。

例如：

package cn.tedu.spring;

import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Lazy;
import org.springframework.context.annotation.Scope;
import org.springframework.stereotype.Component;
import org.springframework.stereotype.Controller;
import org.springframework.stereotype.Repository;
import org.springframework.stereotype.Service;

import javax.annotation.PostConstruct;
import javax.annotation.PreDestroy;

@Component
public class UserMapper {

    public UserMapper() {
        System.out.println("\tUserMapper.UserMapper()");
    }

    @PostConstruct
    public void init() {
        System.out.println("\tUserMapper.init()");
    }

    @PreDestroy
    public void destroy() {
        System.out.println("\tUserMapper.destroy()");
    }

}

注意：仅当类的对象被Spring管理且是单例的，才有讨论生命周期的价值，否则，不讨论生命周期。

如果某个类的对象是通过@Bean方法被Spring管理的，并且这个类不是自定义的，可以在@Bean注解中配置initMethod和destroyMethod这2个属性（它们的值就是方法名称，例如destroyMethod="close"），将这个类中的方法指定为生命周期方法。

8. Spring的自动装配机制

Spring的自动装配机制表现为：当你需要某个对象时，可以使用特定的语法，而Spring就会尝试从容器找到合适的值，并赋值到对应的位置！

最典型的表现就是在类的属性上添加@Autowired注解，Spring就会尝试从容器中找到合适的值为这个属性赋值！

例如有如下代码：

SpringConfig.java

package cn.tedu.spring;

import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

@Configuration
@ComponentScan("cn.tedu.spring")
public class SpringConfig {
}

UserMapper.java

package cn.tedu.spring;

import org.springframework.stereotype.Repository;

@Repository
public class UserMapper {

    public void insert() {
        System.out.println("UserMapper.insert() >> 将用户数据写入到数据库中……");
    }

}

UserController.java

package cn.tedu.spring;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;

@Controller
public class UserController {

    @Autowired // 注意：此处使用了自动装配的注解
    private UserMapper userMapper;

    public void reg() {
        System.out.println("UserController.reg() >> 控制器即将执行用户注册……");
        userMapper.insert();
    }

}

SpringRunner.java

package cn.tedu.spring;

import org.springframework.context.annotation.AnnotationConfigApplicationContext;

public class SpringRunner {

    public static void main(String[] args) {
        // 1. 加载Spring
        AnnotationConfigApplicationContext ac
                = new AnnotationConfigApplicationContext(SpringConfig.class);

        // 2. 从Spring中获取对象
        UserController userController
                = ac.getBean("userController", UserController.class);

        // 3. 测试使用对象，以便于观察是否获取到了有效的对象
        userController.reg();

        // 4. 关闭
        ac.close();
    }
}

关于@Autowired的装配机制：

首先，会根据需要装配的数据的类型在Spring容器中查找匹配的Bean的数量，当数量为：

• 0个：判断@Autowired注解的required属性的值
  • 当required=true时：启动项目时即报告异常
  • 当required=false时：放弃自动装配，不会报告异常
• 1个：直接装配，且装配成功