Annotation(annotation)은 프로그램을 통해 지정된 프로그램 요소의 Annotation 개체를 얻을 수 있는 인터페이스입니다. 그런 다음 Annotation 개체를 통해 주석의 메타데이터를 가져옵니다.
주석의 용도와 목적에 따라 주석을 시스템 주석, 메타 주석, 사용자 정의 주석의 세 가지 범주로 나눌 수 있습니다.
시스템 주석은 주로 @Override, @Deprecated, @SuppressWarnings를 포함하는 JDK 내장 주석입니다.
메소드 수정이란 해당 메소드가 상위 클래스의 메소드 또는 인터페이스를 구현하는 메소드를 오버라이드한다는 의미입니다
interface Demo{ public void print();
}public class Test implements Demo{
@Override
public void print() {
}
}사용되지 않는 메서드 수정
컴파일러 경고를 억제합니다. 즉, 경고를 제거합니다.
공통 매개변수 값은 다음과 같습니다.
| 名称 | 作用 |
|---|---|
| rawtypes | 表示传参时也要传递带泛型的参数 |
| deprecation | 使用了不赞成使用的类或方法时的警告 |
| unchecked | 执行了未检查的转换时的警告，例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型 |
| fallthrough | 当 Switch 程序块直接通往下一种情况而没有 Break 时的警告; |
| path | 在类路径、源文件路径等中有不存在的路径时的警告; |
| serial | 当在可序列化的类上缺少 serialVersionUID 定义时的警告; |
| finally | 任何 finally 子句不能正常完成时的警告; |
| all | 关于以上所有情况的警告。 |
예시는 다음과 같습니다.
// 抑制单类型@SuppressWarnings("unchecked")public void print() { @SuppressWarnings("rawtypes")
List list = new ArrayList();
list.add("a");
}// 抑制多类型@SuppressWarnings({ "unchecked", "rawtypes" })public void print() {
List list = new ArrayList();
list.add("a");
}// 抑制所有类型@SuppressWarnings({ "all" })public void print() {
List list = new ArrayList();
list.add("a");
}Meta-annotation 다른 주석을 추가하는 기능입니다. Java5.0은 다른 주석 유형에 대한 설명을 제공하는 데 사용되는 4가지 표준 메타 주석 유형을 정의합니다.
정의된 메타 주석은 @Target, @Retention, @Documented, @Inherited입니다.
@Target은 Annotation으로 수정되는 객체의 범위를 정의합니다. 구체적인 수정 범위는 다음과 같습니다.
public enum ElementType { // 用于描述类、接口(包括注解类型) 或enum声明
TYPE, // 用于描述域（即变量）
FIELD, // 用于描述方法
METHOD, // 用于描述参数
PARAMETER, // 用于描述构造器
CONSTRUCTOR, // 用于描述局部变量
LOCAL_VARIABLE, // 用于描述注解类型
ANNOTATION_TYPE, // 用于描述包
PACKAGE
}@Retention은 Annotation이 유지되는 기간, 즉 Annotation의 수명 주기를 나타냅니다.
public enum RetentionPolicy { // 在源文件中有效（编译器要丢弃的注解）
SOURCE, // class 文件中有效（默认，编译器将把注解记录在类文件中，但在运行时 VM 不需要保留注解）
CLASS, // 在运行时有效（编译器将把注解记录在类文件中，在运行时 VM 将保留注解，因此可以反射性地读取）
RUNTIME
}@Documented는 특정 유형의 주석이 javadoc 및 유사한 기본 도구를 통해 문서화됨을 나타내는 Annotation을 정의합니다.
유형 선언에 Documented라는 주석이 달린 경우 해당 주석은 주석이 달린 요소의 공개 API의 일부가 됩니다.
@Inherited는 주석 유형이 자동으로 상속됨을 나타내는 Annotation을 정의합니다. 즉, @Inherited로 수정된 주석 유형은 다음과 같습니다. A 클래스를 사용하면 이 주석은 이 클래스의 하위 클래스에 사용됩니다.
클래스 이외의 항목에 주석을 달기 위해 주석 유형을 사용하는 경우 @Inherited가 유효하지 않습니다.
이 메타 주석은 상위 클래스에서 주석 상속을 용이하게 할 뿐입니다. 구현된 인터페이스의 주석은 유효하지 않습니다.
@Inherited 주석 유형으로 주석이 달린 주석의 Retention이 RetentionPolicy.RUNTIME인 경우 리플렉션 API는 이 상속을 강화합니다. @Inherited 주석 유형의 주석을 쿼리하기 위해 java.lang.reflect를 사용하면 반사 코드 검사가 작동하기 시작합니다. 지정된 주석 유형을 찾을 때까지 클래스와 해당 상위 클래스를 확인하거나 클래스 상속 구조의 최상위 수준을 확인합니다.
에 도달했습니다. 예는 다음과 같습니다.
// 定义注解@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.TYPE)@Inherited@interface MyAnotation{
public String name();
}// 作用在类上@MyAnotation(name="parent")
class Parent{
}// 继承 Parent 类public class Test extends Parent{
public static void main(String[] args) {
Class<?> cls = Test.class; // 通过 @Inherited 继承父类的注解
Annotation annotation = cls.getAnnotation(MyAnotation.class);
MyAnotation myAnotation = (MyAnotation) annotation;
System.out.println(myAnotation.name());
}
}// 输出结果：parent（若注释掉注解，返回异常）// 定义注解@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.TYPE)@interface MyAnnotation {
public String name(); public String age();
}// 调用注解@MyAnnotation(name="cook",age="100")public class Test {
public static void main(String[] args) {
Class<?> cls = Test.class; // 1.取得所有注解
Annotation[] annotations =cls.getAnnotations(); // 2.取得指定注解
MyAnnotation annotation =
(MyAnnotation)cls.getAnnotation(MyAnnotation.class);
}
}// 定义注解@Retention(RetentionPolicy.RUNTIME)
// 修改作用范围@Target(ElementType.METHOD)@interface MyAnnotation { public String name(); public String age();
}
// 调用注解public class Test {
public static void main(String[] args) throws Exception {
Class cls = Test.class;
Method method = cls.getDeclaredMethod("print", null); // 1.取得所有注解
Annotation[] annotations = method.getDeclaredAnnotations(); // 2.取得指定注解
MyAnnotation annotation =
(MyAnnotation)method.getAnnotation(MyAnnotation.class);
}// 定义注解@Retention(RetentionPolicy.RUNTIME)
// 修改作用范围@Target(ElementType.PARAMETER)@interface MyAnnotation { public String name(); public String age();
}public class Test {
public static void main(String[] args) throws Exception {
Class cls = Test.class;
Method method = cls.getDeclaredMethod("print", new Class[]{String.class,String.class});
getAllAnnotations(method);
} // 作用在参数上
public void print(@MyAnnotation(name = "cook", age = "100")
String name, String age) { } public static void getAllAnnotations(Method method) {
Annotation[][] parameterAnnotions = method.getParameterAnnotations();
// 通过反射只能取得所有参数类型，不能取得指定参数
Class[] paraemterTypes = method.getParameterTypes();
int i = 0;
for (Annotation[] annotations : parameterAnnotions) {
Class paraemterType = paraemterTypes[i++];
for (Annotation annotation : annotations) {
if (annotation instanceof MyAnnotation) {
MyAnnotation myAnnotation = (MyAnnotation) annotation;
System.out.println(paraemterType.getName());
System.out.println(myAnnotation.name());
System.out.println(myAnnotation.age());
}
}
}
}
}// 定义注解@Retention(RetentionPolicy.RUNTIME)
// 修改作用范围@Target(ElementType.FIELD)@interface MyAnnotation { public String name(); public String age();
}public class Test {
// 作用在变量上
@MyAnnotation(name = "cook", age = "100")
private String name;
public static void main(String[] args) throws Exception {
Class cls = Test.class;
Field field = cls.getDeclaredField("name");
Annotation[] fieldAnnotions = field.getDeclaredAnnotations();
MyAnnotation annotation =
(MyAnnotation) field.getAnnotation(MyAnnotation.class);
}
} 위 내용은 09.Java Basics - Annotations 내용이며, 자세한 내용은 PHP 중국어 홈페이지(www.php)를 참고하시기 바랍니다. .cn)!
![[웹 프런트엔드] Node.js 빠른 시작](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
