Spring 常用注解

Configuration 配置类 相关注解

• @Configuration：标注在类上声明该类为 Spring 配置类

  Spring 在启动的时候会自动扫描并加载所有配置类配置 Spring 容器（应用上下文将配置类中的 Bean 放入容器管理

• @Bean：标注在 Spring 配置类中的方法上注册 bean 对象到 IOC 容器

  • name 属性：给生成的bean指定唯一标志

  在 Spring 容器启动的时候自动的扫描并执行所有配置了 @Bean 的方法并将返回值存入Spring容器

  注意：

  • 被标注的方法需要返回某个实例
  • 被标注的方法可以配置依赖的属性参数Spring 会自动从容器中获取到依赖的对象自动调用方法

• @Primary：在某些情况下需要注册多个相同类型的 bean此时可以使用 @Primary 来赋予某个 bean 更高的优先级

• @ComponentScan：开启包扫描（Spring IOC注解支持默认扫描当前包及子包下所有类

  • basePackage 属性：指定扫描的包路径。可以减少加载时间

  如果扫描到类上有 IOC 注解就会把当前类交给 IOC 容器管理当容器启动时自动创建对象存入容器

  如果扫描到属性上有 DI 注解则依据依赖注入的规则给属性注入值

• @PropertySource：加载本地 properties 文件交给 Spring 容器管理

  • value 属性：指定本地 properties 路径

• @Import：在一个配置类中导入其它配置类的内容

  • value 属性：指定其他的配置类的 class 类路径

  Spring 支持多配置类（配置类的模块若配置类臃肿可以拆分配置类然后在主配置类中引入子配置类（子配置类上不用配置注解

• @Conditional

  @Condition 是在 Spring 4.0 增加的条件判断功能通过这个可以功能可以实现选择性的创建 Bean 操作

  @Conditional 标注在配置类上或配置类的方法上和 @Configuration 配合使用@Conditional 指定的条件成立配置类里面的内容才生效

  SpringBoot常用条件注解：

  • @ConditionalOnBean：容器中存在指定Bean

  • @ConditionalOnMissingBean ：容器中不存在指定Bean

    • value 属性：作为条件的类的Class对象数组
    • type 属性：作为条件的类的 Name 数组（Class.getName()
    • annotation 属性：bean 上拥有指定的注解数组
    • name 属性：spring 容器中 bean 的名字

  • @ConditionalOnProperty：系统中指定的属性是否有指定的值

    • value / name 属性：配置名称完整名称或部分名称（name 与 value 不可同时使用

      可以与 prefix 配合使用

      可以传数组支持多个条件的组合（多个条件逻辑与

      若想使用多个条件逻辑或：

      • 方式1：使用 @ConditionalOnExpression 写“逻辑或”表达式

        @ConditionalOnExpression("${app.dictionary:false} || ${app.all:false}")
        

      • 方式2：使用 @ConditionalOnExpression 写“默认值”嵌套表达式

        @ConditionalOnExpression("${app.dictionary:${app.all:false}}")
        

    • prefix 属性：配置前缀（可有可无

    • havingValue 属性：对比值与 name 组合使用该值与配置中值相同则配置生效不相同则配置不生效

    • matchIfMissing 属性：缺少该配置属性时是否可以加载。

      缺少配置时 true: 正常加载false：报错。默认为 false

  • @ConditionalOnClass ：系统中有指定的类

  • @ConditionalOnMissingClass： 系统中没有指定的类

  • @ConditionalOnExpression ：满足SpEL表达式指定

  • @ConditionalOnSingleCandidate ：容器中只有一个指定的Bean或者这个Bean是首选Bean

  • @ConditionalOnResource ：类路径下是否存在指定资源文件

  • @ConditionalOnWebApplication ：当前是web环境

  • @ConditionalOnNotWebApplication ：当前不是web环境

  • @ConditionalOnJava：系统的java版本是否符合要求

IOC（容器相关注解

•  **@Controller**：一般标注在表现层（web层的类上
  

•  **@Service**： 一般标注在业务层（service层的类上
  

•  **@Repository**： 一般标注在持久层（dao层的类上
  

•  **@Component**：组件 非三层模式范围的类上使用
  

说明：

• 标注在想要被 IOC 容器管理的类上表明创建对象交给容器管理
• 当 Spring 容器启动时根据包扫描配置自动的扫描到 IOC 注解反射创建注解标注的对象存入容器委托容器管理
• 默认存入容器的 id（唯一标识为当前类名首字母小写。可以通过 value 属性自定义存入容器中对象的 id

@Import 注解：把类导入 Spring IOC容器

有多种方式能让类加 IOC容器管理如@Bean、@Component等@Import 是另外一种方式更加快捷。

支持三种方式：

• 带有 @Configuration 的配置类（4.2版本之前只可以导入配置类4.2版本之后 也可以导入普通类
• ImportSelector 的实现
• ImportBeanDefinitionRegistrar 的实现

主要用法：

• 直接填 class 数组方式

  @Configuration
  @Import({User.class})   // 大括号中可以添加多个类使用逗号分隔例如 {User.class,UserInfo.class}
  public class UserConfig {}
  

• ImportSelector 方式（Spring Boot 底层采用比较得多的方式

  // 自定义ImportSelector
  public class MyImportSelector implements ImportSelector {
      @Override
      public String[] selectImports(AnnotationMetadata importingClassMetadata) {
          // 返回的是需要加载的类名数组  注意这里需要的是类的全路径
          return new String[]{"com.itheima.redis.entity.User"};
      }
  }
  

  @Configuration
  @Import(MyImportSelector.class)
  public class UserConfig {}
  

• ImportBeanDefinitionRegistrar 方式

  这种方式和 ImportSelector 方式类似不过这种方式可以自定义Bean在容器中的名称

  // 自定义ImportBeanDefinitionRegistrar
  public class TestImportBeanDefinitionRegistrar implements ImportBeanDefinitionRegistrar {
      @Override
      public void registerBeanDefinitions(AnnotationMetadata annotationMetadata, BeanDefinitionRegistry registry) {
          RootBeanDefinition rootBeanDefinition = new RootBeanDefinition(TestD.class);
          //自定义注册bean
          registry.registerBeanDefinition("testD1111",rootBeanDefinition);
      }
  }
  

  @Import({TestImportBeanDefinitionRegistrar.class})
  @Configuration
  public class ImportConfig {}
  

• 注意：三种用法方式都可在一个@Import中使用需要注意的是class 数组方式、ImportSelector 方式在IOC容器中bean名称是类的全限定类名而ImportBeanDefinitionRegistrar 方式是自定义的名称

DI（依赖注入相关注解

DI 注解都相当于直接给属性赋值而无需借助于 set 方法或构造方法

• @Autowired

  使用方式1：标注在属性上

  • 直接给属性赋值（通过 @Autowired 依赖注入不需要配置 set 方法
  • 默认是通过 by Type（根据类型即接口类型的形式从 IOC 容器中查找对象并给属性注入值
  • 如果 IOC 容器中存在多个与属性同类型的对象（一个接口有多个实现类
    • 默认是按照属性名（by Name作为唯一标志从容器中查找对象并给属性注入值
    • 可以和 @Qualifier 注解共同使用指定唯一标志从容器中查找对象并给属性注入值
      • value：指定 IOC 容器中对象唯一标志（id

  使用方式2：标注在方法上

  • 表示自动执行当前方法如果方法有参数会自动从 IOC 容器中寻找同类型的对象给参数传值
  • 也可以在参数上添加 @Qualifier(“IOC容器中对象id”) 注解按照名称寻找对象给参数传值

  使用注意事项

  1. 只能在被 Spring 容器托管（标注了 @Controller 等 IOC 注解的类中使用 @Autowired 注解

  2. 自动注入与权限修饰符无关即使是 private 修饰的字段也可以自动注入

  3. 默认情况下使用 @Autowired 注解进行自动注入的属性一定要被装配（ Spring 容器托管

     如果在容器中找不到该类型的bean 进行注入就会报错

     如果允许不被装配可以将 @Autowired 的 required 属性为 false

  4. @Autowired 是基于类型的注入如果当前类型属性在容器中只有一个 Bean那么属性名不限制但一般建议遵循类名首字母小写的规则

  5. 如果当前属性类型在容器中有个多个Bean那么必须要通过属性名或者同时标注 @Qualifier 注解指定 Bean name

• @Qualifier：当有多个同一类型的 Bean 时可以用@Qualifier(“name”) 来指定。只能与@Autowired配合使用

• @value：可用于简单数据类型的注入但通常不这么使用。标注在属性上。

  一般用于解析 properties 配置文件或注册中心的配置文件中的内容

  • 根据 key 值获取对应的 value 语法规则： @Value(“${key}”)
  • 使用步骤：
    1. properties 配置文件交给 Spring 容器管理
    2. 通过 @Value从容器中得到配置项并注入

• @Reource（了解

  jdk 提供的依赖注入的注解此注解在 jdk9 及以上版本已经移除

  • 只能标注在被 Spring 容器托管的类的属性上
  • 表示先按照属性名匹配 IOC 容器中对象 id 给属性注入值【by name】
  • 若没有成功会继续根据当前属性的类型匹配 IOC 容器中同类型对象来注入值 【by type】
  • 若指定了 name 属性 @Resource(name = “对象id”)则只能按照对象 id 注入值

AOP（方法增强相关注解

• @EnableAspectJAutoProxy：标注在配置类上开启 aop 注解支持

• @Aspect：标注在自定义类上声明切面类

  注意：该切面类同时需要标注 IOC注解（@Component交给 Spring 容器管理

• 在切面类中的通知（增强方法上通过注解配置通知类型：

  • @Before：前置通知
  • @AfterReturning: 后置通知
  • @AfterThrowing：异常通知
  • @After：最终通知
  • @Around：环绕通知

  通知注解的属性：

  • value / argNames 属性：切入点表达式 或 被 @Pointcut 标注的方法名()

    	@Around("pt()")
        public Object around(ProceedingJoinPoint pjp)
    

• @Pointcut：标注在切面类中的空的方法上抽取公共的切入点表达式

  • value / argNames 属性：切入点表达式
  • 通知注解配置 方法名() 即可引入公共的切入点表达式

      @Pointcut(value="execution(* cn.test.service.impl.*.*(..))")
      public void pt() {}
  

事务管理 相关注解

• @EnableTransactionManagement：标注在配置类上开启事务注解支持

• @Transactional：配置事务

  常用属性：

  • rollbackFor 属性：设置需要进行回滚的异常类数组当方法中抛出指定异常数组中的异常时则进行事务回滚

    • 指定单一异常类：@Transactional(rollbackFor=Exception.class)

    • 指定多个异常类：@Transactional(rollbackFor={RuntimeException.class, Exception.class})

  • readOnly 属性：是否只读事务 （ true | false(默认值)

  • propagation 属性：事务传播行为 ( SUPPORTS | REQUIRED(默认值)

  • transactionManager 属性：多个事务管理器托管在 Spring 容器中时指定事务管理器的 bean 名称

  • isolation 属性：设置底层数据库的事务隔离级别事务隔离级别用于处理多事务并发的情况

    通常使用数据库的默认隔离级别即可基本不需要进行设置

  • noRollbackFor 属性：设置不需要进行回滚的异常类数组当方法中抛出指定异常数组中的异常时不进行事务回滚

  标注位置说明：

  • 标注在类上：该类中所有方法都具有相同的事务配置
  • 标注在方法上：该方法具有事务配置
  • 同时标注在类上和方法上：就近原则（方法上的事务配置生效

生命周期 相关注解

• @Scope ： 在类上配置对象的作用域

  通过 value 属性指定作用范围（singleton|prototype默认为 singleton（单例

• @PostConstruct ： 配置对象创建后的触发动作

  当对象创建完成之后自动执行的方法

• @PreDestroy ：配置对象销毁前的触发动作（仅在 Scope = singleton 时有效

  容器关闭对象销毁之前执行的方法

单元测试 相关注解

• @RunWith：设置单元测试的运行器通过 value 属性指定单元测试运行环境

  • SpringJUnit4ClassRunner.class：Spring 测试环境
  • SpringRunner.class：Spring 测试环境

  注：

  • SpringRunner extends SpringJUnit4ClassRunner.class

  • 使用上 JUnit4.12 或更高版本以上 SpringRunner、SpringJUnit4ClassRunner 都可以使用

    但是推荐使用 SpringRunnerfinal类型安全

  • JUnit4.12 以下版本就只能使用 SpringJUnit4ClassRunner

• @ContextConfiguration：指定容器的配置信息

  • localtions 属性：配置文件路径
  • classes 属性：配置类

异步调用 相关注解

• @EnableAsync：标注在启动类或配置类上使 @Async 注解生效

• @Async：标注在一个异步切入点方法上表示该方法异步调用

  此方法被调用时会从 Spring 自带的线程池中取一个线程执行这个方法而不是用 web 线程池中的线程这样 web 线程池中的线程就可以用来继续服务其他新的客户端请求

  注意：

  • 该方法所在类需被 Spring 容器管理

  • 所修饰的函数不要定义为 static 类型否则异步调用不会生效

  • 返回值：若不需要返回值直接void；需要返回值用 AsyncResult 或者 CompletableFuture

  • 可指定自定义执行器（线程池例如：@Async(“otherExecutor”)（通过 @bean 自定义一个线程池

    • 若在 Spring 中单独使用 @Async 注解必须指定执行器（即配置线程池否则会报错：

      org.springframework.aop.interceptor.AsyncExecutionAspectSupport getDefaultExecutor

    • 而在 SpringBoot 当中由于自动配置直接默认配置了一个 SimpleAsyncTaskExecutor 线程池

  • @Async 标注的方法必须是不同类间调用： A类 ==> B类.C方法()（@Async标注在B类的C方法上

    如果在同一个类中调用会变同步执行例如：A类.B() ==> A类.@Async C方法()

    原因是：底层实现是代理对注解扫描实现的B方法上没有注解没有生成相应的代理类。(当然把@Async加到类上也能解决但所有方法都异步了一般不这么用)

Spring MVC 常用注解

Controller 相关

• @RequestMapping：用于建立请求URL和处理方法之间的映射关系也可以通过它的属性对请求做出各种限制

  可标注在类、方法上若用于类上表示类中的所有响应请求的方法都是以该地址作为父路径。

  属性：

  • value / path 属性：指定映射的请求地址指定的地址可以是URI Template 模式
  • method 属性：指定请求的 method 类型 GET、POST、PUT、DELETE等示例：RequestMethod.post
  • params 属性：指定 request 中必须包含的参数若请求没有携带指定参数则抛出异常
  • headers 属性：指定 request 中必须包含某些指定的header值才能让该方法处理请求。
  • consumes 属性：指定处理请求的提交内容类型（Content-Type如application/json,text/html;
  • produces 属性：指定返回的内容类型仅当request请求头中的(Accept)类型中包含该指定类型才返回

• @RequestParam：标注在 Controller 方法参数之前用于对请求中 url 传入的普通参数做一些限制

  支持三个属性：

  • value / name 属性：默认属性用于绑定请求传入的参数名称。一般在请求传参和 Controller 方法入参不一致时使用
  • required 属性：用于指定此参数是否必传
    • @RequestParam 修饰的参数默认必须传值可以用 required = false 来指定非必传值
  • defaultValue 属性：指定参数默认值（当参数为非必传参数且请求没有传入该参数时使用默认值

  若不加 @RequestParam 注解：

  • 前端的参数名需要和后端控制器的变量名保持一致才能生效
  • 参数为非必传

• @PathVariable：映射 URL 绑定的占位符

  带占位符的 URL是 Spring3.0 新增的功能

  URL中的 {xxx} 占位符参数可以通过 @PathVariable(“xxx”) 绑定到控制器处理方法的入参中

  	@RequestMapping("/testPathVariable/{id}")
      public String testPathVariable(@PathVariable("id") Integer id)
      {
          System.out.println("testPathVariable:"+id);
          return SUCCESS;
      }
  

全局数据处理（@ControllerAdvice

• @ControllerAdvice：定义 Controller 层全局数据处理类。作用在注解了 @RequestMapping 的控制器方法上

  包含注解 @Component可以被扫描到

  一般和以下注解搭配使用

  • @ExceptionHandler（异常处理
  • @ModelAttribute（数据绑定
  • @InitBinder（数据预处理
  • **注意：**这三个注解都可以在普通的 Controller 类上使用ControllerAdvice只是作用范围可以自定义（默认全部

  支持属性：

  • value / basePackages 属性： 数组类型指定一个或多个包用来指定可以作用的基包

    即将对指定的包下面的 Controller 及其子包下面的 Controller 起作用

    若不指定默认所有被扫描的包

  • basePackageClasses 属性： 是 basePackages 的一种变形 数组类型指定一个或多个 Controller 类这些类所属的包及其子包下的所有 Controller 都被该 @ControllerAdvice 管理

  • assignableTypes 属性：数组类型用来指定具体的 Controller 类型它可以是一个共同的接口或父类等

  • annotations 属性： 指定一个或多个注解被这些注解所标记的 Controller 会被该 @ControllerAdvice 管理

• @RestControllerAdvice：定义 Controller 层全局数据处理类

  组合注解由注解 @ControllerAdvice、@ResponseBody 组成

• @ExceptionHandler：用于捕获 Controller 中抛出的不同类型的异常

  常与 @ControllerAdvice 注解搭配使用从而实现全局异常处理

• @ModelAttribute：被其标注的方法会在执行目标 Controller 方法之前执行

  常与 @ControllerAdvice 注解配合使用可以让全局的 @RequestMapping 方法都能获得在此处设置的键值对

• @InitBinder：用来设置 WebDataBinder进行请求数据预处理

Spring Boot 常用注解

• @SpringBootApplication：组合注解通常标注在启动类上

  • @Configuration：声明该类为 Spring 配置类把该类中定义的 Bean 加载到 Spring 容器中

  • @EnableAutoConfiguration：自动加载所有符合条件的 @Configuration 配置到当前 SpringBoot 环境

    例如：若添加了 spring-boot-starter-web 依赖由于其使用了 Tomcat 和 Spring MVC所以 auto-configuration 将假定正在开发一个 web应用并对 Spring 进行相应地设置。

  • @ComponentScan：开启包扫描（IOC注解支持默认扫描当前包及子包下所有类

    可以通过 basePackage 属性指定扫描的包路径以减少加载时间

• @SpringBootTest：配置文件属性的读取。在运行 SpringBoot 为基础的测试类上标注

  • 当定义没有特定的 @ContextConfiguration(loader=…) 时使用 SpringBootContextLoader 作为默认的 ContextLoader
  • 当不使用嵌套 @Configuration 时自动搜索@SpringBootConfiguration并且没有指定显式的类
  • 允许使用 properties 属性定义自定义环境属性
  • 为不同的webEnvironment模式提供支持包括启动一个完全运行的 web 服务器监听一个已定义的或随机的端口。
  • 注册一个 TestRestTemplate 或 WebTestClient bean用于在web测试中使用完全运行的web服务器

• @ConfigurationProperties：用于自动配置绑定

  支持属性：

  • value / prefix 属性：配置文件配置项的前缀
  • ignoreInvalidFields 属性：默认为 false值类型不匹配将会爆出异常
  • ignoreUnknownFields 属性：默认为 true忽略掉对象中未知的字段

  用法1：标注在类上转换配置文件配置项为 bean 对象

  • 注意：
    • 需要将标注了 @ConfigurationProperties 注解的类注册到spring容器中方式有两种：
      • 方式1：在标注了@ConfigurationProperties 注解的类上使用 @componet 等 IOC 注解
      • 方式2：在标注了@componet 等 IOC 注解的类上或配置类上标注 @EnableConfigurationProperties(bean类名.class)
    • 需要有无参构造方法、getter和setter方法

  @Data
  @AllArgsConstructor
  @NoArgsConstructor
  @Component
  @ConfigurationProperties(prefix = "app.mycar")
  public class Car {
      private int price;
      private String brand;
  }
  

  @Configuration
  @EnableConfigurationProperties(Car.class) 
  public class Config {
  }
  

  用法2：标注在配置类的方法上搭配 @bean 使用绑定第三方属性

  @Configuration
  public class DbConfig {
      @Bean
      @ConfigurationProperties(prefix = "spring.datasource.druid")
      public DataSource datasource(){
          return new DruidDataSource();
      }
  }
  

• @EnableConfigurationProperties：使 @ConfigurationProperties 注解生效并自动将这个类注入到 IOC 容器中

  标注在有 @componet 等 IOC 注解的类上或配置类上

  支持属性：

  • value 属性：Class<?>[] 数组即标注了 @ConfigurationProperties 注解的类的Class数组

Spring Cloud 常用注解

服务注册 / 服务发现 / 配置中心

• @EnableEurekaClient：开启使用服务注册和服务发现

  基于spring-cloud-netflix若选用的注册中心是 eureka推荐使用该注解

• @EnableDiscoveryClient：开启使用服务注册和服务发现

  基于spring-cloud-commons若是其他的注册中心推荐使用该注解

• @EnableEurekaServer：在启动类或配置类标注标识该服务为eureka服务端

• @EnableConfigServer：在启动类或配置类标注标识该服务为服务中心服务端

• @RefreshScope：标注在类上自动刷新从配置中心获取的数据

  只有添加此注解配置中心数据刷新时该类的对象会自动重新加载自动更新数据注入 @value

Feign 组件

• @EnableFeignClients：开启Feign注解。标注在启动类或配置类上

  项目启动时就会启动一个 FeignSterter 组件这个组件会对项目中使用 @FeignClient 的类创建代理对象

• @FeignClient：声明这是一个 Feign客户端同时通过 name / value 属性指定服务名称

  • 只能标注在远程服务调用的接口上

    （FeignClient注解被 @Target(ElementType.TYPE) 修饰表示 FeignClient 注解的作用目标在接口上

  • 当 SpringCloud 扫描到被 @FeignClient 标识的接口时底层会为其创建实现类代理对象（jdk代理并交给 spring容器管理（注册IOC容器；创建出来Bean对象的名字由注解的name或value属性指定若对同一个服务创建两个远端服务调用接口时会报错

  • 接口中定义的方法完全采用 SpringMVC 的注解Feign 会根据注解生成 URL并访问获取结果

  • 服务的启动类或配置类需要标注 @EnableFeignClients 注解才能使 Fegin 生效

  @FeignClient注解的常用属性如下：

  • name / value 属性：指定FeignClient的名称如果项目使用了Ribbon（注册中心name属性会作为微服务的名称用于服务发现

  • url 属性：一般用于调试可以手动指定@FeignClient调用的地址。默认为空

    • url可以从配置文件获取如果有则通过url调用没有则根据服务名调用。

      格式为 url = "${xxx.xxx.xxx: }"

  • configuration 属性：Feign配置类可以自定义 Feign 的 Encoder、Decoder、LogLevel、Contract可以为每一个feign client 指定不同的配置

  • fallback 属性：定义容错的处理类当调用远程接口失败或超时时会调用对应接口的容错逻辑fallback指定的类必须实现@FeignClient标记的接口

  • fallbackFactory 属性：工厂类用于生成fallback类示例通过这个属性可以实现每个接口通用的容错逻辑减少重复的代码

  • path 属性：定义当前FeignClient的统一前缀当项目中配置了server.context-path, server.servlet-path时使用

  • decode404 属性：当发生http 404错误时如果该字段位 true会调用 decoder 进行解码否则抛出 FeignException

其他注解

• @LoadBalanced：开启 Ribbon 负载均衡功能

  对 RestTemplate 添加一个LoadBalancerClient通过 Ribbon 以实现客户端负载均衡

  • 标注在 RestTemplate 对象上由 SpringCloud 的 commons 模块提供

  原理：当使用 RestTemplate 对象调用服务时系统底层会对服务进行拦截拦截到 url 后会基于 url 的服务名获取具体的服务实例然后基于服务实例重构 url再基于新的 url 进行服务调用

• @EnableCircuitBreaker：开启断路器功能

• @EnableHystrixDashboard：在启动类或配置类标注标识该服务为Hystrix-Dashboard服务（仪表盘监控服务器的流量

• @EnableTurbine：在启动类或配置类标注标识该服务为Turbine服务,同时监控多个服务器流量

• @EnableZuulProxy：在主启动类或配置类使用此注解,标识该服务为Zuul网关服务

lombok 常用注解

• @Data：注解在类上；提供 getter、setter 、equals、canEqual、hashCode、toString 方法

• @Setter：注解在属性上；为属性提供 setter 方法

• @Getter：注解在属性上；为属性提供 getter 方法

• @NoArgsConstructor：注解在类上；为类提供一个无参的构造方法

• @AllArgsConstructor：注解在类上；为类提供一个全参的构造方法

• @EqualsAndHashCode：实现 equals() 方法和 hashCode() 方法

• @ToString：实现 toString() 方法

• @Slf4j：注解在类上；为类提供一个 属性名为 log 的 log4j 日志对象

  slf4j 是一个适配器当应用更换了一个日志源后不需要更改代码

• @Log4j：注解在类上；为类提供一个 属性名为 log 的日志对象

  log4j是真正实现日志功能的产品

• @Cleanup：关闭流

• @Synchronized：对象同步

• @SneakyThrows：抛出异常