枚举和注解

枚举（enum）

• 枚举是一个被命名的整型常数的集合，用于声明一组带标识符的常数。
  当需要定义一组常量时，强烈建议使用枚举类。

定义枚举：

enum Status{
    FREE,BUSY,VOCATION
}

public class Test{
    public static void main(String[] args) {
        //假设 有对象a有数据
        switch(a.getStatus()){
            case FREE:
            //要做的事
            break;
            case BUSY:
            //要做的事
            break;
            case VOCATION:
            //要做的事
            break;
        }      
    }
}

---

package com.far.mj;

/**
 * @Author: ytFar
 * @CreateDate: 2019/12/6 0:13
 * @Description: 使用enum关键字定义枚举类
 *  * 说明：定义的枚举类默认继承于java.lang.Enum类
 * @Version: 1.0
 */

public class SeasonTest {
    public static void main(String[] args) {
        Season1 summer = Season1.SUMMER;
        //toString():返回枚举类对象的名称
        System.out.println(summer.toString());

//        System.out.println(Season1.class.getSuperclass());
        System.out.println("****************");
        //values():返回所有的枚举类对象构成的数组
        Season1[] values = Season1.values();
        for(int i = 0;i < values.length;i++){
            System.out.println(values[i]);
            values[i].show();
        }
        System.out.println("****************");
        Thread.State[] values1 = Thread.State.values();
        for (int i = 0; i < values1.length; i++) {
            System.out.println(values1[i]);
        }

        //valueOf(String objName):返回枚举类中对象名是objName的对象。
        Season1 winter = Season1.valueOf("WINTER");
        //如果没有objName的枚举类对象，则抛异常：IllegalArgumentException
//        Season1 winter = Season1.valueOf("WINTER1");
        System.out.println(winter);
        winter.show();
    }
}

//枚举类基础接口
interface Info{
    void show();
}

//使用enum关键字枚举类
enum Season1 implements Info{
    //1.提供当前枚举类的对象，多个对象之间用","隔开，末尾对象";"结束
    SPRING("春天","春暖花开"){
        @Override
        public void show() {
            System.out.println("春天在哪里？");
        }
    },
    SUMMER("夏天","夏日炎炎"){
        @Override
        public void show() {
            System.out.println("宁夏");
        }
    },
    AUTUMN("秋天","秋高气爽"){
        @Override
        public void show() {
            System.out.println("秋天不回来");
        }
    },
    WINTER("冬天","冰天雪地"){
        @Override
        public void show() {
            System.out.println("大约在冬季");
        }
    };

    //2.声明Season对象的属性:private final修饰
    private final String seasonName;
    private final String seasonDesc;

    //2.私有化类的构造器,并给对象属性赋值

    private Season1(String seasonName,String seasonDesc){
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }

    //4.其他诉求1：获取枚举类对象的属性
    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }


//    @Override
//    public void show() {
//        System.out.println("这是一个季节");
//    }
}

注解（Annotation）

Annotation 其实就是代码里的特殊标记, 这些标记可以在编译, 类加载, 运行时被读取, 并执行相应的处理。通过使用 Annotation,程序员可以在不改变原有逻辑的情况下, 在源文件中嵌入一些补充信息。

• 从 JDK 5.0 开始, Java 增加了对元数据(MetaData) 的支持, 也就是Annotation(注解)
• Annotation 其实就是代码里的特殊标记, 这些标记可以在编译, 类加载, 运行时被读取, 并执行相应的处理。通过使用 Annotation, 程序员可以在不改变原有逻辑的情况下, 在源文件中嵌入一些补充信息。代码分析工具、开发工具和部署工具可以通过这些补信息进行验证或者进行部署。
• Annotation 可以像修饰符一样被使用, 可用于修饰包,类, 构造器, 方 法, 成员变量, 参数, 局部变量的声明, 这些信息被保存在 Annotation 的 “name=value” 对中。
• 用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗代码和XML配置等
• 未来的开发模式都是基于注解的，JPA是基于注解的，Spring2.5以上都是基于注解的，Hibernate3.x以后也是基于注解的。注解是一种趋势，一定程度是可以说：
  框架 = 注解 + 反射 + 设计模式

JDK内置的三个基本注解

• @Override 限定重写父类方法，该注解只能用于方法
• @Deprecated 用于表示所修饰的元素(类，方法等)已过时。
• @SuppressWarnings 抑制编译器警告

//自定义注解
public @interface MyAnnotation {

    String value() default "hello";
}

JDK中4个元注解(JDK5)

• 对现有的注解进行修饰的注解叫做元注解(元数据亦是)
  JDK的元Accotation用于修饰其他Annotation定义
• @Retention RetentionPolicy.属性
  生命周期：SOURCE / CLASS(默认行为) / TUNTIME
  只有生命位RUNTIME生命周期的注解,才能通过反射获取
• @Target ElementType.属性
  用于修饰指定的Annotation，能用于修饰那些程序元素
  TYPE(类，接口，枚举类) / FIELD(属性) / METHOD(方法) / PARAMETER(形参) / CONSTRUCTOR(构造器) / LOCAL_VARIABLE(局部变量)
  -- 出现频率较低
• @Documented 表示所修饰的注解再被javadoc解析时，保留下来
  用于指定被该元Annotation修饰的Annotation类将被javadoc工具提取成文档
  默认情况下，javadoc不包含注解 -- 定义为Documented的注解必须设置Retention值为RUNTIME。
• @Inherited
  被它修饰的Annotation将具有继承性

@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
public @interface MyAnnotation {

    String value() default "hello";
}

通过反射获取注解。。。

JDK8中的新特性

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

@Inherited
@Repeatable(MyAnnotations.class)
@Retention(RetentionPolicy.RUNTIME)
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
public @interface MyAnnotation {

    String value() default "hello";
}

• 类型注解：
  ① ElementType.TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中（如：泛型声明）。
  ② ElementType.TYPE_USE 表示该注解能写在使用类型的任何语句中。

@Inherited
@Repeatable(MyAnnotations.class)
@Retention(RetentionPolicy.RUNTIME)
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE,TYPE_PARAMETER,TYPE_USE})
public @interface MyAnnotation {

    String value() default "hello";
}

class Generic<@MyAnnotation T>{

    public void show() throws @MyAnnotation RuntimeException{

        ArrayList<@MyAnnotation String> list = new ArrayList<>();

        int num = (@MyAnnotation int) 10L;
    }

}

• 时间：2019-12-5 23:51:40