黑马程序员——注解

------ Java培训、Android培训、iOS培训、.Net培训、期待与您交流！ -------



 

了解和入门注解的应用

代码示例：

package cn.itcast.day2;

public class AnnottionTest2 {

    public staticvoidmain(String[] args) {

        System.runFinalizersOnExit(true);

    }

}

由上面的示例可以看到当执行一切过时的方法时，MyEclipse会自动划线，提示开发人员调用的方法已经过时，建议不要调用。

通过命令行进行编译也可以看到过时的提示，如下：

如果要看哪个方法已经过期，直接在编译时期加上详细信息重新编译。

 

@SuppressWarnings("deprecation")

此时，在main方法上添加一个注解：@SuppressWarnings("deprecation")，此注解的作用就是告诉编译器，虽然我用的方法过时了，但是我还是坚持要用，你就不要再提示了。

Java 5.0代码示例：

package cn.itcast.day2;

public class AnnottionTest2 {

    @SuppressWarnings("deprecation")

    public staticvoidmain(String[] args) {

        System.runFinalizersOnExit(true);

    }

}

再在命令行窗口中进行编译，就不会出现过时提示了。

@Deprecated

有时候我们写的方法被别人调用了，但是如果这个方法有一些Bug需要修改，可是如果我们修改了又会影响以前已经调用这个方法的程序。

这时候我们可以把这个方法设置为过时，然后重新写一个方法，这时候就需要用到@Deprecated注解。

Java 5.0代码示例：

package cn.itcast.day2;

public class AnnotionTest2 {

    public staticvoidmain(String[] args) {

        sayHello();

    }

    @Deprecated

    public staticvoidsayHello(){

        System.out.println("Hello 戒风");

    }

}

由上面的示例可以看到，我们的sayHello方法可以通过@Deprecated注解标记为过时，然后调用者调用该方法的地方就会被MyEclipse划上横线作为过时的提示。

@Override

有时候我们写的某些方法需要覆盖父类的方法，但是可能方法名或者参数会出现不小心写错的情况。

这时候就可以为这个方法打上@Override注解，如果有任何差错，MyEclipse就会报错。

例如：equals方法的参数为Object obj，但是经常会被写错，这时候就可以通过@Override注解避免这种情况。

Object 类

boolean

equals(Object obj) 指示其他某个对象是否与此对象“相等”。

Java 5.0代码示例：

@Override

    public booleanequals(Person obj) {

        if (this == obj)

            return true;

        return false;

    }

注意：

1、注解是JDK1.5的新特性。

2、一个注解就是一个类，使用注解，就相当于创建了一个类的实例对象。

3、注解相当于一种标记，在程序中加了注解就等于为程序打上了某种标记，没加，则等于没有某种标记。

以后，Javac编译器，开发工具和其他程序可以用反射来了解你的类及各种元素上有无何种标记，看你有什么标记，就去干相应的事。标记可以加在包，类，字段，方法，方法的参数以及局部变量上。

4、看Java.lang包，可看到JDK中提供的最基本的Annotation。

注解的应用结构图

 

注意：

注解就相当于一个你的源程序中要调用的一个类，要在源程序中应用某个注解，得先准备好了这个注解类。

就像你要调用某个类，得先有开发好这个类。

创建注解类步骤：在Java透视图下 File-->New-->Annotation

 

输入注解类名，点击Finish。完成。

Java 5.0 代码示例：

package com.itheima.day02;

//注解类

public @interface HeiMaAnnotation {

}

package com.itheima.day02;

// 应用注解类的类

@HeiMaAnnotation

public class AnnotationTest {

// 通过反射调用"应用了注解类"的类

    public staticvoidmain(String[] args) {

        boolean flag =

AnnotationTest.class.   isAnnotationPresent(HeiMaAnnotation.class);

        if (flag){

            HeiMaAnnotation heimaannotation =

AnnotationTest.class.getAnnotation(HeiMaAnnotation.class);

            System.out.println(heimaannotation);

        }

        System.out.println(flag);

    }

}

执行之后，控制台并返回false，原因是因为@HeiMaAnnotation注解的Retention元注解默认值是RetentionPolicy.CLASS，也就是说@HeiMaAnnotation注解在运行的时候已经被过滤掉了。解决这个问题的方式就是将@HeiMaAnnotation的RetentionPolicy元注解值设置为RetentionPolicy.RUNTIME。

package com.itheima.day02;

import java.lang.annotation.Retention;

import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.RUNTIME)

public @interface HeiMaAnnotation {

}

再次执行AnnotationTest.java，结果如下：

 

注意：元注解就是在注解上添加的注解。

@Retention元注解有三种取值：RetetionPolicy.SOURCE、RetetionPolicy.CLASS、RetetionPolicy.RUNTIME，分别对应：Java源文件-->class文件-->内存中的字节码。

思考：@Override、@SuppressWarnings和@Deprecated这三个注解的@Retention元注解的value属性值分别是什么？ source sourceruntime

Target的默认值为任何元素，设置Target等于ElementType.METHOD，原来加在类上的注解就报错了。

package com.itheima.day02;

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

importjava.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

@Retention(RetentionPolicy.RUNTIME)

//@Target(ElementType.METHOD)

@Target({ElementType.METHOD,ElementType.TYPE})

public @interface HeiMaAnnotation {

}

改为用数组方式设置{ElementType.METHOD,ElementType.TYPE}就不会报错了。

为注解增加各种属性什么是注解的属性

一个注解相当于一个胸牌，如果你胸前贴了胸牌，就是黑马的学生，否则，就不是。如果还想区分出是黑马哪个班的学生，这时候可以为胸牌再增加一个属性来进行区分。

加了属性的标记效果为：@HeiMaAnnotation(color="red")。

定义基本类型的属性和应用属性：在注解类中增加String color();

被添加的注解设置属性值：@HeiMaAnnotation(color="red")。

用反射方式获得注解对应的实例对象后，再通过该对象调用属性对应的方法

HeiMaAnnotation heimaannotation =

AnnotationTest.class.getAnnotation(HeiMaAnnotation.class);

System.out.println(heimaannotation.color());

可以认为上面这个@HeiMaAnnotation是HeiMaAnnotaion类的一个实例对象。

为属性指定缺省值：String color() default"Yellow";

value属性：String value() default "黑马程序员";

如果注解中有一个名称为value的属性，且你只想设置value属性（即其他属性都采用默认值或者你只有一个value属性），那么可以省略value=部分，例如：@HeiMaAnnotation("CSDN社区")。

数组类型的属性

int [] arrayAttr() default{1,2,3}; 被添加的注解设置属性值：

@HeiMaAnnotation(arrayAttr={2,3,4})。

如果数组属性中只有一个元素，这时候属性值部分可以省略大括号。

枚举类型的属性

Lamp lamp() ; 被添加的注解设置属性值：@HeiMaAnnotation(lamp=Lamp.GREEN)。

注解类型的属性：MetaAnnotation annotationAttr() default@MetaAnnotation("黑马程序员");

被添加的注解设置属性值：@HeiMaAnnotation(annotationAttr = @MetaAnnotation("CSDN社区") )

可以认为上面这个@HeiAnnotation是HeiMaAnnotaion类的一个实例对象，同样的道理，可以认为上面这

@MetaAnnotation是MetaAnnotation类的一个实例对象，调用代码如下：

MetaAnnotation ma =HeiMaAnnotation.annotationAttr();

System.out.println(ma.value());

package com.itheima.day02;

public enum Lamp {

    RED,YELLOW,GREEN;

}

package com.itheima.day02;

public @interface MetaAnnotation {

    String value();

}

package com.itheima.day02;

import java.lang.annotation.ElementType;

import java.lang.annotation.Retention;

importjava.lang.annotation.RetentionPolicy;

import java.lang.annotation.Target;

@Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.METHOD,ElementType.TYPE })

public @interface HeiMaAnnotation {

    String color() default "red";

    String value();

    int[] arrayAttr() default { 1, 2, 3 };

    Lamp lamp() default Lamp.RED;

    MetaAnnotation metaAnnotation() default @MetaAnnotation("黑马程序员");

    Classclazz() default String.class;

}

package com.itheima.day02;

@HeiMaAnnotation(metaAnnotation=@MetaAnnotation("黑马程序员"),

lamp=Lamp.GREEN,color="red",value="黑马论坛",arrayAttr={1,2,3})

public class AnnotationTest {

    @HeiMaAnnotation("CSDN社区")

    public staticvoidmain(String[] args) {

    boolean falg = AnnotationTest.class

    .isAnnotationPresent(HeiMaAnnotation.class);

    if (falg) {

        HeiMaAnnotation heimaannotation = AnnotationTest.class

        .getAnnotation(HeiMaAnnotation.class);

        MetaAnnotation annotation =heimaannotation.metaAnnotation();

        System.out.println(heimaannotation.color());

        System.out.println(heimaannotation.value());

        System.out.println(heimaannotation.arrayAttr().length);

        System.out.println(heimaannotation.lamp());

        System.out.println(annotation.value());

        System.out.println(heimaannotation.clazz());

        }

    }

}

/*注意：枚举的属性类型包括：基本数据类型，String，Class，枚举，其他注解，以及这些类型的数组。
*/