Java枚举类与注解

枚举类的使用

类的对象只有有限个,确定的,称为枚举类。
星期:星期一、星期二…星期天。
季节:春、夏、秋、冬。
线程状态:创建、就绪、运行、阻塞、死亡。
当需要定义一组常量时,强烈建议使用枚举类。
若枚举类只有一个对象, 则可以作为单例模式的实现方式。

定义枚举类

方式一:JDK5.0之前自定义枚举类

/**
 * 自定义枚举类
 */
public class Season {
    //声明枚举类的属性 private final
    private final String seasonName;
    private final String seasonDetail;

    //私有化构造方法,并给对象的属性赋值
    private Season(String seasonName, String seasonDetail) {
        this.seasonName = seasonName;
        this.seasonDetail = seasonDetail;
    }

    //提供当前枚举类的多个对象: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("冬季","冰天雪地");

    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDetail() {
        return seasonDetail;
    }

    @Override
    public String toString() {
        return "Season{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDetail='" + seasonDetail + '\'' +
                '}';
    }
}
		//自定义枚举类调用
        Season spring = Season.SPRING;
        Season summer = Season.SUMMER;
        Season autumn = Season.AUTUMN;
        Season winter = Season.WINTER;
        System.out.println(spring.toString());
        System.out.println(summer.toString());
        System.out.println(autumn.toString());
        System.out.println(winter.toString());

方式二:JDK5.0,可以使用enum关键字定义枚举类
使用enum关键字定义枚举类
说明:定义的enum枚举类默认继承java.lang.Enum类

enum类中的常用方法

values()方法:返回枚举类型的对象数组。可以方便地遍历所有的枚举值。
valueOf(String value)方法:把一个字符串转换为对应的枚举类对象。要求字符串必须是枚举类对象的“名字”。如不是,会出现运行时异常:IllegalArgumentException。
toString()方法:返回当前枚举类对象常量的名称。
ordinal()方法:返回当前枚举常量的次序号,默认从0开始

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

情况一:实现接口,在enum类中实现抽象方法
情况二:让枚举类的对象分别实现接口中的抽象方法

public interface Info {
    void showInfo();
}
public enum Season1 implements Info{
    //声明当前枚举类的多个对象,多个对象之间用逗号隔开
    //情况二:各枚举对象分别实现接口的抽象方法
    SPRING("春季","春暖花开"){
        @Override
        public void showInfo() {
            System.out.println("这是春季的信息....");
        }
    },
    SUMMER("夏季","夏日炎炎") {
        @Override
        public void showInfo() {
            System.out.println("这是夏季的信息....");
        }
    },
    AUTUMN("秋季","秋高气爽") {
        @Override
        public void showInfo() {
            System.out.println("这是秋季的信息....");
        }
    },
    WINTER("冬季","冰天雪地") {
        @Override
        public void showInfo() {
            System.out.println("这是冬季的信息....");
        }
    };

    //声明枚举类的属性:private final
    private final String seasonName;
    private final String seasonDetail;

    //私有化构造方法,并给对象的属性赋值
    private Season1(String seasonName, String seasonDetail) {
        this.seasonName = seasonName;
        this.seasonDetail = seasonDetail;
    }


    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDetail() {
        return seasonDetail;
    }

    //情况一按正常方法实现接口即可
    // @Override
    // public void showInfo() {
    //     System.out.println("这是一个季节的信息....");
    // }

    // @Override
    // public String toString() {
    //     return "Season{" +
    //             "seasonName='" + seasonName + '\'' +
    //             ", seasonDetail='" + seasonDetail + '\'' +
    //             '}';
    // }
}
		 // enum关键字定义枚举类
        Season1 spring1 = Season1.SPRING;
        Season1 summer1 = Season1.SUMMER;
        Season1 autumn1 = Season1.AUTUMN;
        Season1 winter1 = Season1.WINTER;
        //toString()方法
        System.out.println(spring1.toString());
        System.out.println(summer1.toString());
        System.out.println(autumn1.toString());
        System.out.println(winter1.toString());
        //name()方法
        System.out.println(spring1.name());

        //Enum类常用方法
        // values()方法
        Season1[] values = Season1.values();
        for (Season1 value : values) {
            System.out.print(value + "\t");
        }
        System.out.println();
        //查看线程状态枚举类的枚举值
        Thread.State[] states = Thread.State.values();
        for (Thread.State state : states) {
            System.out.print(state + "\t");
        }
        System.out.println();

        //valueOf()方法 根据传入的字符串参数,返回对应名称的枚举类对象
        //如果不存在该对象,则报错IllegalArgumentException:参数非法异常
        Season1 season1 = Season1.valueOf("SPRING");
        // Season1 season2 = Season1.valueOf("WINNER1");
        System.out.println(season1);
        // System.out.println(season2);

        //ordinal()方法返回当前枚举常量的次序号,默认从0开始
        int ordinal = summer1.ordinal();
        System.out.println("ordinal:"+ordinal );

        //enum关键字实现的枚举类各对象分别实现接口的抽象方法
        spring1.showInfo();
        summer1.showInfo();
        autumn1.showInfo();
        winter1.showInfo();

注解(Annotation)

注解概述:从JDK5.0开始,Java增加了对元数据(MetaData)的支持,也就是注解。

Annotation是代码里的特殊标记,这些标记可以在编译,类加载,运行时被读取,并执行相应的处理。通过Annotation,程序员可以在不改变原有逻辑的情况下,在源文件中嵌入一些补充信息。代码分析工具、开发工具和部署工具可以通过这些补充信息进行验证或者部署。
Annotation可以像修饰符一样被使用,可用于修饰包,类,构造器,方法,成员变量,参数,局部变量的声明,这些信息被保存在Annotation的"name=value"对中。

JavaSE中,注解的使用目的比较简单,例如标记过时的功能,忽略警告等。在JavaEE/Android中注解占据了更重要的角色,例如用来配置应用程序的切面,代替JavaEE旧版中遗留的冗余代码和XML配置等。
未来开发模式都是基于注解,JPA基于注解,Spring2.5以上基于注解,Hibernate3.x以后也是基于注解,注解是一种趋势,一定程度上:框架=注解+反射+设计模式。

常见的Annotation示例

示例一:生成文档相关的注解
@author 作者
@version 版本号
@see 相关主题
@since 从哪个版本开始增加
@param 形参名 形参类型 形参说明 对参数的说明
@return 返回值类型 返回值说明 对返回值的说明
@exception 异常类型 异常说明 对可能抛出的异常进行说明
@param、@return、@exception只用于方法上

示例二:在编译时进行格式检查(JDK内置的三个基本注解)
@Override:限定重写父类方法,该注解只能用于方法。
@Deprecated:表示所修饰元素(类,方法等)已经过时。因为所修饰的结构危险或存在更好的选择。
@SuppressWarnings:抑制编译器警告。
例如:@SuppressWarnings(“unused”) ,抑制未使用警告。

示例三:跟踪代码的依赖性,实现替代配置文件的功能

自定义注解:参照@SuppressWarnings的定义

定义新的Annotation类型注解声明为:@interface 关键字。
Annotation的成员变量在定义中以无参数方法的形式声明。其方法名和返回值定义了该成员的名字和类型。我们称为配置参数。类型只能是八种基本数据类型、String类型、Class类型、enum类型、Annotation类型、以上所有类型的数组。
可在定义Annotation成员变量时指定初始值,指定成员变量的初始值可使用default关键字。
如果只有一个参数成员,建议使用参数名为value
如果定义的注解含有配置参数,使用时必须指定参数值,除非有默认值。格式是“参数名=参数值”,如果只有一个参数成员,且名称为value,可以省略“value=…”
没有成员变量定义的Annotation称为标记,包含成员变量的Annotation称为元数据。
注意:自定义注解必须配上注解的信息处理流程(使用反射)才有意义。

JDK提供的4种元注解

元注解:对现有的注解进行解释说明的注解
例如:@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}

1、Retention:只能用于修饰一个Annotation定义,指定该Annotation的生命周期,@Retention包含一个RetentionPolicy类型的成员变量。
@Retention时必须为该value成员变量指定值:
RetentionPolicy.SOURCE:在源文件中有效(即源文件保留),编译器直接丢弃这种策略的注解。
RetentionPolicy.CLASS:在class文件中有效(即class字节码文件保留),运行Java程序时,JVM不会保留注解。这是默认情况。
RetentionPolicy.RUNTIME:在运行时有效(即运行时保留),运行Java程序时,JVM会保留注解。程序可以通过反射获取该注解。

2、Target: 用于修饰Annotation定义,指定Annotation能用于修饰哪些程序元素
@Target也包含一个名为value的成员变量。
CONSTRUCTOR:描述构造器;
TYPE:描述类、接口(包括注解类型)或enum声明;
FIELD:描述域;
METHOD:描述方法;
PARAMETER:描述参数;
LOCAL_VARIABLE:描述局部变量;
ANNOTATION_TYPE:描述注解类型;
PACKAGE:描述包;
(JDK8开始)TYPE_PARAMETER:表示该注解能写在类型变量的声明语句中;
TYPE_USE:表示该注解能写在使用类型的任何语句中。

3、Documented指定被修饰的Annotation将被javadoc工具提取成文档。默认情况下javadoc不包括注解。定义为Documented的注解必须设置Retention值为RUNTIME。

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

JDK8新特性:可重复注解、类型注解

可重复注解:@Repeatable
在MyAnnotation上声明@Repeatable,成员值为MyAnnotations.class
在MyAnnotation的Target、Rententio等元注解需要与MyAnnotations相同。

类型注解:TYPE_PARAMETER:表示该注解能写在类型变量的声明语句中, TYPE_USE:表示该注解能写在使用类型的任何语句中。

import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;

@Repeatable(MyAnnotations.class)
@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target({TYPE,FIELD,METHOD,PARAMETER,CONSTRUCTOR,LOCAL_VARIABLE,TYPE_PARAMETER,TYPE_USE})
public @interface MyAnnotation {
    //方法名和返回值定义了成员的名字和类型
    String value() default "MyAnnotation";

}
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import static java.lang.annotation.ElementType.*;
import static java.lang.annotation.ElementType.LOCAL_VARIABLE;

@Retention(RetentionPolicy.RUNTIME)
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE,TYPE_PARAMETER,TYPE_USE})
public @interface MyAnnotations {
    MyAnnotation[] value();
}
		//自定义注解使用
        @MyAnnotation(value = "123")
        int num = 1;

        //元注解
        Class<Student> studentClass = Student.class;
        Annotation[] annotations = studentClass.getAnnotations();
        for (Annotation annotation : annotations) {
            System.out.println(annotation);
        }

        //可重复注解
        //JDK8之前的写法
        // @MyAnnotations({@MyAnnotation(value = "123"),@MyAnnotation(value = "456")})
        //JDK8写法,使用MyAnnotations定义MyAnnotation[] value()
        @MyAnnotation(value = "123")
        @MyAnnotation(value = "456")
        int i = 0;
//@Target加上TYPE_PARAMETER后可使用
public class Anno <@MyAnnotation T>{
    public void show() throws @MyAnnotation RuntimeException {
        //@Target加上TYPE_USE后可使用
        ArrayList<@MyAnnotation String> arrayList = new ArrayList<>();

    }
}

单元测试注意事项

要想正确地编写单元测试方法,需要满足:
所在的类必须是public的,非抽象的,包含唯一的无参构造器。
@Test标记的方法本身必须是public,非抽象的,非静态的,void无返回值,()无参数的

默认情况下,单元测试方法中Scanner失效,如何解决?
Help中Edit Custom VM Options 添加一行 -Deditable.java.test.console=true

Settings–Editor—Live Templates可以自定义测试方法的模板

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值