>  기사  >  Java  >  09.Java 기초 - 주석

09.Java 기초 - 주석

黄舟
黄舟원래의
2017-02-27 10:38:121230검색

기본 개념

Annotation(annotation)은 프로그램을 통해 지정된 프로그램 요소의 Annotation 개체를 얻을 수 있는 인터페이스입니다. 그런 다음 Annotation 개체를 통해 주석의 메타데이터를 가져옵니다.

주석의 용도와 목적에 따라 주석을 시스템 주석, 메타 주석, 사용자 정의 주석의 세 가지 범주로 나눌 수 있습니다.


시스템 주석

시스템 주석은 주로 @Override, @Deprecated, @SuppressWarnings를 포함하는 JDK 내장 주석입니다.

1.@Override

메소드 수정이란 해당 메소드가 상위 클래스의 메소드 또는 인터페이스를 구현하는 메소드를 오버라이드한다는 의미입니다

interface Demo{    public void print();
}public class Test implements Demo{
    @Override
    public void print() {
    }
}

2.@사용 중단됨

사용되지 않는 메서드 수정

Alt text


3.@ SuppressWarnnings

컴파일러 경고를 억제합니다. 즉, 경고를 제거합니다.

공통 매개변수 값은 다음과 같습니다.

名称 作用
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입니다.


1.@Target

@Target은 Annotation으로 수정되는 객체의 범위를 정의합니다. 구체적인 수정 범위는 다음과 같습니다.

public enum ElementType {    // 用于描述类、接口(包括注解类型) 或enum声明
    TYPE,    // 用于描述域(即变量)
    FIELD,    // 用于描述方法
    METHOD,    // 用于描述参数
    PARAMETER,    // 用于描述构造器
    CONSTRUCTOR,    // 用于描述局部变量
    LOCAL_VARIABLE,    // 用于描述注解类型
    ANNOTATION_TYPE,    // 用于描述包
    PACKAGE
}

2.@Retention

@Retention은 Annotation이 유지되는 기간, 즉 Annotation의 수명 주기를 나타냅니다.

public enum RetentionPolicy {    // 在源文件中有效(编译器要丢弃的注解)
    SOURCE,    // class 文件中有效(默认,编译器将把注解记录在类文件中,但在运行时 VM 不需要保留注解)
    CLASS,    // 在运行时有效(编译器将把注解记录在类文件中,在运行时 VM 将保留注解,因此可以反射性地读取)
    RUNTIME
}

3.@Documented

@Documented는 특정 유형의 주석이 javadoc 및 유사한 기본 도구를 통해 문서화됨을 나타내는 Annotation을 정의합니다.

유형 선언에 Documented라는 주석이 달린 경우 해당 주석은 주석이 달린 요소의 공개 API의 일부가 됩니다.


4.@Inherited

@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(若注释掉注解,返回异常)

사용자 정의 주석

1.

// 定义注解@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);
    }
}

2. 메소드 주석

// 定义注解@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);
    }

3. 매개변수 주석

// 定义注解@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());
                }
            }
        }
    }
}

4. 변수 주석

// 定义注解@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)!


성명:
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.