枚举类与注解

一、枚举类

• 枚举类：类的对象为有限个，且确定
• 若枚举类只有一个对象，则可以作为一种单例模式的实现方式

1.1 枚举类的使用

1.1.1 自定义枚举类

jdk5.0之前

//自定义枚举类

class Season{
    //1、说明season对象的属性
    private final String seasonName;
    private final String seasonDesc;



    //2、私有化类的构造器,并给对象属性赋值
    private Season(String seasonName,String seasonDesc){
        this.seasonDesc = seasonDesc;
        this.seasonName = seasonName;
    }


    //3、提供枚举类的多个对象；public static final
    public static final Season SPRING = new Season("Spring","from 2 to 4");
    public static final Season SUMMER = new Season("Summer","from 5 to 7");
    public static final Season AUTUMN = new Season("Autumn","from 8 to 10");
    public static final Season WINTER = new Season("Winter","from 11 to 1");

    //4、重写toString()


    @Override
    public String toString() {
        return "Season{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

1.1.2 使用关键字 enum 定义枚举类

jdk 5.0
定义的枚举类默认继承于java.lang.Enum类

//使用enum关键字定义枚举类

enum Season1{


    //1、提供枚举类的多个对象，多个对象之间用，隔开
    SPRING ("Spring","from 2 to 4"),
    SUMMER ("Summer","from 5 to 7"),
    AUTUMN ("Autumn","from 8 to 10"),
    WINTER ("Winter","from 11 to 1");

    //2、说明season对象的属性
    private final String seasonName;
    private final String seasonDesc;



    //3
    // 、私有化类的构造器,并给对象属性赋值
    private Season1(String seasonName,String seasonDesc){
        this.seasonDesc = seasonDesc;
        this.seasonName = seasonName;
    }



    //4、重写toString()


    @Override
    public String toString() {
        return "Season{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

1.1.3 Enum的常用方法

toString ：返回当前常量名称

        Season1 season1 = Season1.SPRING;
        System.out.println(season1);

输出：

SPRING

values : 返回枚举类型的对象数组。该方法可以很方便地遍历所有的枚举值

//查看线程枚举类的所有状态
        Thread.State[] values1 = Thread.State.values();

        for (int i = 0; i < values1.length; i++) {
            System.out.println(values1[i]);
        }

输出：

NEW
RUNNABLE
BLOCKED
WAITING
TIMED_WAITING
TERMINATED

valueOf(String str):把一个字符串转为对应的枚举类对象。要求字符串必须是枚举类对象的对象名,没有对应的对象则抛异常

        //valueOf(String objName)
        Season1 winter = Season1.valueOf("WINTER");
        System.out.println(winter);
        Season1 season = Season1.valueOf("SEASON");
        System.out.println(season);

输出

WINTER
Exception in thread "main" java.lang.IllegalArgumentException: No enum constant test.Season1.SEASON
	at java.lang.Enum.valueOf(Enum.java:238)
	at test.Season1.valueOf(EnumTest.java:36)
	at test.EnumTest.main(EnumTest.java:27)

1.1.4 实现接口的枚举类

• ① 情况一：实现接口，在enum类中重写抽象方法（一般情况）
• ②情况二：让枚举类对象分别实现接口中的抽象方法

//接口
interface Info{
    void show();
}

//枚举类·
//使用enum关键字定义实现接口的枚举类
enum Season1 implements  Info{


    //1、提供枚举类的多个对象，多个对象之间用，隔开
    //保证每个对象实现的show方法不同，所以让每个对象都是去实现重写方法
    SPRING ("Spring","from 2 to 4"){
        @Override
        public void show() {

        }
    },
    SUMMER ("Summer","from 5 to 7"){
        @Override
        public void show() {

        }
    },
    AUTUMN ("Autumn","from 8 to 10"){
        @Override
        public void show() {

        }
    },
    WINTER ("Winter","from 11 to 1"){
        @Override
        public void show() {

        }
    };

    //2、说明season对象的属性
    private final String seasonName;
    private final String seasonDesc;



    //3
    // 、私有化类的构造器,并给对象属性赋值
    private Season1(String seasonName,String seasonDesc){
        this.seasonDesc = seasonDesc;
        this.seasonName = seasonName;
    }



    //4、重写toString()


/*    @Override
    public String toString() {
        return "Season{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }*/


}

二、注解(Annotation)

2.1 注解概述

注解就是代码里的特殊标记，可以在编译、类加载、运行时被读取、并执行相应的处理

2.2 三个基本注解

@Override :限定重写父类，不加注解就不会在编译的时候进行校验
@Deprecate: 已经过时的不建议使用的方法
@SuppressWarning :抑制编译器警告

2.3自定义注解

//①注解声明为:@interface
public @interface MyAnnotation {

//② 内部定义成员，通常使用value表式；
    //String[] value();

    //③ 可指定成员的默认值，使用default定义
    String[] value() default "hello";

    //④ 自定义的注解没有成员，表明是一个标识作用，如:Override
}


@MyAnnotation(value = "hello")
class Man{

}

如果注解有成员，在使用注解时，需要指明成员的值
*自定义注解必须配上注解的信息处理流程（使用反射）才有意义

2.4 元注解

定义： 用于修饰其他注解的注解
例：修饰Override的元注解

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}

Rtention :指定所修饰的 Annotation 的生命周期：SOURCE\CALSS（默认）\RUNTIME (只有声明为RUNTIME生命周期的注解，才能通过反射获取)
Target :指定被修饰的 Annotation 能用于修饰哪些元素 ，包含一个名为value 的成员变量
Documented : 所修饰的注解，在被javadoc解析时，保留下来
Inherited : 修饰的 Annotation 具有继承性

2.5 jdk8 注解新特性：可重复注解、类型注解

可重复注解——jdk8之前的写法

@interface MyAnnotations{
    MyAnnotation [] value();
}

@MyAnnotations({@MyAnnotation(value = "hello"),@MyAnnotation (value = "hi")})
class Man{

}

新写法

• ① 在 MyAnnotation 上生声明 @Repeatable ，成员值为MyAnnotations.class
• ② MyAnnotation 的Target 和 Retention等元注解 和MyAnnotations相同

类型注解
主要有用于反射获取信息

class Generic<@MyAnnotation T>{

    public void show() throws @MyAnnotation RuntimeException{
        ArrayList<@MyAnnotation String> list  = new ArrayList<>();

        int num =(@MyAnnotation int) 10L;

    }

}