标签：not   his   ada   自定义   retention   body   开发人员   基本   参考   

什么是枚举类：

类的对象只有有限个，确定的。当需要定义一组常量时，强烈建议使用枚举类。若枚举只有一个对象, 则可以作为一种单例模式的实现方式。

枚举类的属性：

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

自定义枚举类：

1. 私有化类的构造器，保证不能在类的外部创建其对象

2. 在类的内部创建枚举类的实例。声明为： public static final

3. 对象如果有实例变量，应该声明为private final，并在构造器中初始化

   class Season {
   	private final String SEASONNAME;// 季节的名称
   	private final String SEASONDESC;// 季节的描述
   
   	private Season(String seasonName, String seasonDesc) {
   		this.SEASONNAME = seasonName;
   		this.SEASONDESC = seasonDesc;
   	}
   
   	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("冬", "雪花飞舞");
   }
   

使用enum定义枚举类：

使用说明:
使用enum定义的枚举类默认继承了java.lang.Enum类，因此不能再继承其他类
枚举类的构造器只能使用private权限修饰符
枚举类的所有实例必须在枚举类中显式列出(,分隔 ;结尾)。列出的实例系统会自动添加public static final修饰
必须在枚举类的第一行声明枚举类对象
JDK1.5中可以在switch表达式中使用Enum定义的枚举类的对象作为表达式,case子句可以直接使用枚举值的名字,无需添加枚举类作为限定。

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

interface Info {
	void show();
}

// 使用enum关键字枚举类
enum Season1 implements Info {
	// 1.提供当前枚举类的对象，多个对象之间用","隔开，末尾对象";"结束
    // 1.0实现的接口的的方法可以让每个枚举类对象分别重写
	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("大约在冬季");
		}
	};

	// 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.可以获取枚举类对象的属性
	public String getSeasonName() {
		return seasonName;
	}

	public String getSeasonDesc() {
		return seasonDesc;
	}
}

Enum类的主要方法：

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

注解(Annotation)概述：

从JDK5.0 开始,Java增加了对元数据(MetaData)的支持,也就是Annotation(注解)，Annotation其实就是代码里的特殊标记, 这些标记可以在编译,类加载,运行时被读取,并执行相应的处理。通过使用Annotation,开发人员可以在不改变原有逻辑的情况下, 在源文件中嵌入一些补充信息。代码分析工具、开发工具和部署工具可以通过这些补充信息进行验证或者进行部署。Annotation 可以像修饰符一样被使用,可用于修饰包,类,构造器,方法,成员变量,参数,局部变量的声明,这些信息被保存在Annotation的 “name=value”对中。在JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在JavaEE/Android中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗代码和XML配置等。

常见的Annotation示例：

使用Annotation时要在其前面增加@符号,并把该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: 抑制编译器警告

示例三：跟踪代码依赖性，实现替代配置文件功能
Servlet3.0提供了注解(annotation),使得不再需要在web.xml文件中进行Servlet的部署
spring框架中关于“事务”的管理

自定义Annotation：

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

JDK中的元注解：

JDK的元Annotation用于修饰其他Annotation定义，JDK5.0提供了4个标准的meta-annotation类型，
分别是：
Retention
Target
Documented
Inherited

@Retention: 用于指定该Annotation的生命周期, @Rentention包含一个RetentionPolicy 类型的成员变量,使用@Rentention时必须为该value成员变量指定值:
RetentionPolicy.SOURCE:在源文件中有效（即源文件保留），编译器直接丢弃这种策略的注释
RetentionPolicy.CLASS:在class文件中有效（即class保留），当运行Java程序时,JVM不会保留注解。这是默认值
RetentionPolicy.RUNTIME:在运行时有效（即运行时保留），当运行Java程序时,JVM会保留注释。程序可以通过反射获取该注释。

public enum RetentionPolicy {
	SOURCE, CLASS, RUNTIME
}

@Retention(RetentionPolicy.SOURCE)
@interface MyAnnotation1 {
}

@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation2 {
}

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

取值ElementType
CONSTRUCTOR	用于描述构造器
FIELD	用于描述域
LOCAL_VARIABLE	用于描述局部变量
METHOD	用于描述方法
PACKAGE	用于描述包
PARAMETER	用于描述参数
TYPE	用于描述类、接口（包括注解类型）或enum声明

@Documented:用于指定被该元Annotation修饰的Annotation类将被javadoc工具提取成文档。默认情况下，javadoc是不包括注解的。定义为Documented的注解必须设置Retention值为RUNTIME。

@Inherited: 被它修饰的Annotation将具有继承性。如果某个类使用了被@Inherited修饰的Annotation,则其子类将自动具有该注解。
比如：如果把标有@Inherited注解的自定义的注解标注在类级别上，子类则可以继承父类类级别的注解，实际应用中，使用较少

利用反射获取注解信息：

JDK5.0在java.lang.reflect包下新增了AnnotatedElement接口,该接口代表程序中可以接受注解的程序元素。当一个 Annotation 类型被定义为运行时Annotation 后,该注解才是运行时可见,当class文件被载入时保存在class文件中的Annotation才会被虚拟机读取程序可以调用 AnnotatedElement对象的如下方法来访问Annotation信息：

<T extends Annotation> T getAnnotation(Class<T> annotationClass);
Annotation[] getAnnotations();
Annotation[] getDeclaredAnnotations();

009Java枚举类和注解

标签：not   his   ada   自定义   retention   body   开发人员   基本   参考   

原文地址：https://www.cnblogs.com/088-p/p/14588774.html