day10-枚举类、注解

最新推荐文章于 2025-12-30 20:41:53 发布

原创最新推荐文章于 2025-12-30 20:41:53 发布 · 247 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#java

java 专栏收录该内容

16 篇文章

订阅专栏

本文探讨了如何在Java中创建枚举类，包括私有成员变量、私有构造器、实例声明、get方法和toString方法的使用。同时介绍了如何通过enum定义枚举类，实现接口以及使用注解进行文档生成和代码检查。

1.枚举类

1.自定义枚举类

1.成员变量不可改变 private final

2.私有构造器 private

3.实例 public static final

4.get方法

5.toString方法

package com.zkx.enumtest;

/**
 * @author zkx
 * @create 2022-02-14 13:05
 */

public class EnumTest {
    public static void main(String[] args) {
        Season spring = Season.SPRING;
        System.out.println(spring);//Season{SEASONNAME='spring', SEASONDESC='春天'}
        System.out.println(spring.getSEASONNAME()+","+spring.getSEASONDESC());//spring,春天
    }


}

//创建一个枚举类
class Season{
    //1.首先成员变量不可改变 private final
    private final String SEASONNAME;//季节名称
    private final String SEASONDESC;//季节描述

    //2.构造器私有化 private
    private Season(String name , String desc){
        this.SEASONNAME=name;
        this.SEASONDESC=desc;
    }

    //3.实例声明为public static final
    public static final Season SPRING = new Season("spring","春天");
    public static final Season SUMMER = new Season("summer","夏天");
    public static final Season AUTUMN = new Season("autumn","秋天");
    public static final Season WINTER = new Season("winter","冬天");

    //4.get方法，因为是私有的不可改变的成员变量，所以没有set方法
    public String getSEASONNAME() {
        return SEASONNAME;
    }

    public String getSEASONDESC() {
        return SEASONDESC;
    }

    //5.重写toString方法
    @Override
    public String toString() {
        return "Season{" +
                "SEASONNAME='" + SEASONNAME + '\'' +
                ", SEASONDESC='" + SEASONDESC + '\'' +
                '}';
    }
}

2.使用enum定义枚举类

1.第一行必须写实例，且public static final 自动添加，逗号分割，分号结尾

2.成员变量为private final

3.构造器必须private

4.get方法

5.重写toString方法

方法：

1.values（）返回枚举类所有实例

2.valueOf（String str）将字符串转换成对应枚举类，字符串是枚举类对象的名字，否则报错

3.toString（）返回当前枚举类对象的名称

package com.zkx.enumtest;

/**
 * @author zkx
 * @create 2022-02-14 17:26
 */
public class EnumTest1 {
    public static void main(String[] args) {
        Season1 spring = Season1.SPRING;
        System.out.println(spring);//Season1{seasonName='spring', seasonDesc='春天'}
        System.out.println("*************************");

        //values()方法:返回枚举类的所有实例
        Season1 [] values = Season1.values();
        for (int i = 0; i < values.length; i++) {
            System.out.println(values[i]);
        }
        System.out.println("*************************");

        //valueOf(String str):将字符串转换为对应的枚举类，字符串是枚举类对象的名字
        Season1 summer = Season1.valueOf("SUMMER");
        System.out.println(summer);

    }
}

//使用enum定义枚举类
enum Season1{//不能在继承其他类

    //1.实例必须在第一行，逗号,分割，分号;结尾，实例自动添加public static final
    SPRING("spring","春天"),
    SUMMER("summer","夏天"),
    AUTUMN("autumn","秋天"),
    WINTER("winter","冬天");

    //2.成员变量private final
    private final String seasonName;
    private final String seasonDesc;

    //3.构造器必须private
    private Season1(String seasonName,String seasonDesc){
       this.seasonName=seasonName;
       this.seasonDesc=seasonDesc;
    }

    //4.get方法
    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }

    //5.重写toString方法
    @Override
    public String toString() {
        return "Season1{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

3.使用enum定义枚举类实现接口

1.枚举类可以实现接口

2.若所有对象实现接口的抽象方法都一样，可以在枚举类中重写一次就可以

3.若所有对象实现接口的抽象方法不一样，则在每个枚举类对象实例中重写接口抽象方法

package com.zkx.enumtest;

/**
 * @author zkx
 * @create 2022-02-14 22:24
 */
public class EnumTest2 {
    public static void main(String[] args) {
        Time time1 = Time.AFTERNOON;
        time1.show();

    }
}

//枚举类实现接口
interface Info{
    void show();
}
//枚举类
enum Time implements Info{

    //1.实例须写在第一行
    MORNING("morning","早上"){
        @Override
        public void show() {
            System.out.println("zzz");
        }
    },
    AFTERNOON("afternoon","下午"){
        @Override
        public void show() {
            System.out.println("xxx");
        },
    },
    EVENING("evening","晚上"){
        @Override
        public void show() {
            System.out.println("www");
        }
    };


    //2.成员变量private final
    private final String timeName;
    private final String timeDesc;

    //3.构造器private
    private Time(String timeName,String timeDesc){
        this.timeName = timeName;
        this.timeDesc = timeDesc;
    }

    //4.get方法
    public String getTimeName() {
        return timeName;
    }

    public String getTimeDesc() {
        return timeDesc;
    }

    //5.toString方法
    @Override
    public String toString() {
        return "Time{" +
                "timeName='" + timeName + '\'' +
                ", timeDesc='" + timeDesc + '\'' +
                '}';
    }


}

2.注解Annotation

 示例一：生成文档相关的注解

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

@version 标明该类模块的版本

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

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

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

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

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

其中

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

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

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

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

@param 和 @exception 可以并列多个

 示例二：在编译时进行格式检查 (JDK 内置的三个基本注解 )

 @Override: 限定重写父类方法 , 该注解只能用于方法

 @Deprecated: 用于表示所修饰的元素 ( 类 , 方法等 ) 已过时。通常是因为

所修饰的结构危险或存在更好的选择

 @SuppressWarnings: 抑制编译器警告

 示例三：跟踪代码依赖性，实现替代配置文件功能

2.1自定义注解

https://blog.youkuaiyun.com/PorkBird/article/details/113696306

2.2 元注解

修饰注解的注解，4个元注解

1. @Retention: 只能用于修饰一个 Annotation 定义, 用于指定该 Annotation 的生命

周期

 RetentionPolicy.SOURCE: 在源文件中有效（即源文件保留），编译器直接丢弃这种策略的注释

 RetentionPolicy.CLASS : 在 class 文件中有效（即 class 保留），当运行 Java 程序时 , JVM不会保留注解。这是默认值

 RetentionPolicy.RUNTIME: 在运行时有效（即运行时保留）， 当运行 Java 程序时 , JVM 会 保留注释。程序可以通过反射获取该注释。

2. @Target: 用于修饰 Annotation 定义, 用于指定被修饰的 Annotation 能用于修饰哪些程序元素。 @Target 也包含一个名为 value 的成员变量。

3.@Documented: 用于指定被该元 Annotation 修饰的 Annotation 类将被 javadoc 工具提取成文档。默认情况下，javadoc是不包括注解的。

定义为Documented的注解必须设置Retention值为RUNTIME。

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

 比如：如果把标有 @Inherited 注解的自定义的注解标注在类级别上，子类则可以继承父类类级别的注解

 实际应用中，使用较少

其他一些注解知识：

https://blog.youkuaiyun.com/PorkBird/article/details/113696306