枚举

一、枚举类的使用

【说明】

  • 类的对象只有有限个,确定的(可以列举完全的数据),我们称此类为枚举类;

假如有一个星期类,它的对象只有星期一到星期日7个对象,可以把它定义为枚举类;

  • 当需要定义一组常量时,建议使用枚举类;
  • 如果枚举类中只有一个对象,则可以当作单例模式的实现方式;
  • 枚举类对象可以作为“ swich(x) {} ”中的变量;

二、枚举类的定义

1、方式一:jdk5.0之前,自定义枚举类

【自定义枚举类】

public 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、其他2:提供toString()
	
	@Override
	public String toString() {
		return "Season{" +
				"seasonName='" + seasonName + '\'' +
				", seasonDesc='" + seasonDesc + '\'' +
				'}';
	}
}

【使用】

public class enumTest {
	public static void main(String[] args) {
		Season spring = Season.SPRING;
		System.out.println(spring);//Season{seasonName='春天', seasonDesc='春暖花开'}
	}
}

2、方式二:jdk5.0时,可以使用enum关键字定义枚举类

默认继承于 class java.lang.Enum类

【enum关键字定义】

public enum Season1{
   //1、提供当前枚举类的对象,多个对象之间用“,”隔开,末尾对象“;”结束
   SPRING ("春天", "春暖花开"),
    
   SUMMER ("夏天", "真热"),
   AUTUMN ("秋天", "有点小冷"),
   WINTER ("冬天", "下雪了");
    
   //2、声明Season对象的属性:private final 修饰;
   private final String seasonName;
   private final String seasonDesc;
   
   //3、私有化类的构造器,并给对象属性赋值;
   
   private Season1(String seasonName, String seasonDesc) {
      this.seasonName = seasonName;
      this.seasonDesc = seasonDesc;
   }
  
   
   //其他:获取枚举类对象的属性
   
   public String getSeasonName() {
      return seasonName;
   }
   
   public String getSeasonDesc() {
      return seasonDesc;
   }

【使用】

public static void main(String[] args) {
		Season1 summer = Season1.SUMMER;
		//默认继承于Enum类的toString()方法;
		System.out.println(summer);//输出SUMMER, toString输出为对象名;
//		System.out.println(Season1.class.getSuperclass()); //父类class java.lang.Enum

如果不需要属性,直接写对象名,即创建了4个无参构造的对象,并且是静态常量;

public enum Season1{
   SPRING ,SUMMER ,AUTUMN ,WINTER;
}

三、Enum类的常用方法

class java.lang.Enum类的常用方法,使用enum关键字定义的枚举类可以调用;

【常用方法】

values()

返回枚举类型的对象数组。该方法可以遍历所有的枚举值;

valueof(String str)

可以把一个字符串转为对应的枚举类对象。要求字符串必须是枚举类对象的“名字”。如不是,会有运行时异常:IIIegalArgumentException;

toString():

返回当前枚举类对象常量的名称;

【代码示例】

public static void main(String[] args) {
		Season1 summer = Season1.SUMMER;
		//1、toString()
		System.out.println(summer);//输出SUMMER, toString输出为对象名;
//		System.out.println(Season1.class.getSuperclass()); //class java.lang.Enum
		
		//2、values()
		Season1[] values = Season1.values();
		for (Season1 value : values) {
			System.out.println(value);
		}
		
		
		//3、valueof(String objName):返回枚举类中对象名是objName的对象;
		//如果没有objName的枚举类对象,则抛出异常;
		Season1 spring = Season1.valueOf("SPRING");
		System.out.println(spring); //输出 SPRING
		
    	//线程状态也是一个枚举类;
//		Thread.State[] values1 = Thread.State.values();
//		for (Thread.State state : values1) {
//			System.out.println(state);
//		}
	}

四、枚举类实现接口

情况一:实现接口,在enum类中实现抽象方法;(和正常类一般)

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

enum  Season1 implements Info{
	//每个对象都实现Info接口中的抽象show()方法;
	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("冬天来了!");
	}
	};

【测试】

Season1 summer = Season1.SUMMER;
summer.show(); //输出 夏天来了!

注解

一、注解概述

Java 注解(Annotation)又称 Java 标注,是 JDK5.0 引入的一种注释机制;

【说明】

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

二、常见的Annotation

1、生成文档相关的注解:

@author:作者;

@since:从xx版本加入的;

@see:另请参考;

@param:形参;

@return:返回值;

@throws或@exception:异常;

2、在编译时进行格式检查(JDK内置的三个基本注解):

@Override:检测被该注解标注的方法是否是继承自父类(接口)的,它只能用在方法上面,会让编译器对这个方法进行格式检查,是否满足重写的要求;不满足编译不通过;

@Deprecated:该注解标注的内容,表示已过时;但是还能用;

@SuppressWarnings:抑制编译器警告,一般传递参数 all,压制所有的警告;

3、跟踪代码依赖性,实现替代配置文件功能;

三、自定义Annotation

自动继承了java.lang.annotation.Annotation接口;自定义注解必须配上注解的信息处理流程(使用反射)才有意义;

  1. 定义新的Annotation类型使用 @interface 关键字;
  2. 成员变量以无参方法的形式来声明,其方法名和返回值定义该成员的名字和类型。我们称为配置参数;类型可以是:八种基本数据类型,String类型,Class类型,enum类型,Annotation类型及以上所有类型的数组类型;
  3. 可以指定成员的默认值,使用default定义;
  4. 如果自定义注解没有成员,表明是一个标记;例如:@Override;
public @interface MyAnnotation {
	String value() default "Hello";
}

【注意】

如果注解有成员,在使用注解时,需要指明成员的值;(如果使用默认值则不需要指明)

//指明成员的值
@MyAnotation(value="Hi")
class Test{}

//使用默认值
@MyAnotation
class Test{}

自定义注解通常会指明两个元注解:Retention、Target;

四、JDK中的元注解

修饰其他注解的注解;即用于修饰注解的定义;

  • @Retention :指定所修饰的Annotation的生命周期:
  • SOURCE(只保存在代码);
  • CLASS(编入class文件中);
  • RUNTIME(在运行时可以通过反射访问);
//@Retention的成员变量 RetentionPolicy枚举类 定义该三种状态;
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
	String value() default "hello"; 
}
  • @Target:用于指定被修饰的Annotation能用于修饰哪些程序元素;例如:
    TYPE:指定被修饰的Annotation能用于修饰类,接口,枚举类;
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
public @interface MyAnnotation {
	String value() default "hello"; 
}
  • @Documented :表示所修饰的注解在被javadoc解析时,将会被保留下;(javadoc默认是不包含注解的)
  • @Inherited :被它修饰的Annotation将具有继承性;(即被它修饰的Annotation修饰在一个父类时,它的子类也自动被该Annotation修饰)

JDK1.8新特性;

  • @Repeatable : 修饰某注解可以在同一个声明上使用多次;
①在MyAnnotation上声明@Repeatable,成员值为MyAnnotations.class;
②MyAnnotation的元注解要和MyAnnotations相同;

@Repeatable(MyAnnotations.class)
public @interface MyAnnotation {}    
    
public @interface MyAnnotations {
	MyAnnotation[] values;
}
  • @Target的ElementType成员新增了 “TYPE_PARAMETER”,“TYPE_USE”;
  • “TYPE_PARAMETER”:可修饰泛型的类型;
  • “TYPE_USE”:可修饰强制类型,thows 的异常类型等;
@Target({ElementType.TYPE_PARAMETER,TYPE_USE})
public @interface MyAnnotation {}

class Test<@MyAnnotation T>{
    public void show(){
        int a = (@MyAnnotation int) 12L;
    }
}