Java项目的程序里为什么老用注解?注解有哪些作用

注解的英文名叫“Annotation”,是 Java 中给类、方法以及成员变量等元素增加元数据的方式。换言之注解就是用于描述这些元素的。

元数据一词从单词 metadata 译来,意为“描述数据的数据”。

注解和注释不同的是,注解会被 Java 编译器处理而非跳过。

注解是在JDK5.0版本开始引入的,它可以在编译期使用预编译工具进行处理, 也可以在运行期使用 Java 反射机制进行处理。注释可以用于创建 Javadoc,跟踪代码中的依赖性,甚至执行基本编译时检查。本质上,Annotion是一种特殊的接口,程序可以通过反射来获取指定程序元素的 Annotion 对象,通过 Annotion 对象来获取注解里面的元数据。

相比上来就给大家介绍注解的各种概念,它都有哪些作用外,我更希望把自己带入到一个 Java 小白的身份从零开始了解注解。我们通过“认识注解、使用注解”开始了解注解,随后带出 Java 原生自带的注解以及如何自定义注解,在编写自定义注解的时候顺便通过使用元注解把元注解的概念介绍一下,最后再来说注解都有哪些作用,以及使用注解带来的收益时需要付出什么代价。

本文内容大纲如下:

初识注解

Java 注解的简写形式如下:

@Entity
复制代码

@ 符号告诉编译器这是一个注解, @ 字符后面的名称是注解的名称。在上面的示例中,注解名称是 Entity。

注解还可以包含为其设置值的元素,类似注解的一个属性。下面是一个带元素的 PostMapping 注解示例。

@PostMapping(path = "/")
复制代码

上面的 PostMapping 注解包含一个名为 path 的元素,我们为其赋值为 "/"。设置元素值的语法是在注解名称后的括号内进行设置。

一个注解可以包含多个元素,比如 PostMapping 注解就可以通过consumes元素,指定接收的请求体的格式为application/json

@PostMapping(path = "/", consumes = MediaType.APPLICATION_JSON_VALUE)
复制代码

当然,PostMapping 注解能设置哪些元素的值,也是根据 PostMapping 注解的定义来的。

public @interface PostMapping {
    
    // 省略其他元素的定义......
    @AliasFor(
        annotation = RequestMapping.class
    )
    String[] path() default {};

    @AliasFor(
        annotation = RequestMapping.class
    )
    String[] consumes() default {};
    
    // ......

}

复制代码

如果注解只包含一个元素,那么按照约定惯例,会把该元素命名成“value”:

@InsertNew(value = "yes")
复制代码

当注解只包含一个名为 value 的元素时,使用注解时我们可以省略元素名称,只提供元素值。

@InsertNew("yes")
复制代码

使用注解

Java 的注解可以应用在类、接口、方法、方法的参数、成员变量和方法内的局部变量之上,比如在类上应用注解,就是把注解放在类声明之上。

@Ent
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值