Java开发Spring常见注解

Java开发Spring常见注解

   前言

   Spring注解方式减少了配置文件内容，更加便于管理，并且使用注解可以大大提高了开发效率。 下面按照分类讲解Spring中常用的一些注解。

   一、声明bean的注解

   1. @Component

   一个通用的注解，用于标识任何 Spring 组件。标注Spring管理的Bean，使用@Component注解在一个类上，表示将此类标记为Spring容器中的一个Bean。

   示例代码如下：

@Component
public class CallBackAfterCreatePolicyProducer {
    @Resource
    private YpProducer ypProducer;
}

   说明：

   1）@Component （把普通pojo实例化到spring容器中，相当于配置文件中的<bean id="" class=""/>）

   2）@Component泛指组件，当组件不好归类的时候，我们可以使用这个注解进行标注。

   3）@Component是一个元注解，意思是可以注解其他类注解，如@Controller @Service @Repository @Aspect。官方的原话是：带此注解的类看为组件，当使用基于注解的配置和类路径扫描的时候，这些类就会被实例化。其他类级别的注解也可以被认定为是一种特殊类型的组件，比如@Repository @Aspect。所以，@Component可以注解其他类注解。

   2. @Service

   用于标识服务层组件，主要包含业务逻辑。

   组合注解（组合了@Component注解），应用在service层（业务逻辑层）

@Slf4j
@Service
@RequiredArgsConstructor(onConstructor_ = {@Autowired})
public class TppAgencyHttpProxyServiceImpl implements TppAgencyHttpProxyService {
}

   3. @Repository

   用于标识数据访问层组件，负责与数据库交互，并提供异常转换功能。

   组合注解（组合了@Component注解），应用在dao层（数据访问层）。

@Repository
public interface InsuranceAgreementMapper extends MPJBaseMapper<InsuranceAgreementDO> {

}

   4. @Mapper

   @Mapper注解是mybatis的注解，是用来说明这个是一个Mapper，对应的xxxMapper.xml就是来实现这个Mapper。然后再server层使用@Autowired注解引用进来，会出现这样的情况，但是并不影响使用。

   

   这是因为@Autowired是spring的注解，提示找不到相应的bean。如果有强迫症的同学，可以使用@Resource注解，因为这个是JDK的注解。

   

   二、注入bean的注解

   1. @Autowired

   @Autowired注解是Spring Framework提供的一种依赖注入方式。可以用于字段、方法和构造函数上，用于指定要注入的依赖。

   示例代码：

public class MyService {
    @Autowired
    private MyDependency dependency;
    // ...
}
```

    说明：@Autowired注解用于标记要注入的依赖。Spring会根据依赖的类型（或名称和限定符）自动查找匹配的Bean，并将其注入到目标对象中。

   2. @Resource

   @Resource注解是Java标准库提供的一种依赖注入方式。可以用于字段、方法和构造函数上，用于指定要注入的依赖。

public class MyService{
@Resource
private MyDependency dependency;
// ...
}

   说明：@Resource注解是Java标准库提供的一种依赖注入方式，在Spring中借助 CommonAnnotationBeanPostProcessor来实现。它可以用于标记要注入的依赖，并根据名称匹配规则或显式指定的名称来查找依赖。

   3. @RequiredArgsConstructor

   @RequiredArgsConstructor 是一个 Lombok 注解，用于自动生成一个带有所有必需参数的构造函数。这个注解可以用在类级别上，会生成一个构造函数，用于初始化被 @NonNull 或者 final 标记的成员变量。

   示例代码：

@Slf4j
@Service
@RequiredArgsConstructor(onConstructor_ = {@Autowired})
public class BrowseBizServiceImpl implements BrowseBizService {

    private final BrowseRpcProxyService browseRpcProxyService;

}  

   说明：Spring 提供了几种注入模式，一种是属性注入(Filed injection)，一种是通过 Setter 方法，一种是构造器注入。Spring 从 4.0 开始， 就不推荐使用属性注入模式了 ，原因是它可以让我们忽略掉一些代码可能变坏的隐患。

   所以，构造器的方法就成了我们的首选。但是使用构造器注入时，代码会很多。构造器注入通常结合private final字段来使用。使用Lombok的@RequiredArgsConstructor注解可以简化构造器的生成。

   4. @inject：JSR-330提供的注解。

   5. @Resource和@Autowired的区别

   1）区别一：所属不同。

   @Autowired 是 spring-beans 模块提供的注解。

   @Resource 是 JSR 250 规范提出的注解，由 JDK 自带。

   2）区别二：装配方式不同。两者都可以标注在属性或 setter 方法上。

   @Autowired 注解只能按照类型装配依赖，如果需要按照名称装配还需要指定 @Qualifier 注解。

   @Resource 默认依赖 bean 的名称为属性名，并且可以通过其属性 name 进行指定。默认依赖的 bean 的类型为属性的类型，并且可以通过 type 属性进行指定。 如果未指定依赖的 bean 的名称并且属性名对应的 bean 在容器中不存在时才会按照类型进行注入，否则按照名称进行注入依赖。（先按name再按type）

   3）区别三：是否强依赖不同。

   @Autowired 指定的依赖默认必须存在，可以通过 required 属性指定不存在。

   示例代码如下：

   @Autowired(required = false)
   private AdminInsuranceEventService adminInsuranceEventService;

   @Resource 指定的依赖必须存在。

   三、配置类相关注解

   1. @Configuration
   声明当前类为配置类，相当于xml形式的Spring配置

   示例代码如下：

@Configuration
@ComponentScan("com.yp")
public class SpringConfig {

}

   2. @Bean

   注解在方法上，声明当前方法的返回值为一个bean，替代xml中的方式

   Spring的@Bean注解用于告诉方法，产生一个Bean对象，然后这个Bean对象交给Spring管理。产生这个Bean对象的方法Spring只会调用一次，随后Spring将会将这个Bean对象放在自己的IOC容器中。

@Configuration
public class AppConfig {

      // 使用@Bean 注解表明myBean需要交给Spring进行管理
      // 未指定bean 的名称，默认采用的是 "方法名" + "首字母小写"的配置方式
    @Bean
    public MyBean myBean(){
        return new MyBean();
    }
}

public class MyBean {

    public MyBean(){
        System.out.println("MyBean Initializing");
    }
}

   3. @ComponentScan 

   配置组件扫描通常使用 @ComponentScan 注解。

   Spring 通过组件扫描机制自动检测并注册带有这些特定注解的类为 Spring Bean。

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

@Configuration
@ComponentScan(basePackages = "com.example")
public class AppConfig {
    // 其他配置
}

   比如：指定了spring扫描的包路径为：com.example，这将说明在此包下的所有spring识别的注解都会被解析

   四、切面（AOP）相关注解

   1. @Aspect
   声明一个切面（类上） 使用@After、@Before、@Around、@AfterReturning、@AfterwThrowing定义建言（advice），可直接将拦截规则（切点）作为参数。

   示例代码如下：

@Component
@Aspect
public class MyAspectjAdvice {

    @Pointcut("execution(* com.yp.dao.BookDao.*(..))")
    private void pt() {
    }

    /**
     * 前置通知
     */
    @Before("pt()")
    public void myBefore() {
        System.out.println("前置通知...");
    }

    /**
     * 后置通知
     */
    @After("pt()")
    public void myAfter() {
        System.out.println("后置通知...");
    }
}

   2. @PointCut： 声明切点   

   五、Spring MVC常用注解

   1.  @Controller

   用于标识控制器层组件，处理 HTTP 请求和响应。

   在使用 Spring MVC 框架开发 Web 应用程序时，@Controller 注解是用来标识一个类为控制器（Controller）的注解。控制器层负责接收用户请求，并根据请求处理逻辑选择合适的业务逻辑进行处理，最终返回响应给用户。

   示例代码如下：   

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/example")
public class ExampleController {

    @RequestMapping("/hello")
    @ResponseBody
    public String hello() {
   
        return "Hello, World!";
    }
}

   2. @RequestMapping

   @RequestMapping 注解是 Spring MVC 框架中的一个核心注解，用于将请求映射到相应的处理方法。

   示例代码如下：  

@Controller
@RequestMapping("/example")
public class ExampleController {
    @RequestMapping(value = "/hello", method = RequestMethod.GET)
    @ResponseBody
    public String hello() {
   
        return "Hello, World!";
    }
}

  除了@RequestMapping，还可以使用@PostMapping和@GetMapping。示例代码如下：

package com.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
@Controller
public class HelloWorldController {
    //只接受get方式的请求
    @GetMapping("/testGetMapping")
    public String testGetMapping(Model model) {
        model.addAttribute("msg","测试@GetMapping注解");
        return "success";
    }
    //只接受post方式的请求
    @PostMapping("/testPostMapping")
    public String testPostMapping(Model model) {
        model.addAttribute("msg","测试@PostMapping注解");
        return "success";
    }
}

  它可以用在类级别和方法级别上，具体作用如下：

  1) 类级别的 @RequestMapping： 用于指定该类中所有处理方法的公共请求路径前缀。当用户请求的 URL 匹配该前缀时，会进入该类中的处理方法进行处理。

  2) 方法级别的 @RequestMapping： 用于指定处理请求的方法和请求路径。当用户请求的 URL 匹配该路径时，会调用该方法进行处理。

  3.@RequestParam

  @RequestParam 注解用于将 HTTP 请求中的参数绑定到控制器方法的参数上，即获取请求中的参数值并映射到方法参数。它支持几乎所有的数据类型，包括基本数据类型和复杂数据类型。

  代码示例如下：

  假设我们有一个接口 /api/foos，它接受一个名为 id 的查询参数：

@GetMapping("/api/foos")
@ResponseBody
public String getFoos(@RequestParam String id) {
    return "ID: " + id;
} 

  通过 GET 请求来调用 getFoos：

  http://localhost:8080/spring-mvc-basics/api/foos?id=abc
  ----
  ID: abc

  4. @PathVariable

  @PathVariable 注解用于获取 URL 中的动态参数，即将 URL 中的变量映射到控制器方法的参数上。这样就可以通过 URL 传递参数，而不是通过查询字符串的方式来传递参数。

  示例代码如下：

@Controller
@RequestMapping("/example")
public class ExampleController {
   
  
    @RequestMapping(value = "/hello/{name}", method = RequestMethod.GET)
    @ResponseBody
    public String hello(@PathVariable("name") String name) {

        return "Hello, " + name + "!";
    }
}

  5.  @RequestBody

  @RequestBody 注解用于将 HTTP 请求体中的数据绑定到控制器方法的参数上，即获取 POST 请求中的数据并映射到方法参数。它通常用于处理 JSON 或 XML 格式的请求体数据。

  示例代码如下：

    @PostMapping(value = "/collaborate")
    public BeneficiaryCollaborateResp collaborate(@RequestBody @Valid BeneficiaryCollaborateReq req) {
         
            //...
    }

   6.  @ResponseBody

  @ResponseBody 注解用于将方法的返回值直接作为 HTTP 响应的内容，而不是通过视图解析器返回一个视图。它通常与 @RequestMapping 注解一起使用。

   7.  @RestController

   @RestController 是一个组合注解，它是 @Controller 和 @ResponseBody 两个注解的整合。它表示控制器类中的所有方法都会返回 JSON、XML 或其他格式的数据，而不是视图。

@RestController
@RequestMapping(value = "/insurance/v1/admin/event")
@RequiredArgsConstructor(onConstructor_ = {@Autowired})
public class AdminInsuranceEventController {
    private final AdminInsuranceEventService adminInsuranceEventService;

    @PostMapping(value = "/statistics")
    public AdminEventStatisticsResp eventStatistics(@RequestBody @Valid EventQueryReq req) {

        //...
    }
}

   8. @ModelAttribute
   @ModelAttribute 注解用于绑定请求参数到方法的参数或方法级别的模型属性上。

   9.  @SessionAttributes
   @SessionAttributes 注解是用于将模型属性暂时存储在会话（Session）中的注解。它可以用在控制器类级别或控制器方法级别。

   10.  @ExceptionHandler

   @ExceptionHandler 注解用于定义一个处理异常的方法。它可以用在控制器类级别或控制器方法级别。

   示例代码：

   在控制器类级别使用 @ExceptionHandler

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ModelAndView handleException(Exception e) {
     
        ModelAndView mv = new ModelAndView();
        mv.addObject("errMsg", "系统异常：" + e.getMessage());
        mv.setViewName("error");
        return mv;
    }
}

   六、@Enable*注解说明

   这些注解主要用来开启对xxx的支持。 

   1. @EnableAspectJAutoProxy：开启Spring对AspectJ自动代理的支持。

   示例代码如下：

@Configuration
@ComponentScan("com.yp")
@EnableAspectJAutoProxy
public class SpringConfig {

}

   @EnableAsync： 开启异步方法的支持。
   @EnableScheduling： 开启计划任务的支持。
   @EnableWebMvc ：开启Web MVC的配置支持。
   @EnableConfigurationProperties ：开启对@ConfigurationProperties注解配置Bean的支持。
   @EnableJpaRepositories：开启对SpringData JPA Repository的支持。
   @EnableTransactionManagement：开启注解式事务的支持。
   @EnableTransactionManagement： 开启注解式事务的支持。
   @EnableCaching： 开启注解式的缓存支持。

   七、常用的特殊注解

   1. @PostConstruct

   1）相关介绍

   从Java5开始引入的注解，指的是在项目启动的时候执行这个方法，也可以理解为在spring容器启动的时候执行，可作为一些数据的常规化加载，比如数据字典之类的。

   被@PostConstruct修饰的方法会在服务器加载Servlet的时候运行，并且只会被服务器执行一次。

   2）执行顺序

   通常我们会是在Spring框架中使用到@PostConstruct注解，该注解的方法在整个Bean初始化中的执行顺序：

   Constructor(构造方法) -> @Autowired(依赖注入) -> @PostConstruct(注释的方法)

   3）应用场景：
   如果想在生成对象时候完成某些初始化操作，而偏偏这些初始化操作又依赖于依赖注入，那么就无法在构造函数中实现。为此，可以使用@PostConstruct注解一个方法来完成初始化，@PostConstruct注解的方法将会在依赖注入完成后被自动调用。

   举个例子：

@Component
public class MyUtils {
 
    private static MyUtils staticInstance = new MyUtils();
 
    @Autowired
    private MyMethorClassService myService;
 
    @PostConstruct
    public void init(){
        staticInstance.myService = myService;
    }
 }

 

   参考链接：

   https://developer.aliyun.com/article/1357291

   https://cloud.tencent.com/developer/article/2350497