第十章----枚举类与注解

一、枚举类的使用

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

|-定义枚举类

①JDK1.5之前需要自定义枚举类
②JDK 1.5 新增的 enum 关键字用于定义枚举类

例一:

package com.atguigu.java;

public class SeasonTest {
    public static void main(String[] args) {
        Season spring = Season.SPRING;
        System.out.println(spring);
    }
}


//自定义枚举类
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 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 "Seaaon{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

例二:

package com.atguigu.java;

//使用enum关键字来定义枚举类
//说明:定义的枚举类默认继承于class java.lang.Enum类
public class SeasonTest1 {
    public static void main(String[] args) {
        Season1 summer = Season1.SUMMER;
        System.out.println(summer);


        System.out.println(Season1.class.getSuperclass());
    }
}

//使用enum定义枚举类
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;
    }


    //4.其他诉求1:获取枚举类对象的属性


    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }
    //4.其他诉求2:提供toString()

    @Override
    public String toString() {
        return "Seaaon1{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

|-Enum的常用方法:

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

例:

package com.atguigu.java;

//使用enum关键字来定义枚举类
//说明:定义的枚举类默认继承于class java.lang.Enum类
public class SeasonTest1 {
    public static void main(String[] args) {
        Season1 summer = Season1.SUMMER;
        
        //toString():
        System.out.println(summer.toString());


//        System.out.println(Season1.class.getSuperclass());
        System.out.println("--------------------------------");
       
        //values():
        Season1[] values = Season1.values();
        for (int i = 0; i < values.length; i++) {
            System.out.println(values[i]);
        }
        System.out.println("--------------------------------");
        Thread.State[] values1 = Thread.State.values();
        for (int i = 0; i < values1.length; i++) {
            System.out.println(values1[i]);
        }
      
        //values(String objName):返回枚举类中对象名是objName的对象
        //如果没有objname的枚举类对象,则抛异常:IllegalArgumentException
        Season1 winter = Season1.valueOf("WINTER");
        //Season1 winter = Season1.valueOf("WINTER1");
        System.out.println(winter);
    }
}


//使用enum定义枚举类
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;
    }


    //4.其他诉求1:获取枚举类对象的属性


    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }
    //4.其他诉求2:提供toString()

    @Override
    public String toString() {
        return "Seaaon1{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

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

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

例:

package com.atguigu.java;

//使用enum关键字来定义枚举类
//说明:定义的枚举类默认继承于class java.lang.Enum类
public class SeasonTest1 {
    public static void main(String[] args) {
        Season1 summer = Season1.SUMMER;


        //toString():
        System.out.println(summer.toString());


//        System.out.println(Season1.class.getSuperclass());
        System.out.println("--------------------------------");


        //values():
        Season1[] values = Season1.values();
        for (int i = 0; i < values.length; i++) {
            System.out.println(values[i]);
            values[i].show();
        }
        System.out.println("--------------------------------");
        Thread.State[] values1 = Thread.State.values();
        for (int i = 0; i < values1.length; i++) {
            System.out.println(values1[i]);
        }

        //values(String objName):返回枚举类中对象名是objName的对象
        //如果没有objname的枚举类对象,则抛异常:IllegalArgumentException
        Season1 winter = Season1.valueOf("WINTER");
        //Season1 winter = Season1.valueOf("WINTER1");
        System.out.println(winter);
        winter.show();
    }
}

interface Info {
    void show();
}


//使用enum定义枚举类
enum Season1 implements Info {
    //1.提供当前枚举类的多个对象多个对象之间用“,”隔开,末尾对象“;”结束
    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;


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


    //4.其他诉求1:获取枚举类对象的属性


    public String getSeasonName() {
        return seasonName;
    }


    public String getSeasonDesc() {
        return seasonDesc;
    }
    //4.其他诉求2:提供toString()


    @Override
    public String toString() {
        return "Seaaon1{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }

//    @Override
//    public void show() {
//        System.out.println("这是一个季节!");
//    }
}

二、注解(Annotation)

从 JDK 5.0 开始Java 增加了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的部署:
@WebServlet("/login")
public class LoginServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {}
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
doGet(request, response);
    } 
}

例:

package com.atguigu.java1;

import java.util.ArrayList;
import java.util.Date;

public class AnnotationTest {
    public static void main(String[] args) {
        Person p = new Student();
        p.walk();
        
        Date date = new Date(2020, 10, 11);
        System.out.println(date);


       @SuppressWarnings("unused")
        int num = 10;
        @SuppressWarnings({"unused","rawtypes"})
        ArrayList list = new ArrayList();
    }
}


class Person {
    private String name;
    private int age;


    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }

    public Person() {
    }


    public void walk() {
        System.out.println("人走路!");
    }


    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() {

    }
}

|-自定义注解

参照@SuppressWarnings("unused")定义
①注解声明为: @interface
②内部定义成员,通常使用value表示
③可以指定成员的默认值,使用default定义
④如果自定义注解没有成员,表明是一个标识作用
如果注解有成员,在使用注解时,要指明成员的值
自定义注解通常都会指明两个注解:Retention、Target

例:

package com.atguigu.java1;

public @interface MyAnnotation {
    String value() default "hello";
}

|-JDK中的元注解

对现有的注解进行解释说明的注解
Retention:用于指所修饰Annotation 的生命周期:SOURCE\CLASS(默认行为)\RUNTIME
           只有声明为RUNTIME生命周期的注解,才能通过反射获取
Target:用于指定被修饰的Annotation 能用于修饰哪些程序元素
------------------------------如下出现的频率较低----------------------------------------------
Documented:表示所修饰的注解在被javadoc解析时,保留下来
Inherited:被它修饰的Annotation 将具有继承性。

例:

package com.atguigu.java1;

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

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

@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
public @interface MyAnnotation {
    String value() default "hello";
}
package com.atguigu.java1;
import org.junit.Test;
import java.lang.annotation.Annotation;

public class AnnotationTest {
@Test
public void testGetAnnotation() {
    Class clazz = Student.class;
    Annotation[] annotations = clazz.getAnnotations();
    for (int i = 0; i < annotations.length; i++) {
        System.out.println(annotations[i]);
    }
}
}

|-Java 8新特性:
可重复注解:

①在MyAnnotation上声明@Repeatable,成员值为MyAnnotations.class
②MyAnnotation的Target和Retention和MyAnnotations相同

类型注解:

ElementType.TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中(如:泛型声明)。
ElementType.TYPE_USE 表示该注解能写在使用类型的任何语句中。

例:

@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, TYPE_PARAMETER, TYPE_USE})
public @interface MyAnnotation {
    String value() default "hello";
}
class Generic<@MyAnnotation T> {
    public void show() throws @MyAnnotation RuntimeException{  
        ArrayList<@MyAnnotation String> list = new ArrayList<>();
        
        int num =(@MyAnnotation int) 10L;
    }
}
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值