Java注解
Java注解是我们程序源代码的元数据(有关数据的数据)。
它们向编译器提供关于程序的附加信息,但不是程序本身的一部分。这些注解不会影响已编译程序的执行。
注解以@开头。其语法为:
@AnnotationName
让我们以@Override注解为例。
@Override注解指定了已标有此注解的方法重写用同样名称的方法,返回类型和参数列表中的父类的方法。
重写方法时,不是必须使用@Override。但是,如果我们使用它,编译器会在重写方法时,如果出现错误(比如错误的参数类型),就会给出一个错误。
注解格式
注解也可以包括元素(成员/属性/参数)。
1.标记注解
标记注解不包含成员/元素。它仅用于标记声明。
其语法为:
@AnnotationName()
由于这些注解不包含元素,因此不需要括号。例如,
@Override
2.单元素注解
单个元素注解仅包含一个元素。
其语法为:
@AnnotationName(elementName = "elementValue")
如果只有一个元素,则习惯上将该元素命名为value。
@AnnotationName(value = "elementValue")
在这种情况下,也可以移除元素名称。元素名称value默认为。
@AnnotationName("elementValue")
3.多元素注解
这些注解包含多个用逗号分隔的元素。
其语法为:
@AnnotationName(element1 = "value1", element2 = "value2")
注解位置
任何声明都可以通过将其放在声明上面来标记注解。从Java 8开始,注释也可以放在类型之前。
1.在声明语句上方
如上所述,Java注释可以放在类,方法,接口,字段和其他程序元素声明的上方。
示例2:@SuppressWarnings注释示例
import java.util.*;
class Main {
@SuppressWarnings("unchecked")
static void wordsList() {
ArrayList wordList = new ArrayList<>();
//这将导致未经检查的警告
wordList.add("nhooo");
System.out.println("Word list => " + wordList);
}
public static void main(String args[]) {
wordsList();
}
}
输出结果
Word list => [nhooo]
如果上述程序在不使用@SuppressWarnings("unchecked")注解的情况下进行编译,则编译器仍将编译该程序,但会给出如下警告:
Main.java uses unchecked or unsafe operations.
Word list => [nhooo]
我们收到警告
Main.java uses unchecked or unsafe operations
因为下面的语句。
ArrayList wordList = new ArrayList<>();
这是因为我们尚未定义数组列表的通用类型。 我们可以通过在尖括号<>中指定泛型来解决此警告。
ArrayList<String> wordList = new ArrayList<>();
2.类型注解
在Java 8之前,注释只能应用于声明。现在,也可以使用类型注释。这意味着我们可以在使用类型的任何地方放置注解。
构造函数调用
new @Readonly ArrayList<>()
类型定义
@NonNull String str;
此声明指定String类型的非空变量str,以避免NullPointerException。
@NonNull List<String> newList;
该声明指定String类型的非空列表。
List<@NonNull String> newList;
该声明指定String类型的非空值的列表。
类型转换
newStr = (@NonNull String) str;
extends 和 implements 子句
class Warning extends @Localized Message
throws 子句
public String readMethod() throws @Localized IOException
类型注释使Java代码可以得到更好的分析,并提供更强大的类型检查。
注解类型
1. 预定义的注解
@Deprecated
@Override
@SuppressWarnings
@SafeVarargs
@FunctionalInterface
2. 元注解
@Retention
@Documented
@Target
@Inherited
@Repeatable
注解的使用
编译器指令 - 可用于向编译器提供指令,检测错误或禁止警告。 如内置的注解@Deprecated,@Override, @SuppressWarnings。
编译时指令 - 这些批注提供的编译时指令帮助软件构建工具生成代码,XML文件等。文章来源:https://www.toymoban.com/news/detail-622425.html
运行时指令 - 可以定义一些注解以在运行时向程序提供指令。这些注解是使用Java 反射访问的。文章来源地址https://www.toymoban.com/news/detail-622425.html
到了这里,关于Java 注解(Annotations)的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!