Java枚举类和元注解---Java基础宋红康学习笔记

1、枚举类

1.1枚举类的使用：入门

• 枚举类的理解：类的对象只有有限个，确定的。我们称此类为枚举类
  • 星期
  • 性别
  • 季节
  • .......
• 需要定义一组常量时，强烈监视使用枚举类
• 如果枚举类中只有一个对象，则可以作为单例模式的实现方式

1.2、枚举类的定义

• 方式一

public class seasonTest {
    public static void main(String[] args) {
        Season season = Season.AUTUMN;
        System.out.println(season);
    }
}

//自定义枚举类
class Season{
    //1、声明Season对象的属性
    private final String name;
    private final String desc;

    //2、私有化类的构造器
    private Season(String name,String desc){
        this.name = name;
        this.desc = desc;
    }
    //3、提供枚举类的多个对象 ：public static final 的
    public static final Season SPRING = new Season("春天", "春暖花开");
    public static final Season SUMMER = new Season("夏天", "夏日炎炎");
    public static final Season AUTUMN = new Season("秋天", "秋高气爽");
    public static final Season WINTER = new Season("冬天", "冰天雪地");

    //4、其它诉求，获取枚举类对象的属性

    public String getName() {
        return name;
    }

    public String getDesc() {
        return desc;
    }

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

• 方式二

package com.枚举类与注解;
/*
* 使用enum关键字定义枚举类
* 说明：定义的枚举类默认继承于java.lang.Enum类
* */
public class SeasonTest1 {
    public static void main(String[] args) {
        Season1 summer = Season1.SUMMER;
        System.out.println(summer);//如果没有重写toString，则打印对象名
    }

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

    //1、提供当前枚举类的多个对象 ，多个对象之间用 , 隔开"，"莫问对象以"；"结束
    SPRING("春天", "春暖花开"),
    SUMMER("夏天", "夏日炎炎"),
    AUTUMN("秋天", "秋高气爽"),
    Season1("冬天", "冰天雪地");

    //2、声明Season对象的属性：private final 修饰
    private final String name;
    private final String desc;

    //3、私有化类的构造器
    private Season1(String name,String desc){
        this.name = name;
        this.desc = desc;
    }

    //4、其它诉求，获取枚举类对象的属性

    public String getName() {
        return name;
    }

    public String getDesc() {
        return desc;
    }

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

1.3、Enum类中的常用方法

• values()方法：返回枚举类型的对象数组。该方法可以很方便地遍历所有的 枚举值
• valueOf(String str)：返回枚举类中对象名是str的对象。要求字符串必须是枚举类对象的“名字”。如不是，会有运行时异常： IllegalArgumentException
• toString()：返回当前枚举类对象常量的名

1.4、使用enum定义的枚举类实现接口

情况1、实现接口，在enum类中实现抽象接口

//定义一个接口
interface info{
    void show();
}
//枚举类继承接口，重写接口中的方法
enum Season1 implements info{

    SPRING("春天", "春暖花开"),
    SUMMER("夏天", "夏日炎炎"),
    AUTUMN("秋天", "秋高气爽"),
    Season1("冬天", "冰天雪地");

    private final String name;
    private final String desc;

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

//重写接口中的方法
    @Override
    public void show() {
        System.out.println("jdioasjdiojao");
    }


}

情况二、在枚举类中的 每个对象中重写接口中的方法

enum Season1 implements info{

    SPRING("春天", "春暖花开"){
        @Override
        public void show() {
            System.out.println("春天");
        }
    },
    SUMMER("夏天", "夏日炎炎"){
        @Override
        public void show() {
            System.out.println("夏天");
        }
    },
    AUTUMN("秋天", "秋高气爽"){
        @Override
        public void show() {
            System.out.println("秋天");
        }
    },
    Season1("冬天", "冰天雪地"){
        @Override
        public void show() {
            System.out.println("冬天");
        }
    };

    private final String name;
    private final String desc;

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

}

2、注解

• Annotation (注解)其实就是代码里的特殊标记，这些标记可以在编译，类加载，运行时被读取，并执行相应的处理。通过使用Annotation，程序员可以在不改变原有逻辑的情况下，在源文件中嵌入一些补充信息。代码分析工具、开发工具和部署工具可以通过这些补充信息进行验证或进行部署
• 在JavaSE中，注解的使用目的比较简单，例如标记过时的功能， 忽略警告等。在JavaEE/Android中注解占据了更重要的角色，例如 用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗 代码和XML配置等

2.1、自定义注解

/*
* 自定义注解
* 1、注解声明为：@interface
* 2、内部定义成员，通常使用value表示
* 3、可以指定成员的默认值，使用default定义
* 4、如果自定义注解没有成员，表示是一个表示作用
*
* 如果注解有成员，在使用注解时，需要指明成员的值
* */
public @interface MyAnnotation {

    String value() default "456";
}

//使用注解
@MyAnnotation("123")
class Person{
    private String name;
    private int age;

    public Person() {
    }

    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }

    public void walk(){
        System.out.println("人走路");
    }
    public void eat(){
        System.out.println("人吃饭");
    }
}

2.2、元注解

• jdk 提供的4中元注解 元注解：对现有的注解进行解释说明的注解
  • Retention ：指定所修饰的Annotation 的声明周期：SOURCE\CLASS（默认行为）\RUNTIME 只有声明为RUNTIME生命周期的注解，才能通过反射获取
  • Target：用于指定被修饰的Annotation能用于修饰哪些程序元素
  • Doumented:用于指定被Annotation修饰的Annotation类将被javadoc工具提取成文档。默认情况下，Java是不包括注解的
    • 定义为Documented的注解必须设置为Retention值为RUNTIME
  • Inherited：被它修饰得Annotation将具有继承性。如果某个类使用了被@Inherited修饰得Annotation，则其子类将自动具有该注解。
    • 比如：如果把标有@Inherited注解的自定义的注解标注在类级别上，子类则可以继承父类类级别的注解
    • 实际应用中，使用较少。

2.3、jdk8中注解的新特性

1）可重复注解

jdk8之前实现注解可重复

@MyAnnotation(value="asiojd")
@MyAnnotation(value="asio")//报错
public class Person {

    String value() default "456";
}

//要实现可重复注解需要
//1、新建一个枚举类
public @interface MyAnnotions {

    MyAnnotation [] value();

}
//2、实现注解的重复性
@MyAnnotions({@MyAnnotation(value="asio"),@MyAnnotation(value="asiojd")})
public class Person {


}

jdk8之后实现注解可重复

@Repeatable()

1)在MyAnnoattion上声明@Repeatable，成员值为MyAnnotations.class

2)MyAnnotation的target和Retention等元注解和MyAnnotations相同

2）类型注解

class Generic<@MyAnnotation T>{
    public void show() throws @MyAnnotation RuntimeException{
        ArrayList<@MyAnnotation String>list = new ArrayList<>();
        
        int num = (@MyAnnotation int)10L;
    }
}



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

    String value() default "456";
}