枚举
一、枚举类的使用
【说明】
- 类的对象只有有限个,确定的(可以列举完全的数据),我们称此类为枚举类;
假如有一个星期类,它的对象只有星期一到星期日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接口;自定义注解必须配上注解的信息处理流程(使用反射)才有意义;
- 定义新的Annotation类型使用 @interface 关键字;
- 成员变量以无参方法的形式来声明,其方法名和返回值定义该成员的名字和类型。我们称为配置参数;类型可以是:八种基本数据类型,String类型,Class类型,enum类型,Annotation类型及以上所有类型的数组类型;
- 可以指定成员的默认值,使用default定义;
- 如果自定义注解没有成员,表明是一个标记;例如:@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;
}
}