【SpringBoot】SpringBoot常用注解

简介: 【SpringBoot】SpringBoot常用注解

一、前言

首先这里说的SpringBoot常用注解是指在我们开发项目过程中,我们经常使用的注解,包含Spring、SpringBoot、SpringCloud、SpringMVC等这些框架中的注解,而不仅仅是SpringBoot中的注解。

这里只是作一个注解列举,每个注解具体如何使用可以自行搜索查询哈。

二、配置启动相关注解

2.1 @SpringBootApplication

等价于@Configuration、@EnableAutoConfiguration和@ComponentScan三个注解之和。

2.2 @Configuration

SpringBoot 提供基于Java的配置,相当于之前写的 xml中配置的Bean。

2.3 @EnableAutoConfiguration

类级别的注解,开启自动配置,这个注解告诉SpringBoot 根据添加的Jar 依赖猜测你想如何配置Spring。

2.4 @ComponentScan

标注哪些路径下的类需要被Spring扫描。

2.5 @Conditional

这个是一个综合的注解,包含了很多子注解。

@ConditionalOnBean:标注配置了某个特定的Bean

@ConditionalOnMissingBean:标注没有配置特定的Bean

@ConditionalOnClass:标注Classpath里有指定的类

@ConditionalOnMissingClass:标注Classpath里没有指定的类

@ConditionalOnExpression:标注给定的SpELl表达式计算结果为true

@ConditionalOnJava:标注Java的版本匹配特定值或者一个范围值

@ConditionalOnJndi:标注参数中给定的JNDI位置必须存在一个,如果没有给参数,则要有JNDI InitialContext

@ConditionalOnOnProperty:标注指定的配置属性要有一个明确的值

@ConditionalOnResource:标注Classpath里没有指定的资源

@ConditionalOnWebApplication:标注这是一个Web应用程序

@ConditionalOnNotWebApplication:标注这不是一个Web应用程序

三、Bean处理相关注解

3.1 依赖注入

@Autowired(属于Spring中的注解)

用法:用在属性和方法上。含义:byType方式完成自动装配,把配置好的Bean拿来用,完成属性、方法的组装。当加上(required=false)时就算找不到bean也不会报错。

@Resource(属于J2EE的注解)

用法:用在属性上。含义:byName方式完成自动装配,把配置好的Bean拿来用,完成属性的组装。有两个重要属性,分别是name和type。

3.2 标注类被Spring容器管理

@Component

泛指组件,当组件不好归类的时候,我们可以使用这个注解进行标注。一般公共方法即可用上这个注解。

@Respository

用于数据持久层,经常标记到DAO类上。

@Service

用于服务层,经常标注到Service类上,学需要注解DAO层。

@Controller

用于控制层,MVC的控制层Bean,常注入Service层。

@RestController

与@Controller注解相似,标注这是一个控制层。标注这个注解的类的控制器中会将所有处理器方法的返回值都要直接写入响应体中,而不是将值放到模型中并传递给一个视图以便于渲染。

替代写法:@RestController等同于@Controller+@Response。

@Configuration

一般用来声明配置类。

@Scope

声明Spring Bean的作用域:singleton、prototype、request、session。

四、HTTP请示相关注解

四种常见的HTTP请求类型如下:

4.1 @GetMapping

GET请求,从服务器获取指定的资源。

4.2 @PostMapping

POST请求,在服务器上创建一个新的资源。

4.3 @PutMapping

PUT请求,更新服务器上的资源。

4.4 @DeleteMapping

DELETE请求,从服务器上删除指定的资源。

这里先列出以上四个,其他的可以自行搜索哦。

五、前后端参数传递相关注解

5.1 @RequestParam

用在方法的参数前面,获取请求中表单类型的key=value格式的数据。

5.2 @PathVariable

路径变量,参数与大括号里的名字要一样。

5.3 @RequestBody

获取请求body中的数据,常用于搭配@PostMapping请求来提交的对象数据。

5.4 @ResponseBody

表示该方法的返回结果直接写入到了HTTP response body中了,格式为 json。

六、读取配置相关注解

6.1 @Value

直接读取各种配置源的属性值。

6.2 @ConfigurationProperties

读取配置信息并与bean绑定。

6.3 @PropertySource

指定加载自定义的配置文件。

七、参数校验相关注解

7.1 Bean字段验证注解

@NotEmpty

@NotBlank

@Null

@NotNull

@AssertTrue

@AssertFalse

@Pattern(regex=,flag=)

@Email

@Min(value)

@Max(value)

@Size

@DecimalMin

@DecimalMax

@Past

@Future

@Digits

7.2 @Valid

用于标注验证对象的级联属性。

7.3 Validated

Spring提供的注解,于SpringMVC一起使用,标注方法的参数需要检查。

八、统一异常处理相关注解

8.1 @ControllerAdvice

注解定义全局异常处理类,包含@Component,所以可以被Spring扫描到。

8.2 @ExceptionHandler

注解声明异常处理方法,表示遇到这个异常,就执行标注的方法。

九、JPA数据持久化相关注解

9.1 @Transactional

可以标注在类上,也可以标注在方法上。

标注在类上:表示所有该类的public方法都配置相同的事务属性信息。

标注在方法上:表示该方法配置了事务属性信息。当类和方法上同时标注上@Transactional注解,方法的事务会覆盖类的事务配置信息。

9.2 @Entity

声明数据库实体类。

9.3 @Table

声明表名。

9.4 @Id

声明该字段为主键。

9.5 @GeneratedValue

声明主键的生成策略。

9.6 @Column

声明字段,经常用于属性名和表字段的映射。

9.7 @Transient

指定不需要持久化的字段。

9.8 @Lob

声明该字段为大字段。

9.9 @Enumerated

声明该字段是枚举类型的字段。

9.10 @Modifying

加在DAO方法上,表明是修改操作。

十、JSON格式化处理相关注解

10.1 @JsonFormat

用来格式化json数据。

10.2 @JsonIgnoreProperties

作用在类上用于过滤掉特定字段不返回或者不解析。

10.3 @JsonIgnore

一般用于属性上,作用和上面的@JsonIgnoreProperties一样。

10.4 @JsonUnwrapped

声明该字段是扁平化对象。

十一、测试处理相关注解

11.1 @Test

声明一个方法为测试方法。

11.2 @Transactional

声明测试的方法数据会回滚,避免污染数据。

11.3 @ActiveProfiles

常作用于测试类上,用于声明生效的Spring配置文件

11.4 @WithMockUser

SpringSecurity提供的,用来模拟一个真实用户,并且可以赋予权限。

完结!


相关文章
|
1月前
|
XML Java 数据格式
SpringBoot入门(8) - 开发中还有哪些常用注解
SpringBoot入门(8) - 开发中还有哪些常用注解
50 0
|
2月前
|
Java Spring
在使用Spring的`@Value`注解注入属性值时,有一些特殊字符需要注意
【10月更文挑战第9天】在使用Spring的`@Value`注解注入属性值时,需注意一些特殊字符的正确处理方法,包括空格、引号、反斜杠、新行、制表符、逗号、大括号、$、百分号及其他特殊字符。通过适当包裹或转义,确保这些字符能被正确解析和注入。
129 3
|
23天前
|
前端开发 Java Spring
Spring MVC核心:深入理解@RequestMapping注解
在Spring MVC框架中,`@RequestMapping`注解是实现请求映射的核心,它将HTTP请求映射到控制器的处理方法上。本文将深入探讨`@RequestMapping`注解的各个方面,包括其注解的使用方法、如何与Spring MVC的其他组件协同工作,以及在实际开发中的应用案例。
37 4
|
1月前
|
XML JSON Java
SpringBoot必须掌握的常用注解!
SpringBoot必须掌握的常用注解!
62 4
SpringBoot必须掌握的常用注解!
|
23天前
|
前端开发 Java 开发者
Spring MVC中的请求映射:@RequestMapping注解深度解析
在Spring MVC框架中,`@RequestMapping`注解是实现请求映射的关键,它将HTTP请求映射到相应的处理器方法上。本文将深入探讨`@RequestMapping`注解的工作原理、使用方法以及最佳实践,为开发者提供一份详尽的技术干货。
69 2
|
23天前
|
前端开发 Java Spring
探索Spring MVC:@Controller注解的全面解析
在Spring MVC框架中,`@Controller`注解是构建Web应用程序的基石之一。它不仅简化了控制器的定义,还提供了一种优雅的方式来处理HTTP请求。本文将全面解析`@Controller`注解,包括其定义、用法、以及在Spring MVC中的作用。
40 2
|
27天前
|
消息中间件 Java 数据库
解密Spring Boot:深入理解条件装配与条件注解
Spring Boot中的条件装配与条件注解提供了强大的工具,使得应用程序可以根据不同的条件动态装配Bean,从而实现灵活的配置和管理。通过合理使用这些条件注解,开发者可以根据实际需求动态调整应用的行为,提升代码的可维护性和可扩展性。希望本文能够帮助你深入理解Spring Boot中的条件装配与条件注解,在实际开发中更好地应用这些功能。
32 2
|
27天前
|
JSON Java 数据格式
springboot常用注解
@RestController :修饰类,该控制器会返回Json数据 @RequestMapping(“/path”) :修饰类,该控制器的请求路径 @Autowired : 修饰属性,按照类型进行依赖注入 @PathVariable : 修饰参数,将路径值映射到参数上 @ResponseBody :修饰方法,该方法会返回Json数据 @RequestBody(需要使用Post提交方式) :修饰参数,将Json数据封装到对应参数中 @Controller@Service@Compont: 将类注册到ioc容器
|
28天前
|
XML Java 数据格式
SpringBoot入门(8) - 开发中还有哪些常用注解
SpringBoot入门(8) - 开发中还有哪些常用注解
38 2
|
2月前
|
XML Java 数据格式
Spring从入门到入土(bean的一些子标签及注解的使用)
本文详细介绍了Spring框架中Bean的创建和使用,包括使用XML配置文件中的标签和注解来创建和管理Bean,以及如何通过构造器、Setter方法和属性注入来配置Bean。
80 9
Spring从入门到入土(bean的一些子标签及注解的使用)