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)!