点击关注公众号，回复面试获取优质资料

随着技术的更新迭代，Java5.0开始支持注解。而作为java中的领军框架Spring，自从更新了2.5版本之后也开始慢慢舍弃xml配置，更多使用注解来控制Spring框架。

而Spring的的注解那么多，可能做java很多年，都用不上。这里按照类型总结了这7种最常用的注解。

一. 核心注解

@Required
此注解用于bean的setter方法上。表示此属性是必须的，必须在配置阶段注入，否则会抛出BeanInitializationExcepion。

@Autowired
此注解用于bean的field、setter方法以及构造方法上，显式地声明依赖。根据type来autowiring。

当在field上使用此注解，并且使用属性来传递值时，Spring会自动把值赋给此field。也可以将此注解用于私有属性(不推荐)，如下。

@Component
public class User {
    @Autowired                               
    private Address address;                   
}

最经常的用法是将此注解用于settter上，这样可以在setter方法中添加自定义代码。如下：

@Component
public class User {
     private Address address;
     @AutoWired
   public setAddress(Address address) {
      // custom code
      this.address=address;
   }
}

当在构造方法上使用此注解的时候，需要注意的一点就是一个类中只允许有一个构造方法使用此注解。此外，在Spring4.3后，如果一个类仅仅只有一个构造方法，那么即使不使用此注解，那么Spring也会自动注入相关的bean。如下：

@Component
public class User {
    private Address address;
     public User(Address address) {       
        this.address=address;
     }
}
<bean id="user" class="xx.User"/>

@Qualifier
此注解是和@Autowired一起使用的。使用此注解可以让你对注入的过程有更多的控制。

@Qualifier可以被用在单个构造器或者方法的参数上。当上下文有几个相同类型的bean, 使用@Autowired则无法区分要绑定的bean，此时可以使用@Qualifier来指定名称。

@Component
public class User {
    @Autowired
    @Qualifier("address1")
    private Address address;
    ...
}

@Configuration
此注解用在class上来定义bean。其作用和xml配置文件相同，表示此bean是一个Spring配置。此外，此类可以使用@Bean注解来初始化定义bean。

@Configuartion
public class SpringCoreConfig {
    @Bean
    public AdminUser adminUser() {
        AdminUser adminUser = new AdminUser();
        return adminUser;
    }
}

@ComponentScan
此注解一般和@Configuration注解一起使用，指定Spring扫描注解的package。如果没有指定包，那么默认会扫描此配置类所在的package。

@Lazy
此注解使用在Spring的组件类上。默认的，Spring中Bean的依赖一开始就被创建和配置。如果想要延迟初始化一个bean，那么可以在此类上使用Lazy注解，表示此bean只有在第一次被使用的时候才会被创建和初始化。此注解也可以使用在被@Configuration注解的类上，表示其中所有被@Bean注解的方法都会延迟初始化。

@Value
此注解使用在字段、构造器参数和方法参数上。@Value可以指定属性取值的表达式，支持通过#{}使用SpringEL来取值，也支持使用${}来将属性来源中(Properties文件、本地环境变量、系统属性等)的值注入到bean的属性中。此注解值的注入发生在AutowiredAnnotationBeanPostProcessor类中。

二. Spring MVC和REST注解

@Controller
此注解使用在class上声明此类是一个Spring controller，是@Component注解的一种具体形式。

@RequestMapping
此注解可以用在class和method上，用来映射web请求到某一个handler类或者handler方法上。当此注解用在Class上时，就创造了一个基础url，其所有的方法上的@RequestMapping都是在此url之上的。

可以使用其method属性来限制请求匹配的http method。

@Controller
@RequestMapping("/users")
public class UserController {
    @RequestMapping(method = RequestMethod.GET)
    public String getUserList() {
        return "users";
    }
}

此外，Spring4.3之后引入了一系列@RequestMapping的变种。如下：

• @GetMapping

• @PostMapping

• @PutMapping

• @PatchMapping

• @DeleteMapping

分别对应了相应method的RequestMapping配置。

@CookieValue
此注解用在@RequestMapping声明的方法的参数上，可以把HTTP cookie中相应名称的cookie绑定上去。

@ReuestMapping("/cookieValue")
      public void getCookieValue(@CookieValue("JSESSIONID") String cookie){
}

cookie即http请求中name为JSESSIONID的cookie值。

@CrossOrigin
此注解用在class和method上用来支持跨域请求，是Spring 4.2后引入的。

@CrossOrigin(maxAge = 3600)
@RestController
@RequestMapping("/users")
public class AccountController {
    @CrossOrigin(origins = "http://xx.com")
    @RequestMapping("/login")
    public Result userLogin() {
        // ...
    }
}

@ExceptionHandler
此注解使用在方法级别，声明对Exception的处理逻辑。可以指定目标Exception。

@InitBinder
此注解使用在方法上，声明对WebDataBinder的初始化(绑定请求参数到JavaBean上的DataBinder)。在controller上使用此注解可以自定义请求参数的绑定。

@MatrixVariable
此注解使用在请求handler方法的参数上，Spring可以注入matrix url中相关的值。这里的矩阵变量可以出现在url中的任何地方，变量之间用;分隔。如下：

// GET /pets/42;q=11;r=22
@RequestMapping(value = "/pets/{petId}")
public void findPet(@PathVariable String petId, @MatrixVariable int q) {
    // petId == 42
    // q == 11
}

需要注意的是默认Spring mvc是不支持矩阵变量的，需要开启。

<mvc:annotation-driven enable-matrix-variables="true" />

注解配置则需要如下开启：

@Configuration
public class WebConfig extends WebMvcConfigurerAdapter {
    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
        UrlPathHelper urlPathHelper = new UrlPathHelper();
        urlPathHelper.setRemoveSemicolonContent(false);
        configurer.setUrlPathHelper(urlPathHelper);
    }
}

@PathVariable
此注解使用在请求handler方法的参数上。@RequestMapping可以定义动态路径，如:

@RequestMapping("/users/{uid}")

可以使用@PathVariable将路径中的参数绑定到请求方法参数上。

@RequestMapping("/users/{uid}")
public String execute(@PathVariable("uid") String uid){
}
@RequestAttribute

此注解用在请求handler方法的参数上，用于将web请求中的属性(request attributes，是服务器放入的属性值)绑定到方法参数上。

@RequestBody
此注解用在请求handler方法的参数上，用于将http请求的Body映射绑定到此参数上。HttpMessageConverter负责将对象转换为http请求。

@RequestHeader
此注解用在请求handler方法的参数上，用于将http请求头部的值绑定到参数上。

@RequestParam
此注解用在请求handler方法的参数上，用于将http请求参数的值绑定到参数上。

@RequestPart
此注解用在请求handler方法的参数上，用于将文件之类的multipart绑定到参数上。

@ResponseBody
此注解用在请求handler方法上。和@RequestBody作用类似，用于将方法的返回对象直接输出到http响应中。

@ResponseStatus
此注解用于方法和exception类上，声明此方法或者异常类返回的http状态码。可以在Controller上使用此注解，这样所有的@RequestMapping都会继承。

@ControllerAdvice
此注解用于class上。前面说过可以对每一个controller声明一个ExceptionMethod。这里可以使用@ControllerAdvice来声明一个类来统一对所有@RequestMapping方法来做@ExceptionHandler、@InitBinder以及@ModelAttribute处理。

@RestController
此注解用于class上，声明此controller返回的不是一个视图而是一个领域对象。其同时引入了@Controller和@ResponseBody两个注解。

@RestControllerAdvice
此注解用于class上，同时引入了@ControllerAdvice和@ResponseBody两个注解。

@SessionAttribute
此注解用于方法的参数上，用于将session中的属性绑定到参数。

@SessionAttributes
此注解用于type级别，用于将JavaBean对象存储到session中。一般和@ModelAttribute注解一起使用。如下：

@ModelAttribute("user")
public PUser getUser() {}
// controller和上面的代码在同一controller中
@Controller
@SeesionAttributes(value = "user", types = {
    User.class
})
public class UserController {}

三. Spring Boot注解

@EnableAutoConfiguration
此注解通常被用在主应用class上，告诉Spring Boot自动基于当前包添加Bean、对bean的属性进行设置等。

@SpringBootApplication
此注解用在Spring Boot项目的应用主类上（此类需要在base package中）。使用了此注解的类首先会让Spring Boot启动对base package以及其sub-pacakage下的类进行component scan。

此注解同时添加了以下几个注解：

• @Configuration

• @EnableAutoConfiguration

• @ComponentScan

四. Stereotype注解

@Component
此注解使用在class上来声明一个Spring组件(Bean), 将其加入到应用上下文中。

@Controller
前文已经提到过

@Service
此注解使用在class上，声明此类是一个服务类，执行业务逻辑、计算、调用内部api等。是@Component注解的一种具体形式。

@Repository
此类使用在class上声明此类用于访问数据库，一般作为DAO的角色。

此注解有自动翻译的特性，例如：当此种component抛出了一个异常，那么会有一个handler来处理此异常，无需使用try-catch块。

五. 数据访问注解

@Transactional
此注解使用在接口定义、接口中的方法、类定义或者类中的public方法上。需要注意的是此注解并不激活事务行为，它仅仅是一个元数据，会被一些运行时基础设施来消费。

六. 任务执行、调度注解

@Scheduled
此注解使用在方法上，声明此方法被定时调度。使用了此注解的方法返回类型需要是Void，并且不能接受任何参数。

@Scheduled(fixedDelay=1000)
public void schedule() {
}
@Scheduled(fixedRate=1000)
public void schedulg() { 
}

第二个与第一个不同之处在于其不会等待上一次的任务执行结束。

@Async
此注解使用在方法上，声明此方法会在一个单独的线程中执行。不同于Scheduled注解，此注解可以接受参数。

使用此注解的方法的返回类型可以是Void也可是返回值。但是返回值的类型必须是一个Future。

七. 测试注解

@ContextConfiguration
此注解使用在Class上，声明测试使用的配置文件，此外，也可以指定加载上下文的类。

此注解一般需要搭配SpringJUnit4ClassRunner使用。

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(classes = SpringCoreConfig.class)
public class UserServiceTest {
}

另外，自研博客内容持续在更新，已更新以下内容：

JUC源码分析：ConcurrentHashMap

JUC源码分析：ReentrantLock源码分析

JUC源码分析：AQS 设计原理

JUC源码分析：AQS源码分析

JUC源码分析：Condition 源码分析

JUC源码分析：ReadWriteLock源码分析

JUC源码分析：ArrayBlockingQueue源码分析

JUC源码分析：SynchronousQueue源码分析

JUC源码分析：FutureTask源码分析

JUC源码分析：CompletableFuture

JUC源码分析：Semaphore

JUC源码分析：CyclicBarrier

JUC源码分析：CountDownLatch

JUC源码分析：ThreadLocal源码分析

JUC源码分析：线程池源码分析

JUC源码分析：线程池的使用

JVM系列：关于类加载机制的五个核心点

JVM系列：JVM内存结构

JVM系列：GC算法和垃圾收集器的选择

JVM系列：常用命令详情

JVM系列：JVM GC 分析

JVM系列：JVM性能调优实战

JVM系列：JVM GC如何优化

JVM系列：JVM优化，2个案例

JDK源码分析：TreeMap

JDK源码分析：LinkedHashMap

JDK源码分析：HashSet

JDK源码分析：LinkedList

JDK源码分析：HashMap

JDK源码分析：ArrayList

JDK源码分析：String

JDK源码分析：Object

JDK源码分析：System

JDK源码分析：Integer

Spring源码分析：入门必读

Spring源码分析：启动流程

Spring源码分析：Bean生命周期

Spring源码分析：循环依赖

Spring源码分析：深入分析 DI

Spring源码分析：深入分析IOC

Spring源码分析：手写Spring框架之IOC

Spring源码分析：AOP基础知识

Spring源码分析：手写Spring框架之AOP

Spring源码分析：手写Spring框架之IOC之应用

Spring源码分析：Spring MVC核心知识

Spring源码分析：事务管理

Spring源码分析：手写Spring框架之事务管理

Spring源码分析：扩展点概览及实践

Spring源码分析：Spring MVC源码分析

Spring源码分析：Spring MVC 参数解析绑定原理

Spring源码分析：@Async注解

SpringCloud源码分析：微服务常识

SpringCloud源码分析：Eureka介绍和使用案例

SpringCloud源码分析：Eureke Server 初始化过程

SpringCloud源码分析：Eureke 服务注册过程

SpringCloud源码分析：Eureke服务下线

SpringCloud源码分析：Eureke server 集群

SpringCloud源码分析：如何设计一个注册中心

SpringBoot源码分析：共7篇

SpringBoot源码分析：核心原理

SpringBoot源码分析：启动流程

SpringBoot源码分析：启动时初始化数据

SpringBoot源码分析：自动装配

SpringBoot源码分析：自定义 Starter

SpringBoot源码分析：内置Tomcat(Servlet容器)源码分析

SpringBoot源码分析：Spring MVC实现源码分析

Java后端开发学习之路：应届生篇

Java后端开发学习之路：一年工作经验

Java后端开发学习之路：1~2年工作经验

Java后端开发学习之路：2~3年工作经验

Java后端开发学习之路：3~4年工作经验

Java后端开发学习之路：5年工作经验

Java程序员入门知识菜单

JavaWeb 基础知识菜单

Java程序员进阶知识菜单

Java程序员高阶知识菜单

性能调优：数据导入案例 

性能调优：线上JVM 问题排查记录案例

性能优化：SpringBoot 服务性能优化

性能调优：数据导入案例

性能调优：线上问题处理

性能调优：内存溢出案例

性能优化：实战-线上JVM优化

性能优化：单台4核8G机器支撑5万QPS

性能优化：实战-案例三

性能优化：衡量系统性能的6个指标

性能优化：造成系统瓶颈的七大原因

分布式技术：限流算法和代码实现

分布式技术：静态内部类实现雪花算法

分布式技术：负载均衡

分布式技术：缓存和数据库一致性问题

分布式技术：分布式锁

分布式技术：秒杀系统的技术难点

分布式技术：session一致性

分布式技术：保证分布式系统数据一致性的6种方案

以上文章只是博客的一部分，如何获取博客账号（白嫖勿扰），进入我的知识星球。

->《知识星球详情》