前言
注解(Annotation)不是程序,但可以对程序作出解释,也可以被其它程序(如编译器)读取。
注解的格式:以@注释名在代码中存在,还可以添加一些参数值例如@SuppressWarnings(value="unchecked")。
注解可在package、class、method、field等上面使用,作用是为它们添加了额外的辅助信息,从而可以通过反射机制实现对这些元数据的访问。
一、内置(常用)注解
1.1@Overrode
表示某方法旨在覆盖超类中的方法声明,该方法将覆盖或实现在超类中声明的方法。
1.2@RequestMapping
@RequestMapping注解的主要用途是将Web请求与请求处理类中的方法进行映射,注意有以下几个属性:
- value:映射的请求URL或者其别名
- value:映射的请求URL或者其别名
- params:根据HTTP参数的存在、缺省或值对请求进行过滤
1.3@RequestBody
@RequestBody在处理请求方法的参数列表中使用,它可以将请求主体中的参数绑定到一个对象中,请求主体参数是通过HttpMessageConverter传递的,根据请求主体中的参数名与对象的属性名进行匹配并绑定值。此外,还可以通过@Valid注解对请求主体中的参数进行校验。
1.4@GetMapping
@GetMapping注解用于处理HTTP GET请求,并将请求映射到具体的处理方法中。具体来说,@GetMapping是一个组合注解,它相当于是@RequestMapping(method=RequestMethod.GET)的快捷方式。
1.5@PathVariable
@PathVariable注解是将方法中的参数绑定到请求URI中的模板变量上。可以通过@RequestMapping注解来指定URI的模板变量,然后使用@PathVariable注解将方法中的参数绑定到模板变量上。
1.6@RequestParam
@RequestParam注解用于将方法的参数与Web请求的传递的参数进行绑定。使用@RequestParam可以轻松的访问HTTP请求参数的值。
1.7@ComponentScan
@ComponentScan注解用于配置Spring需要扫描的被组件注解注释的类所在的包。可以通过配置其basePackages属性或者value属性来配置需要扫描的包路径。value属性是basePackages的别名。
1.8@Component
@Component注解用于标注一个普通的组件类,它没有明确的业务范围,只是通知Spring被此注解的类需要被纳入到Spring Bean容器中并进行管理。
1.9@Service
@Service注解是@Component的一个延伸(特例),它用于标注业务逻辑类。与@Component注解一样,被此注解标注的类,会自动被Spring所管理。
1.10@Repository
@Repository注解也是@Component注解的延伸,与@Component注解一样,被此注解标注的类会被Spring自动管理起来,@Repository注解用于标注DAO层的数据持久化类。
二、元注解
4个元个元注解分别是:@Target、@Retention、@Documented、@Inherited 。
再次强调下元注解是java API提供,是专门用来定义注解的注解。
-
@Target
描述注解能够作用的位置,ElementType取值:
- ElementType.TYPE,可以作用于类上
- ElementType.METHOD,可以作用于方法上
- ElementType.FIELD,可以作用在成员变量上
-
@Retention
表示需要在什么级别保存该注释信息(生命周期):
RetentionPolicy.RUNTIME
:内存中的字节码,VM将在运行时也保留注解,因此可以通过反射机制读取注解的信息
-
@Documented
描述注解是否被抽取到api文档中。
-
@Inherited
描述注解是否被子类继承。
三、自定义注解
学习自定义注解对于理解Spring框架十分有好处,即使在实际项目中可能不需要使用自定义注解,但可以帮助我们掌握Spring的一些底层原理,从而提高对整体项目的把握。
/**
* 自定义注解
* @author Created by zhuzqc on 2022/5/31 23:03
*/
public class CustomAnnotation {
/**
* 注解中可以为参数赋值,如果没有默认值,那么必须为注解的参数赋值
* */
@