第9章枚举&注解

最新推荐文章于 2021-06-26 09:17:48 发布

weixin_34176694

最新推荐文章于 2021-06-26 09:17:48 发布

阅读量539

点赞数 1

文章标签： java runtime python

原文链接：https://my.oschina.net/mondayer/blog/3027131

版权

2019独角兽企业重金招聘Python工程师标准>>>

枚举类

枚举类入门

JDK1.5之前需要自定义枚举类。
JDK 1.5 新增的 enum关键字用于定义枚举类。
若枚举只有一个成员, 则可以作为一种单例模式的实现方式。

枚举类的属性

枚举类对象的属性不应允许被改动。所以，应该使用private final修饰。

枚举类的使用private final修饰。修饰的属性应该在构造器中为其赋值。若枚举类显式的定义了带参数的构造器, 则在列出枚举值时也必须对应的传入参数。

Enum枚举类

必须在枚举类的第一行声明枚举类对象。
枚举类和普通类的区别：

使用enum定义的枚举类默认继承了java.lang.Enum类。枚举类的构造器只能使用 private 访问控制符。枚举类的所有实例必须在枚举类中显式列出(, 分隔; 结尾)。列出的实例系统会自动添加public static final修饰。

JDK 1.5中可以在switch表达式中使用Enum定义的枚举类的对象作为表达式，case子句可以直接使用枚举值的名字,无需添加枚举类作为限定。
枚举类的主要方法：

values()方法：返回枚举类型的对象数组。该方法可以很方便地遍历所有的枚举值。 valueOf(String str)：可以把一个字符串转为对应的枚举类对象。要求字符串必须是枚举类对象的“名字”。如不是会有运行时异常。

使用`Enum`定义的 Season

public enum Season {

    SPRING("春天", "春风又绿江南岸"),
    SUMMER("夏天", "映日荷花别样红"),
    AUTUMN("秋天", "秋水共长天一色"),
    WINTER("冬天", "窗含西岭千秋雪");

    private final String name;
    private final String desc;

    Season(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }

    public String getName() {
        return name;
    }

    public String getDesc() {
        return desc;
    }
}

枚举的方法

实现接口的枚举类

和普通 Java 类一样，枚举类可以实现一个或多个接口。
若需要每个枚举值在调用实现的接口方法呈现出不同的行为方式，则可以让每个枚举值分别来实现该方法。

注解Annotation

注解概述

从 JDK 5.0 开始，Java 增加了对元数据(MetaData) 的支持, 也就是 Annotation(注解)。
Annotation 其实就是代码里的特殊标记，这些标记可以在编译，类加载，运行时被读取，并执行相应的处理。通过使用Annotation，程序员可以在不改变原有逻辑的情况下，在源文件中嵌入一些补充信息。
Annotation 可以像修饰符一样被使用，可用于修饰包，类，构造器，方法，成员变量，参数，局部变量的声明，这些信息被保存在 Annotation 的 “name=value” 对中。
Annotation 能被用来为程序元素(类，方法，成员变量等) 设置元数据。

基本的 Annotation

使用Annotation时要在其前面增加**@符号**，并把该Annotation当成一个修饰符使用。用于修饰它支持的程序元素。
三个基本的 Annotation：

@Override：限定重写父类方法，该注释只能用于方法。 @Deprecated：用于表示某个程序元素(类, 方法等)已过时。 @SuppressWarnings：抑制编译器警告。

自定义 Annotation

定义新的 Annotation 类型使用 @interface 关键字。
Annotation 的成员变量在 Annotation 定义中以无参数方法的形式来声明。其方法名和返回值定义了该成员的名字和类型。
可以在定义 Annotation的成员变量时为其指定初始值，指定成员变量的初始值可使用 default 关键字。

public @interface MyAnnotation {
    String name() default "baidu";
}

没有成员定义的 Annotation 称为标记；包含成员变量的 Annotation 称为元数据 Annotation

提取 Annotation 信息

JDK 5.0 在 java.lang.reflect 包下新增了 AnnotatedElement接口，该接口代表程序中可以接受注解的程序元素。
当一个Annotation类型被定义为运行时Annotation后，该注释才是运行时可见，当 class 文件被载入时保存在 class 文件中的 Annotation 才会被虚拟机读取。
程序可以调用 AnnotationElement 对象的如下方法来访问 Annotation 信息。

JDK 的元 Annotation

JDK 的元 Annotation 用于修饰其他 Annotation 定义。
JDK5.0 提供了专门在注解上的注解类型，分别是：

@Retention @Target @Documented @Inherited

@Retention: 只能用于修饰一个 Annotation 定义，用于指定该 Annotation 可以保留多长时间，@Rentention 包含一个 RetentionPolicy 类型的成员变量，使用 @Rentention 时必须为该 value 成员变量指定值:

RetentionPolicy.SOURCE: 编译器直接丢弃这种策略的注释。 RetentionPolicy.CLASS: 编译器将把注释记录在 class 文件中. 当运行 Java 程序时, JVM 不会保留注解。这是默认值。 RetentionPolicy.RUNTIME:编译器将把注释记录在 class 文件中. 当运行 Java 程序时, JVM 会保留注释。程序可以通过反射获取该注释。

public enum RetentionPolicy{
	SOURCE,
	CLASS,
	RUNTIME
}

@Retention(RetentionPolicy.SOURCE)
@interface MyAnnotation1{}
@interface MyAnnotation2{}

@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation3{}

@Target: 用于修饰 Annotation 定义, 用于指定被修饰的 Annotation 能用于修饰哪些程序元素。@Target 也包含一个名为 value 的成员变量。
@Documented: 用于指定被该元 Annotation 修饰的 Annotation 类将被 javadoc 工具提取成文档。

定义为@Documented的注解必须设置@Retention值为RUNTIME。

@Inherited：被它修饰的Annotation将具有继承性。如果某个类使用了被@Inherited修饰的Annotation，则其子类将自动具有该注解。

实际应用中，使用较少。

练习

1.编写一个Person类，使用@Override注解它的toString()方法。

public class Person {
    private String name;
    public Person(String name) {
        this.name = name;
    }
    @Override
    public String toString() {
        return "Person{" +
                "name='" + name + '\'' +
                '}';
    }
}

2.自定义一个名为“MyTiger”的注解类型，它只可以使用在方法上，带一个String类型的value属性，然后在第1题中的Person类上正确使用。

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@interface MyTiger {
    String value() default "baidu";
}

public class Person {
    private String name;
    public Person(String name) {
        this.name = name;
    }
    @Override
    public String toString() {
        return "Person{" +
                "name='" + name + '\'' +
                '}';
    }

    @MyTiger(value = "google")
    public void eat() {
        //通过反射，取得 @MyTiger注解的 value值
        try {
            MyTiger anno = Person.class.getMethod("eat").getAnnotation(MyTiger.class);
            System.out.println(anno.value());
        } catch (Exception e) {
            e.printStackTrace();
        }
        System.out.println("我想吃包子");
    }

    public static void main(String[] args) {
        Person p = new Person("张三");
        System.out.println(p);
        p.eat();
    }
}

转载于:https://my.oschina.net/mondayer/blog/3027131