枚举和注释

枚举和注释

一、枚举

1.基本介绍

枚举是对应英文(enumeration，简写 enum)。枚举是一组常量的集合。枚举属于一种特殊的类，里面只包含一组有限的特定的对象。

2.枚举的两种实现方式

1.自定义类实现枚举
2.使用enum关键字实现枚举

3.自定义类实现枚举

1.不需要提供setXxx方法，因为枚举对象通常为只读。
2.对枚举对象/属性使用final + static共同修饰，实现底层优化
3.枚举对象名通常使用全部大写，常量的命名规范。
4.枚举对象根据需要，也可以有多个属性。
代码演示：

class Season01 {
    private String name;
    private String desc; // 描述

    // 定义四个对象,固定。
    public final static Season01 SPRING = new Season01("春天", "温暖");
    public final static Season01 SUMMER = new Season01("夏天", "炎热");
    public final static Season01 AUTUMN = new Season01("秋天", "凉爽");
    public final static Season01 WINTER = new Season01("冬天", "寒冷");
    // 1.将构造器私有化, 目的防止 直接new
    // 2.去掉setXxx方法, 防止属性被修改
    // 3.在Season01内部, 直接创建固定对象
    // 4.优化, 可以加入final修饰符
    private Season01(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }

    public String getName() {
        return name;
    }



    public String getDesc() {
        return desc;
    }
}

5.小结，自定义实现枚举类，有如下特点
①构造器私有化
②本类内部创建一组对象
③对外暴露对象(通常用public final static 修饰符)
④可以提供get方法，但是不要提供set。

4.使用enum关键字

1. 步骤

①使用enum关键字代替class
②如果有多个常量对象，使用，号间隔
③如果enum来使实现枚举，定义常量对象，写在最前面。
代码如下：

// 1.使用enum关键字代替class
enum Season03{
    // 2.如果有多个常量对象，使用，号间隔
    SPRING("春天","温暖"),SUMMER("夏天", "炎热"),AUTUMN("秋天", "凉爽"),WINTER("冬天", "寒冷");

    // 3.如果enum来使实现枚举，定义常量对象，写在最前面。
    private String name;
    private String desc; // 描述

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

2.enum注意事项

1.当我们使用enum关键字开发一个枚举类时，默认会继承Eunm类。如图所示：

2.如果使用无参构造方法创建枚举对象，则实参列表和小括号可以省略。代码如下：

enum Season04{
    // 2.如果有多个常量对象，使用，号间隔
    SPRING("春天","温暖"),SUMMER("夏天", "炎热"),AUTUMN("秋天", "凉爽"),
    WINTER("冬天", "寒冷"),WAIT();

    // 3.如果enum来使实现枚举，定义常量对象，写在最前面。
    private String name;
    private String desc; // 描述

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

    private Season04() {

    }
}

3.当枚举对象有多个时中间用,号隔开，最后用;结尾。
4.枚举对象必须要在枚举类的最前面。

3.enum常用方法说明

1.toString方法：Enum类以及重写过了，返回当前的对象名，子类可以重写该方法，用于返回对象属性。
2.name：返回当前对象名(常量名)，子类中不能重写
3.ordinal：返回当前对象的位置名，默认从0开始。
4.values：返回当前枚举类的所有常量
5.values0f：将字符串转换成枚举对象，否则报异常
6.compareTo：比较枚举类比较的是位置。是ordinal值相减
代码如下：

package com.hh6879.enum_;

public class Enumeration04 {
    public static void main(String[] args) {
        Season04 season04 = Season04.SPRING;
        System.out.println(season04);
        System.out.println("season04 的位置 = " + season04.ordinal());
        System.out.println("season04 = " + season04.name());
        Season04 season041 = Season04.valueOf("SUMMER");
        System.out.println("season041 = " + season041.name());
        // 打印所有常量, values是静态方法
        Season04[] season04s = Season04.values();
        for (Season04 season042 : season04s) {
            System.out.println(season042);
        }

        // 打印位置差值
        System.out.println(season04.compareTo(season041));


    }
}

enum Season04 {
    // 2.如果有多个常量对象，使用，号间隔
    SPRING("春天", "温暖"), SUMMER("夏天", "炎热"), AUTUMN("秋天", "凉爽"),
    WINTER("冬天", "寒冷"), WAIT();

    // 3.如果enum来使实现枚举，定义常量对象，写在最前面。
    private String name;
    private String desc; // 描述

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

    private Season04() {

    }
}

4.enum使用细节

1.使用enum关键字后就不能继承其他类了，因为enum会隐式继承Enum类，而Java是单继承机制的。
2.枚举类和普通的类一样可以实现接口，如以下形式：
  enum 类名 implements 接口1, 接口2…{}
代码如下：

public class EnumDetail {
    public static void main(String[] args) {
        Dog dog = Dog.DAHUANG;
        dog.say(); // 输出结果: 小狗汪汪叫
    }
}

interface Animal{
    void say();
}

enum Dog implements Animal{
    DAHUANG;
    @Override
    public void say(){
        System.out.println("小狗汪汪叫");
    }
}

二、注解

1.基本介绍

①注解(Annotation)也被称为元数据(MetaData)，用于修饰解释包，类，方法，属性，构造器，局部变量等数据信息。
②和注销一样，注解不影响程序的逻辑，但注解可以被编译或运行，相当于嵌入在代码中的补充信息。
③在JavaSE中，注解的目的比较简单，例如标记过时的功能，忽略警告等。在JavaEE中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替旧版JavaEE中所遗留的繁冗代码和xml配置等。
④使用注释要在前面加上@符号，并把该注解当作1一个修饰符使用，修饰它支持的程序元素。
⑤三个基本的注解
  1)@Override：限定某个方法是重写的父类的方法，该注解只能用于方法
  2)@Deprecated：用于表示某个程序元素(类，方法)已过时。
  3)@SuppressWarnings：抑制编译器警告。

1.@Override注释

1.@Override表示指定重写父类方法(从编译层面验证，如果没有重写会报错)。
2.如果不写@Override注解，依然可以构成重写
代码演示如下：

public class Override_ {
    public static void main(String[] args) {
        Son son = new Son();
        son.introduce();
        son.say();
    }
}

class Father{
    public void introduce(){
        System.out.println("我是爸爸");
    }

    public void say(){
        System.out.println("我是爸爸");
    }
}

class Son extends Father{
    @Override
    public void introduce(){
        System.out.println("我是儿子");
    }

    // 依旧完成重写
    public void say(){
        System.out.println("我是儿子");
    }
}

输出结果：

我是儿子
我是儿子

2.@Deprecated

1.用于表示某个程序元素(类，方法等)已过时。
2.可以修饰类，属性，包，参数等等。
3.@Deprecated的作用可以做到新旧版本的兼容和过渡。
4.被@Deprecated修饰的会有下划线
代码如下：

public class Deprecated_ {
    public static void main(String[] args) {
        A a = new A();
        a.say();
    }
}
@Deprecated
class A{
    @Deprecated
    public void say(){
        System.out.println("hh6879");
    }
}

图片：

3.@SuppressWarnings

1.@SuppressWarnings用于忽略警告。
2.生成@SuppressWarnings不用背，idea中可以使用提示生成。
3.@SuppressWarnings关键字这里不列出，有兴趣的去看看，一搜就有

3.元注解

1.Java中的元注解用于修饰其他的注解。
2.常用种类
  ①Retention：指定注解的作用范围，三种：SOURCE，CLASS，RUNTIME
  ②Target：指定注解可以在那些地方使用。
  ③Document：指定注解是否会在javadoc体现
  ④Inherited：子类会继承父类注解

1.@Retention

①说明：只能用于修饰注解，用于指定注解可以保留的时间，@Retention包含一个RetentionPolicy类型成员变量，可以@Rentention必须为该value成员变量指定值.
②
  1)RetentionPolicy.SOURCE：编译器使用后，直接丢弃这种策略注解
  2)RetentionPolicy.CLASS：编译器把注解记录在class文件中，当运行Java程序时，JVM不会保留注解。这是默认值。
  3)RetentionPolicy.RUNTIME：编译器把注解记录在class文件中，JVM会保留注解。程序可以通过反射获取该注解。
③源码图片如下：

2.@Target

用于修饰注解定义, 用于指定被修饰注解能作用于那些元素。@Target也包含一个名为value的成员变量。源码图片如下：

下面还有但是基本上和翻译对的上就不列出来了。

3.@Document

用于指定该注解修饰的注解将被javadoc工具提取成文档，即生成文档时，可以看到该注解。
Tip：定义为Documented的注解必须设置Retention为RUNTIME
源码图片如下：

4.@Inherited

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

4.@interface

@interface代表注解类是JDK5.0后加入的。