java枚举与注解（随堂笔记）

枚举类的说明

• 枚举类的理解：类的对象只有有限个，确定的。我们称为枚举类；
• 当需要定义一组常量时，强烈建议使用枚举类；
• 如果枚举类中只有一个对象，则可以作为单例模式的实现方式；

如何定义枚举类

方式一：jdk5.0之前，自定义枚举类；

方式二：jdk5.0之后，可以使用enum关键字来自定义枚举类；

//方式一：jdk5.0之前，自定义枚举类
calss Season{
    //1.声明Season对象的属性：private final 修饰
    private final String seasonName；
    private final String seasonDesc；
    
    //2.私有化类的构造器，并给对象属性赋值；
    private Season(String seasonName,String seasonDesc){
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }
    
    //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 getSeasonName(){
        return seasonName;
    }
    public String getSeasonDesc(){
        return seasonDesc;
    }
}

//方法二：使用enum关键字定义枚举类
//说明：定义的枚举类默认继承于java.lang.Enum类
enum Season{
    //1.提供当前枚举类的对象，多个对象之间用“，”隔开，末尾对象用“；”结束
    SPRING("春天","春暖花开")；
    SUMMER("夏天","夏日炎炎");
    AUTUMN("秋天","秋高气爽");
    WINTER("冬天","冰天雪地");
    
    //2.声明Season对象的属性：private final 修饰
    private final String seasonName；
    private final String seasonDesc；
        
    //3.私有化类的构造器，并给对象属性赋值；
    private Season(String seasonName,String seasonDesc){
        this.seasonNane = seasonName;
        this.seasonDesc = seasonDesc;
    }
    
    //4.其他诉求：获取枚举类对象的属性
    public String getSeasonName(){
        return seasonName;
    }
    public String getSeasonDesc(){
        return seasonDesc;
    }
    
    //如果不提供toString方法，那么默认打印当前对象名字，例如System.out.println(summer)，那么输出SUMMER
}

Enum类的主要方法：

• values（）方法：返回枚举类型的对象数组，该方法可以很方便地遍历所有地枚举值；

• valueOf（String str）：可以把一个字符串转换为对应地枚举类对象，要求字符串必须是枚举类对象地“名字”，如不是，会有运行时异常。IllegalArgumentException

• toString（）：返回当前枚举类对象常量的名称；

使用enum关键字定义的枚举类实现接口的情况

1. 情况一：实现接口，在enum类中实现抽象方法；
2. 情况二：让枚举类的对象分别实现接口中的抽象方法；

生成文档相关的注解

@author 标明开发该类模块的作者，多个作者之间使用，分割；

@version 标明该类模块的版本；

@see 参考转向，也就是相关主题；

@since 从哪个版本开始增加的

@param 对方法中某参数的说明，如果没有参数就不能写；

@return 对方法返回值的说明，如果方法的返回值类型是void就不能写；

@exception 对方法可能抛出的异常进行说明，如果方法没有用throws显式抛出的异常就不能写；

@Override 限定重写父类方法，该注解只能用于方法；

@Deprecated 用于表示所修饰的元素（类、方法等）已过时。通常是因为所修饰的结构危险或存在更好的选择；

@SuppressWarnings 抑制编译器警告；

其中：@param @return 和 @exception 这三个标记都是只用于方法的。

​ @param 的格式要求：@param 形参名 形参类型 形参说明。

​ @return 的格式要求：@return 返回值类型 返回值说明。

​ @exception 的格式要求：@exception 异常类型 异常说明。

​ @param 和 @exception 可以并列多个。

自定义注解，参照@SuppressWarnings定义

• 注解声明为：@interface；
• 内部定义成员，通常使用value表示；
• 可以指定成员的默认值，使用default定义；
• 如果自定义注解没有成员，表明是一个标识作用；
• 如果自定义注解有成员，在使用注解时，需要指明成员的值；

jdk 提供的4种元注解

• 元注解：对现有的注解进行解释说明的注解；

• Retention：指定所修饰的Annotation的生命周期：SOURCRE \ CLASS（默认行为）\RUNTIME只有声明为RUNTIME生命周期的注解，才能通过反射；

• Target：用于指定被修饰的Annotation能用于修饰哪些程序员素；

• Documented：表示所修饰的注解在被javadoc解析时，保留下来；

• Inherited：被它修饰的Annotation将具有继承性；

jdk 8 中注解的新特性：可重复性、类型注解