其他分享
首页 > 其他分享> > 4-13 注解大全

4-13 注解大全

作者:互联网

注解大全

注解 解释
@Configuration 添加在类的声明之前,表示此类是配置类,会自动执行配置类中的@Bean方法,并解读配置类上的其它注解
@Bean 添加在配置类中用于创建对象的方法之前,使得Spring框架自动调用此方法,并管理此方法返回的结果,@Bean方法必须存在于@Configuration类中
@Component 组件注解,添加在类的声明之前,表示此类是组件类,是通用注解,应该添加在不是控制器类,也不是业务逻辑类,也不是数据访问类的类上
@ComponentScan 组件扫描,当加载到此注解时,Spring会扫描此注解配置的根包下是否存在组件类,如果存在,会自动创建组件类的对象,如果某些类不是组件,会被跳过(无视)
@Controller 组件注解,添加在类的声明之前,表示此类是组件类,应该添加在控制器类上
@Service 组件注解,添加在类的声明之前,表示此类是组件类,应该添加在业务逻辑类上
@Repository 组件注解,添加在类的声明之前,表示此类是组件类,应该添加在数据访问类上
@Scope 配置Spring Bean的作用域,当配置为@Scope("prototype")时,Spring Bean将是“非单例的”,如果使用@Bean方法创建对象,则此注解添加在@Bean方法之前,如果使用组件扫描创建对象,则此注解添加在组件类之前
@Lazy 配置单例的Spring Bean是否是“懒加载”的,当在@Bean方法之前,或在组件类的声明之前添加此注解,则会使得此Spring Bean是懒加载的,如果使用@Bean方法创建对象,则此注解添加在@Bean方法之前,如果使用组件扫描创建对象,则此注解添加在组件类之前
@Autowired 自动装配的注解,当某个属性需要被Spring装配值时,在属性之前添加此注解,另外,此注解可以添加在Setter方法、构造方法之前,通常不需要这样处理
@EnableWebMvc 添加在Spring MVC配置类上的注解,当响应正文,且响应的是JSON格式的结果时,必须添加此注解,否则将导致406错误,另外,在Spring Boot项目中不需要手动添加
@ResponseBody 响应正文,可添加在处理请求/处理异常的方法之前,将作用于对应的方法,或添加在类之前,将作用于类中所有处理请求/处理异常的方法
@RestController 等效于@Controller + @ResponseBody
@RequestMapping 通常添加在类上,用于配置请求路径的前缀部分,也使用produces属性配置此控制器类中所有处理请求的方法响应时的文档类型,例如在类上配置为@RequestMapping(value="user", produces="application/json; charset=utf-8")
@GetMapping 是将请求类型限制为GET的@RequestMapping,通常添加在处理请求的方法上,用于配置此方法映射的请求路径
@PostMapping 参考@GetMapping
@RequestParam 添加在处理请求的方法的参数之前,可用于:指定请求参数名称、配置是否必须提交此请求参数、配置请求参数的默认值
@PathVariable 添加在处理请求的方法的参数之前,仅当在请求路径中使用占位符匹配变量值时使用,如果占位符中的名称与方法参数名称不同,还可以配置此注解的参数,以指定占位符中的名称
@RequestBody 添加在处理请求的方法的参数之前,仅当客户端使用JSON格式组织请求参数时使用此注解,如果客户端的请求参数是FormData格式的(使用&拼接的),则不可以添加此注解
@ExceptionHandler 添加在处理异常的方法之前,可通过注解参数配置需要处理的异常类型
@ControllerAdvice 添加在类之前,此类中的代码在处理任何请求时都会生效
@RestControllerAdvice 等效于@ControllerAdvice + @ResponseBody
@Mapper 添加在使用Mybatis时访问数据的(每一个)接口上,使得Mybatis明确这是一个用于访问数据的接口,从而Mybatis会生成此接口的代理对象,实现最终的数据访问功能,但此方式不推荐,另见@MapperScan注解
@MapperScan 添加在配置类上,用于扫描使用Mybatis时的访问数据的接口所在的根包,使用此注解后,各接口不再需要使用@Mapper注解,在配置根包时,应保证此包下只有访问数据的接口,切不可存在其它接口,因为Mybatis并不会解析接口的内部代码,只要是接口都会创建代理对象,如果你自行创建类实现了此接口还被Spring创建了对象,会出现错误
@Param 添加在使用Mybatis时访问数据的接口中的抽象方法的参数上,用于指定参数名称,在配置SQL语句时使用占位符时,占位符内的名称就是此注解的参数值,当抽象方法的参数超过1个时,必须使用此注解配置参数名称
@SpringBootApplication 添加在Spring Boot项目中的启动类上的注解,每个Spring Boot只能有1个类添加此注解,此注解的元注解包括@SpringBootConfiguration和@ComponentScan,所以,启动类本身也是配置类,且默认就执行组件扫描
@SpringBootConfiguration 是@SpringBootApplication的元注解之一,此注解的元注解包括@Configuration,使得Spring Boot启动类是配置类
@SpringBootTest 添加在Spring Boot项目中测试类上的注解,使得测试类会加载当前项目中所有配置和环境,例如可以在测试类中使用自动装配机制、使用MockMvc(需添加spring-boot-starter-web依赖)等,如果某些测试类是明确的不需要加载当前项目的配置和环境时,可以不添加此注解
@AutoConfigureMockMvc 添加在Spring Boot项目中测试类上的注解,需添加spring-boot-starter-web依赖,当需要对控制器层使用MockMvc进行模拟测试时需要添加此注解,才可以在测试类中自动装配MockMvc对象
@Sql 可以添加在测试类上,也可以添加在测试类的测试方法,如果同时添加,以测试方法上的注解为准;可以在注解中配置参数,使得测试方法执行之前去执行指定的若干个SQL脚本,还可以配置脚本的执行阶段是在测试方法之前或测试方法之后
@Validated 添加在控制器类中处理请求的方法的参数之前,表示此参数将被Validation框架进行验证,具体的验证规则由其它的验证注解来决定
@Valid 在开发实践中,在绝大部分情况下与@Validated相同
@NotNull 验证注解,通常添加在被注解为@Validated/@Valid的类的属性上,表示不允许为null,可以配置message属性,用于指定验证失败时的提示文本
@Range 验证注解,通常添加在被注解为@Validated/@Valid的类的数值型属性上,可通过此注解的min和max属性配置数值型属性的取值区间,可以配置message属性,用于指定验证失败时的提示文本
@Pattern 验证注解,通常添加在被注解为@Validated/@Valid的类的字符串属性上,可通过此注解的regexp属性来指定正则表达式,将应用正则表达式对请求参数进行验证,可以配置message属性,用于指定验证失败时的提示文本
@JsonInclude 可以添加在POJO类上,也可以添加在POJO类的属性上,用于配置响应JSON结果时,什么样的属性会包含在响应结果中,默认值是JsonInclude.Include.ALWAYS,即始终包含,通常建议配置为JsonInclude.Include.NON_NULL,表示“值不为null时被包含在响应结果中”,此配置可以通过在配置文件中配置spring.jackson.default-property-inclusion属性实现全局的配置
@Data 添加在POJO类上的属性,使得Lombok会在编译期自动生成全属性的Settter & Getter、hashCode()、equals()、toString()方法
@Slf4j 添加在任意类上,在类中可以使用名为log变量输出日志

1.数据相关

1.1 Lombok

注解 注释
@Data set and get,equals,hashcode()
@Accessors(chain = true) 生成链式赋值的set方法
@AllArgsConstructor 自动生成包含全部参数的构造方法
@NoArgsConstructor 自动生成无参构造方法


1.2 SpringData

注解 注释
@Document 注解标记当前类和ES关联
indexName指定索引名称,我们这里叫items,当操作这个索引时,如果索引不存在,会自动创建
@Id SpingData标记这个字段为当前类主键
@Field SpringData使用@Field标记文档中属性的类型和各种特征
type = FieldType.Text, analyzer = "ik_max_word", searchAnalyzer = "ik_max_word"
type = FieldType.Keyword /Double , index = false


1.3 Spring Security

注解 注释
@PreAuthorize Controller层用户登录权限验证注解
@PreAuthorize("hasRole('ROLE_user')") - hasRole判断是专用于判断当前用户角色的指令
@PreAuthorize("hasRole('user')") - hasRole会自动在我们判断的内容前添加ROLE_
@PreAuthorize("hasAuthority('/pms/product/read')") 通用指令
@PreAuthorize("hasAuthority('ROLE_user')") 通用指令

1.4 Knife4j

注解 注释
@Api 作用于类
@ApiOperation 作用于方法
@ApiImplicitParam() 作用于单个参数
@ApiImplicitParams({@ApiImplicitParam()}) 作用于多个参数

1.5 Sentinel限流

注解 注释
@SentinelResource(value = "商品购买",blockHandler = "blockError",fallback = "fallBack") 限流,降级

1.6 Spring Aop

注解 注释
@Aspect 表示当前类不是普通类,是做切面功能的实现
@Pointcut 指定切面方法的注解
@Before 切面-->前置通知
@After 切面-->后置通知
@AfterThrowing 类似于spring的异常处理类,捕获


2.0 其他默认值参数注解

注解 注释
@RequestParam 参数注解, 提供默认参数
@Deprecated 弃用当前类

标签:13,Spring,配置,添加,参数,组件,注解,大全
来源: https://www.cnblogs.com/yzoran/p/16483722.html