首页 > 其他分享 >枚举类和注解

枚举类和注解

时间：2024-03-10 14:15:02浏览次数：18  
标签：String 对象 public 枚举 注解 final

一、枚举类的使用

1. 枚举类的说明：

  1. 枚举类的理解：类的对象只有有限个，确定的。我们称此类为枚举类

  2. 当需要定义一组常量时，强烈建议使用枚举类

  3. 枚举类的实现：

    JDK 5.0以前需要自定义

    JDK 5.0后新增enum关键字用于定义枚举类

  4. 如果枚举类中只一个对象，则可以作为单例模式的实现方式。

  5. 枚举类的属性：

    枚举类对象的属性不应允许被改动，所以应该使用 private final修饰 枚举类的使用 private final修饰的属性应该在构造器中为其赋值 若枚举类显式的定义了带参数的构造器，则在列出枚举值时也必须对应的传入参数

2. 如何自定义枚举类？

步骤:

  1. 私有化构造器，保证不能在类的外部创建其对象；
  2. 在类的内部创建枚举类的示例。声明为：public static final；
  3. 对象如果有实例变量，应该声明为private final，并在构造器中初始化；

代码示例：

//自定义枚举类
class 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.其他诉求1：获取枚举类对象的属性
    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }
    //4.其他诉求1：提供toString()
    @Override
    public String toString() {
        return "Season{" +
            "seasonName='" + seasonName + '\'' +
            ", seasonDesc='" + seasonDesc + '\'' +
            '}';
    }
}

3. JDK 5.0 新增使用enum定义枚举类。

使用说明：

  • 使用enum定义的枚举类默认继承了 java.lang.Enum 类，因此不能再继承其他类
  • 枚举类的构造器只能使用private权限修饰符
  • 枚举类的所有实例必须在枚举类中显式列出(, 分隔 ; 结尾)。列出的实例系统会自动添加public static final 修饰
  • 必须在枚举类的第一行声明枚举类对象

代码示例：

//使用enum关键字枚举类
enum Season1 {
    //1.提供当前枚举类的对象，多个对象之间用","隔开，末尾对象";"结束
    SPRING("春天","春暖花开"),
    SUMMER("夏天","夏日炎炎"),
    AUTUMN("秋天","秋高气爽"),
    WINTER("冬天","冰天雪地");

    //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;
    }

}

Enum类的常用方法：

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

代码示例：

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]);
}
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);

用Enum类定义的枚举类对象分别实现接口：

使用说明：

  1. 和普通Java类一样，枚举类可以实现一个或多个接口
  2. 若每个枚举值在调用实现的接口方法呈现相同的行为方式，则只要统一实现该方法即可。
  3. 若需要每个枚举值在调用实现的接口方法呈现出不同的行为方式，则可以让每个枚举值分别来实现该方法

代码示例：


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("大约在冬季");
        }
    };
}

二、注解的使用

1. 注解的理解

① jdk 5.0 新增的功能

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

③ Annotation可以像修饰符一样使用，可以用来修饰包、类、构造器、方法、成员变量、参数、局部变量的声明，这些信息被保存在Annotation的 name = value 对中。

④ 在JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在JavaEE/Android 中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗 代码和XML配置等。

⑤ 框架 = 注解 + 反射机制 + 设计模式

2. 注解的使用示例

使用 Annotation时要在其前面增加 @ 符号，并把该 Annotation当成个修饰符使用。用于修饰它支持的程序元素

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

  • @author 标明开发该类模块的作者，多个作者之间使用，分割 @version 标明该类模块的版本；
  • @see 参考转向，也就是相关主题；
  • @since 从哪个版本开始增加的；
  • @param 对方法中某参数的说明，如果没有参数就不能写 @return 对方法返回值的说明，如果方法的返回值类型是 void 就不能写 @exception 对方法可能抛出的异常进行说明，如果方法没有用 throws 显式抛出的异常就不能写；
  • 其中 @param 、 @return 和 @exception 这三个标记都是只用于方法的。
  • @param 的格式要求：@param 形参名形参类型形参说明；
  • @return 的格式要求：@return 返回值类型返回值说明；
  • @exception 的格式要求：@exception 异常类型异常说明；
  • @param 和 @exception 可以并列多个；

代码示例：

/**
 * @author bruce
 * @project_name JavaSenior
 * @package_name com.bruce.java
 * @create 2020-04-26 10:58
 */
public class AnnotationTest {
    /**
     *程序的主方法
     * @param args 传入命令行参数
     */
    public static void main(String[] args) {

    }

    /**
     * 求圆形面积
     * @param radius 所求面积的半径
     * @return 面积值
     */
    public static double getArea(double radius){
        return Math.PI * radius * radius;
    }
}

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

  • @Override: 限定重写父类方法, 该注解只能用于方法；
  • @Deprecated: 用于表示所修饰的元素(类, 方法等)已过时。通常是因为所修饰的结构危险或存在更好的择；
  • @SuppressWarnings: 抑制编译器警告；如未使用的变量

代码示例：

public class AnnotationTest{
    public static void mian (String [] args){
        @SuppressWarning("unused")
        int a = 0;
    }
    @Deprecated
    public void print(){
        System.out.print("过时的方法");
    }
    @Override
    public String toString(){
        return "重写的toString方法";
    }
}

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

在使用Spring框架时会大量用到注解驱动开发。

3. 如何自定义注解

参照 @SuppressWarnings 定义

  1. 注解声明为：@interface
  2. 内部定义成员，通常使用value表示
  3. 可以指定成员的默认值，使用default定义
  4. 如果自定义注解没成员，表明是一个标识作用。

说明：

  • 如果注解有成员，在使用注解时，需要指明成员的值。

  • 自定义注解必须配上注解的信息处理流程(使用反射)才意义。

  • 自定义注解通过都会指明两个元注解：@Retention、@Target

    4. 元注解 ：

对现有的注解进行解释说明的注解。

JDK 5.0 提供的4种元注解：

  1. @Retention：指定所修饰的 Annotation 的生命周期：SOURCE\CLASS（默认行为）\RUNTIME，只有声明为RUNTIME生命周期的注解，才能通过反射获取。
  2. @Target:用于指定被修饰的 Annotation 能用于修饰哪些程序元素 image-20200426111841391
  3. @Documented:表示所修饰的注解在被javadoc解析时，保留下来。
  4. @Inherited:被它修饰的 Annotation 将具继承性。

类比：元数据的概念：String name = "Tom";对现有数据的修饰

5. 如何获取注解信息:

通过发射来进行获取、调用。

前提：要求此注解的元注解Retention中声明的生命周期状态为：RUNTIME.

6. JDK 8.0中注解的新特性：

可重复注解、类型注解

6.1 可重复注解：

① 在MyAnnotation上声明 @Repeatable，成员值为 MyAnnotations.class

② MyAnnotation的Target和Retention等元注解与MyAnnotations相同。

6.2 新增两种类型注解：

TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中（如：泛型声明。）

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";
}

标签：String,对象,public,枚举,注解,final
From： https://www.cnblogs.com/jing15/p/18064120

相关文章

  • 枚举
    枚举其主要功能是定义一组有限的选项，例如，方向(上、下、左、右)或季节(春、夏、秋、冬）等概念枚举成员类型：即使枚举成员的值是数字（不赋值默认是0），成员如Season.SPRING的类型还是Season。 要给枚举成员SPRING赋值，你不需要指定其类型为Season，在枚举内部赋值时，枚举成员的类型自......
  • SpringBoot-重要注解(1)
    ConfigurationProperties注解https://blog.csdn.net/skh2015java/article/details/120141409@Import、@ImportAutoConfigurationhttps://www.cnblogs.com/imyjy/p/16092825.html当我们需要在一个配置类中导入另一个Configuration配置类时，可以使用@Import、@ImportAuto......
  • java 注解
    1、什么是注解      类似一种特殊的注释，可以在程序运行时被反射获取，如同标签。2、注解分类内置注解自定义注解内置注解Java定义了一套注解，共有7个，3个在java.lang中，剩下4个在java.lang.annotation中。作用在代码的注解：@Override-检查该方法是否是重......
  • Spring-@Bean-注解
    1.作用用于将对象存入spring的ioc容器中。@controller、@Service、@Component、@Configuration、@Repository等几个注解是一样的，都是负责将对象存入容器当中，而@Bean是用在方法上，将当前方法的返回值对象放到容器当中。2.使用@Bean一般出现在方法上面，也可用于自定义......
  • Spring-@ControllerAdvice-全局处理注解
    1，@ControllerAdvice介绍@ControllerAdvice是Spring框架提供的一个注解，用于定义全局的异常处理器和全局数据绑定。它通常用于集中处理应用程序中的异常，并提供统一的异常处理逻辑。2，@ControllerAdvice的基本使用packageorg.springframework.web.bind.annotation;importj......
  • Java 枚举（Enums）解析：提高代码可读性与易维护性
    接口在Java中，实现抽象的另一种方式是使用接口。接口定义接口是一个完全抽象的类，用于将具有空方法体的相关方法分组：//接口interfaceAnimal{publicvoidanimalSound();//接口方法（没有具体实现体）publicvoidrun();//接口方法（没有具体实现体）}实现接口要访问......
  • 【Python基础】Python 函数返回多个值和函数注解
    [本文出自天外归云的博客园]Python函数返回多个值和函数注解在Python中，函数可以返回多个值。这在某些情况下很有用，因为它允许函数一次性返回多个相关联的结果。Python使用元组（tuple）来实现这一特性。函数返回多个值示例下面是一个示例函数，它接受一个整数和一个字符串作为......
  • 3_基于注解管理Bean对象
    基于注解管理Bean对象1.基本介绍Spring通过注解实现自动装配的步骤如下：引入依赖开启组件扫描使用注解定义Bean依赖注入Spring默认不使用注解配置bean，因此需要我们在Spring的配置文件中配置context:component-scan元素开启SpringBeans的自动扫描功能。开启此功能后，Sprin......
  • Java 切入点 JoinPoint的使用，用于拦截方法，与自定义注解
    这里的代码案例是外卖系统中，用于统一修改新增和更新内容中的更新时间与更新人内容，根据具体情况，在使用时进行自定义修改就行了第一部分是annotation的，因为是为了自动填充数据准备，所以创建annotation包后，在其中创建了AutoFill的注解类型/***自定义注解，用于标识某个方法需要用......
  • SpringBoot常用注解
    SpringBoot常用注解  @SpringBootApplication=@SpringBootConfiguration+@ComponentScan+@EnableAutoConfiguration@Configuration注解能够将一个类定义为SpringBoot应用程序中的配置类，等同于spring的XML配置文件，从而使该类中的Bean对象能够被SpringIoC容器进行自动管......

赞助商

阅读排行

网站主页关于我们联系我们网站地图

本网站内容转载自其他媒体，侵权联系[admin##ips99.com]。

Copyright © 2020-2023 IPS99 版权所有 IPS99