java 枚举注释_Java笔记---枚举类和注解

Java笔记---枚举类和注解

一、枚举类

自定义枚举类

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

class Seasons {

//1. 声明Seasons对象的属性

private final String SeasonName;

private final String SeasonDescrp;

//2. 私有化类的构造器， 并给对象赋值初始化

private Seasons(String SeasonName, String SeasonDescrp) {

this.SeasonDescrp = SeasonDescrp;

this.SeasonName = SeasonName;

}

//3. 提供当前枚举类的多个对象 public static final "枚举类的名字"

public static final Seasons SPRING = new Seasons("SPRING", "春天");

public static final Seasons SUMMER = new Seasons("SUMMER", "夏天");

public static final Seasons AUTUMN = new Seasons("AUTUMN", "秋天");

public static final Seasons WINTER = new Seasons("WINTER", "冬天");

//4. 获取枚举类对象的属性

public String getSeasonName() {

return SeasonName;

}

public String getSeasonDescrp() {

return SeasonDescrp;

}

@Override

public String toString() {

return "Seasons{" +

"SeasonName='" + SeasonName + '\'' +

", SeasonDescrp='" + SeasonDescrp + '\'' +

'}';

}

}

调用这个类：

public class TestEnum {

public static void main(String[] args) {

Seasons spring = Seasons.SPRING;

System.out.println(spring);

}

}

Seasons{ SeasonName='SPRING', SeasonDescrp='春天'}

以上为该自定义枚举类的输出结果

方式二：JDK5.0之后引入关键字enum定义枚举类

enum Season {

//多个对象之间用逗号，最后一个对象用分号结束

SPRING("SPRING", "春天"),

SUMMER("SUMMER", "夏天"),

AUTUMN("AUTUMN", "秋天"),

WINTER("WINTER", "冬天");

//下面的声明和方式一并无多大差别

//1. 声明Seasons对象的属性

private final String SeasonName;

private final String SeasonDescrp;

//2. 私有化类的构造器， 并给对象赋值初始化

private Season(String SeasonName, String SeasonDescrp) {

this.SeasonDescrp = SeasonDescrp;

this.SeasonName = SeasonName;

}

}

那么，枚举类为何没有重写toString()方法呢？

public class TestEnum {

public static void main(String[] args) {

Season spring = Season.SPRING;

System.out.println(spring);

System.out.println(Season.class.getSuperClass());

}

}

SPRING

class java.lang.Enum

以上呢就是输出结果了！可见，这个类中的toString()方法已经再Enmu类中重写过了

Enum类中的常用方法

values()：返回枚举类型的对象数组。该方法可以很便利的遍历所有枚举值。

valuesOf(String objName)：根据提供的objName，返回一个对象名是objName的枚举类型的对象

toString()：返回当前常量的名称

public class TestEnum {

public static void main(String[] args) {

Season spring = Season.SPRING;

//toString()方法

System.out.println(spring);

//values()方法

Season[] values = Season.values();

for (Season temp : values) {

System.out.println(temp);

}

System.out.println(Season.class.getSuperClass());

//valueOf(String objName)

//如果找不到与objName同名的对象时候，会抛出一个异常IllegalArgumentException

Season winter = Season.valueOf("WINTER");

System.out.println(winter);

}

}

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

情况一：实现接口。再enum类中实现接口

interface Info {

//显示对象的名字

void show();

}

enum Season implements Info {

//多个对象之间用逗号，最后一个对象用分号结束

SPRING("SPRING", "春天"),

SUMMER("SUMMER", "夏天"),

AUTUMN("AUTUMN", "秋天"),

WINTER("WINTER", "冬天");

//1. 声明Seasons对象的属性

private final String SeasonName;

private final String SeasonDescrp;

//2. 私有化类的构造器， 并给对象赋值初始化

private Season(String SeasonName, String SeasonDescrp) {

this.SeasonDescrp = SeasonDescrp;

this.SeasonName = SeasonName;

}

@Override

public void show() {

System.out.println("这是一个季节");

}

}

情况二：让枚举类的对象，分别实现接口中的方法

interface Info {

//显示对象的名字

void show();

}

enum Season implements Info {

//多个对象之间用逗号，最后一个对象用分号结束

SPRING("SPRING", "春天"){

@Override

public void show() {

//春天的方法

}

},

SUMMER("SUMMER", "夏天") {

@Override

public void show() { }

},

AUTUMN("AUTUMN", "秋天") {

@Override

public void show() { }

},

WINTER("WINTER", "冬天") {

@Override

public void show() { }

};

//1. 声明Seasons对象的属性

private final String SeasonName;

private final String SeasonDescrp;

//2. 私有化类的构造器， 并给对象赋值初始化

private Season(String SeasonName, String SeasonDescrp) {

this.SeasonDescrp = SeasonDescrp;

this.SeasonName = SeasonName;

}

}

让每一个对象实现一次接口方法，使得每个对象有不同的动作。

二、注解

​

Annotation是在代码里的特殊标记这些标记可以在编译时，类加载时被读取，并作出相应的处理。不改变原有逻辑的情况下，在程序中添加一些补充信息。

应用

应用一：在生成文档中使用注解(javadoc)

@author @param @return @version 等等。

应用二：编译时进行格式检查(JDK内置的三个注解)

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

@Deprecated 表示所修饰的怨妇已经过时。通常是因为所修饰的结构危险或者存在更好的选择

@SuppressWarnings 抑制编译器警告

class Person {

public void walk() {

System.out.println("人走路");

}

//下面的用于标记，这个方法已经过时了

@Deprecated

public void eat() {

System.out.println("人吃饭");

}

}

interface Info {

void show();

}

class Student extends Person implements Info {

//标记用于重写父类中的方法，以及实现接口中的方法

@Override

public void walk() { System.out.println("学生走路"); }

@Override

public void show() { System.out.println("我是学生"); }

public static main(String[] args) {

//在代码中，创建的变量未使用会有警告Waring

//这里的unused就是表示忽略，没使用这个警告的

@SuppressWarnings("unused")

int num = 100;

//System.out.println(num);

//下面的这种"rawtypes"适用于使用泛型的时候并没有选取类型的警告

@SuppressWarnings({"unused", "rawtypes"})

ArrayList list = new ArrayList();

}

}

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

Servlet3.0提供了注解，使得不需要在web.xml文件中进行Servlet的部署

自定义注解

自定义新注解使用 @interface 关键字

定义 Annotation 成员变量时，以 无参数方法 的形式来声明。

只有一个参数成员，建议使用value命名

如果注解没有成员表明是一个标识作用

使用注解的时候，需要设定一个值，如果已经有了默认值值，那么，就可以不用手写默认值了。

自定义的注解，需要配上信息处理流程(使用反射)才有意义。

通常会指明两个元注解，@Retention 和 @Target

public @interface CustomAnnotation {

//只有一个值的话值的名字叫做value就很好

//String value();

//当然也可以使用default设置为默认值

String value() default "Hello";

}

JDK中的元注解

元注解：对于现有注解进行修饰的注解。

JDK5.0 提供了4个标准的元注解(meta-annotation)类型：

Retention：指明所有修饰的 Annotation 的生命周期，其中包含了一个RetentionPolicy类型的成员变量。

相关的Java SE API

从上面可以看出只有 RUNTIME 才可以使用反射

Target：用于修饰 Annotation 的定义，用于 指定 被修饰的 Annotation 能用于修饰那些程序元素

相关的Java SE API

Documented：用于指定被该元注解修饰的 Annotation 类将会被javadoc提取为相应的文档，默认情况下Javadoc是不包括注解的

Inherited：被它修饰的 Annotation 将具有继承性。如果某个类使用了被@Inherited标记的Annotation那么子类中也会继承父类中的，这个Annotation。

通过反射获取注解信息

JDK8 中注解的新特性

可重复注解

//JDK8.0之前想要使用重复注解的方法

public @interface MyAnnotations {

MyAnnotation[] value();

}

public @interface MyAnnotation {

String[] value();

}

@MyAnnotations({

@MyAnnotation(value = "hello"),

@MyAnnotation(value = "hi")

})

class Person {

public void walk() {

System.out.println("人走路");

}

//下面的用于标记，这个方法已经过时了

@Deprecated

public void eat() {

System.out.println("人吃饭");

}

}

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

MyAnnotation的Target和Retention与MyAnnotations相同

//这个是目标注解

import java.lang.annotation.*;

//使用注解@Rpeatable与这个注解的容器注解产生关联

@Repeatable(MyAnnotations.class)

@Retention(RetentionPolicy.RUNTIME)

public @interface MyAnnotation {

String value() default "hello";

}

//这个是目标注解的容器注解

import java.lang.annotation.*;

@Retention(RetentionPolicy.RUNTIME)

public @interface MyAnnotations {

MyAnnotation[] value();

}

//这是使用

@MyAnnotation("Hello")

@MyAnnotation("hi")

class Person {

public void walk() {

System.out.println("人走路");

}

//下面的用于标记，这个方法已经过时了

@Deprecated

public void eat() {

System.out.println("人吃饭");

}

}

通过上下的比较，可以发现，JDK8的新特性是对原来注解嵌套的简化。