012Java基础之枚举及注解

1、枚举

在设计类似于季节这种属性值是有限并且固定的类时,如果安装传统方法,在创建对象的时候就会出现乱象,我们需要想办法来规避这种乱象
在这里插入图片描述

package com.francis.enumeration_;

/**
 * @author Francis
 * @create 2021-07-04 11:40
 */
public class Enumerantion01 {
    public static void main(String[] args) {
        //使用
        Season spring = new Season("春天", "温暖");
        Season winter = new Season("冬天", "寒冷");
        Season summer = new Season("夏天", "炎热");
        Season autumn = new Season("秋天", "凉爽");
        // autumn.setName("XXX");
        // autumn.setDesc("非常的热..");
        //因为对于季节而已,他的对象(具体值),是固定的四个,不会有更多
        //按这个设计类的思路,不能体现季节是固定的四个对象
        //因此,这样的设计不好===> 枚举类[枚: 一个一个 举: 例举 , 即把具体的对象一个一个例举出来的类
        // 就称为枚举类]
        Season other = new Season("红天", "~~~");
    }
}
class Season {//类
    private String name;
    private String desc;//描述
    public Season(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getDesc() {

        return desc;
    }

    public void setDesc(String desc) {
        this.desc = desc;
    }
}
1、枚举概述

(1)枚举是一组常量的组合
(2)可以这样理解,枚举属于一种特殊的类,里面只包含一组有限的特定的对象

2、枚举实现方式

(1)自定义类实现枚举
(2)使用enum关键字实现枚举

1、自定义类实现枚举

(1) 将构造器私有化,目的防止 直接 new
(2) 去掉 setXxx 方法, 防止属性被修改
(3) 在 Season 内部,直接创建固定的对象
(4) 优化,可以加入 final 修饰符

package com.francis.enumeration_.enum02;

/**
 * @author Francis
 * @create 2021-07-04 11:55
 */
public class Enumeration02 {
        public static void main(String[] args) {
            System.out.println(Season.AUTUMN);
            System.out.println(Season.SPRING);
        }
    }
    //演示字定义枚举实现
    class Season {//类
        private String name;
        private String desc;//描述
        //定义了四个对象, 固定.
        public static final Season SPRING = new Season("春天", "温暖");
        public static final Season WINTER = new Season("冬天", "寒冷");
        public static final Season AUTUMN = new Season("秋天", "凉爽");
        public static final Season SUMMER = new Season("夏天", "炎热");
        //1. 将构造器私有化,目的防止 直接 new
        //2. 去掉 setXxx 方法, 防止属性被修改
        //3. 在 Season 内部,直接创建固定的对象
        //4. 优化,可以加入 final 修饰符
        private Season(String name, String desc) {
            this.name = name;
            this.desc = desc;
        }
        public String getName() {
            return name;
        }
        public String getDesc() {
            return desc;
        }
        @Override
        public String toString() {
            return "Season{" +
                    "name='" + name + '\'' +
                    ", desc='" + desc + '\'' +
                    '}';
        }
    }

小技巧
(1)对枚举对象或者属性使用final+static共同修饰,实现底层优化
(2)枚举对象名通常使用全部大写,常量的命名规范
(3)枚举对象根据需要,也可以有多个属性

2、使用enum关键字实现枚举

(1)使用关键字 enum 替代 class
(2) public static final Season SPRING = new Season(“春天”, “温暖”) 直接使用SPRING(“春天”, “温暖”) 解读 常量名(实参列表)
(3)如果有多个常量(对象), 使用 ,号间隔即可
(4)如果使用 enum 来实现枚举,要求将定义常量对象,写在前面
(5)如果我们使用的是无参构造器,创建常量对象,则可以省略 ()
在这里插入图片描述

package com.francis.enumeration_;

/**
 * @author Francis
 * @create 2021-07-04 12:07
 */
public class Enumeration03 {
        public static void main(String[] args) {
            System.out.println(Season2.AUTUMN);
            System.out.println(Season2.SUMMER);
        }
    }
    //演示使用 enum 关键字来实现枚举类
    enum Season2 {//类
//定义了四个对象, 固定. // public static final Season SPRING = new Season("春天", "温暖");
// public static final Season WINTER = new Season("冬天", "寒冷");
// public static final Season AUTUMN = new Season("秋天", "凉爽");
// public static final Season SUMMER = new Season("夏天", "炎热");
//如果使用了 enum 来实现枚举类
//1. 使用关键字 enum 替代 class
//2. public static final Season SPRING = new Season("春天", "温暖") 直接使用
// SPRING("春天", "温暖") 解读 常量名(实参列表)
//3. 如果有多个常量(对象), 使用 ,号间隔即可
//4. 如果使用 enum 来实现枚举,要求将定义常量对象,写在前面
//5. 如果我们使用的是无参构造器,创建常量对象,则可以省略 ()
        SPRING("春天", "温暖"),
        WINTER("冬天", "寒冷"),
        AUTUMN("秋天", "凉爽"),
        SUMMER("夏天", "炎热")/*, What()*/;
        private String name;
        private String desc;//描述
        private Season2() {//无参构造器
        }
        private Season2(String name, String desc) {
            this.name = name;
            this.desc = desc;
        }
        public String getName() {
            return name;
        }
        public String getDesc() {
            return desc;
        }
        @Override
        public String toString() {
            return "Season{" +
                    "name='" + name + '\'' +
                    ", desc='" + desc + '\'' +
                    '}';
        }

}

注意事项和细节
(1)当我们使用 enum 关键字开发一个枚举类时,默认会继承 Enum 类, 而且是一个 final 类
(2) 传统的 public static final Season2 SPRING = new Season2(“春天”, “温暖”); 简化成 SPRING(“春天”, “温暖”), 这里必
须知道,它调用的是哪个构造器.
(3) 如果使用无参构造器 创建 枚举对象,则实参列表和小括号都可以省略
(4)当有多个枚举对象时,使用,间隔,最后有一个分号结尾
(5) 枚举对象必须放在枚举类的行首.

3、enum的常用方法

枚举类用关键字enum实现时,会隐式继承Enum类,这样我们就可以使用Enum的方法
在这里插入图片描述
values方法返回所有的定义的枚举对象
注意,emun不能继承,但能实现接口

2、注解(annotation)

(1)注解(Annotation)也被称为元数据(Metadata),用于修饰解释 包、类、方法、属性、构造器、局部变量等数据信息。
(2) 和注释一样,注解不影响程序逻辑,但注解可以被编译或运行,相当于嵌入在代码中的补充信息。
(3) 在 JavaSE 中,注解的使用目的比较简单,例如标记过时的功能,忽略警告等。在 JavaEE 中注解占据了更重要的角
色,例如用来配置应用程序的任何切面,代替 java EE 旧版中所遗留的繁冗代码和 XML 配置等。

1、基本的annotation介绍

使用 Annotation 时要在其前面增加 @ 符号, 并把该 Annotation 当成一个修饰符使用。用于修饰它支持的程序元素
三个基本的 Annotation:
(1) @Override: 限定某个方法,是重写父类方法, 该注解只能用于方法

package com.francis.javase;

/**
 * @author Francis
 * @create 2021-07-14 21:30
 */
public class NormalAnnotation {

        public static void main(String[] args) {
            Father son= new Son();
            son.fly();
        }
    }
    class Father{//父类
        public void fly(){
            System.out.println("Father fly...");
        }
        public void say(){}
    }
    class Son extends Father {//子类
      
//1. @Override 注解放在 fly 方法上,表示子类的 fly 方法时重写了父类的 fly
//2. 这里如果没有写 @Override 还是重写了父类 fly
//3. 如果你写了@Override 注解,编译器就会去检查该方法是否真的重写了父类的
// 方法,如果的确重写了,则编译通过,如果没有构成重写,则编译错误
//4. 看看 @Override 的定义
// 解读: 如果发现 @interface 表示一个 注解类
/*
@Target(ElementType.METHOD)//指定该类可以作用的范围,例如这里指明可作用于方法;@Target是修饰注解的注解,称为元注解
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}
*/
        @Override //说明
        public void fly() {
            System.out.println("Son fly....");
        }
        @Override
        public void say() {}
    }

这里引出一个重要概念,类似于@Target这样的修饰注解的注解,称为元注解

(2)@Deprecated: 用于表示某个程序元素(类, 方法等)已过时,用于新旧版本的兼容和过渡
在这里插入图片描述

package com.francis.javase;

/**
 * @author Francis
 * @create 2021-07-14 21:43
 */
public class DeprecateTest {
        public static void main(String[] args) {
            A a = new A();
            a.hi();
            System.out.println(a.n1);
        }
    }
//1. @Deprecated 修饰某个元素, 表示该元素已经过时
//2. 即不在推荐使用,但是仍然可以使用
//3. 查看 @Deprecated 注解类的源码
//4. 可以修饰方法,类,字段, 包, 参数 等等
//5. @Deprecated 可以做版本升级过渡使用
/*
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
public @interface Deprecated {
}
*/
    @Deprecated
    class A {
        @Deprecated
        public int n1 = 10;
        @Deprecated
        public void hi(){
        }
    }

(3) @SuppressWarnings: 抑制编译器警告

package com.francis.javase;

import java.util.ArrayList;
import java.util.List;

/**
 * @author Francis
 * @create 2021-07-14 21:51
 */

@SuppressWarnings({"rawtypes", "unchecked", "unused"})
public class SuppressWarnings_ {
//1. 当我们不希望看到这些警告的时候,可以使用 SuppressWarnings 注解来抑制警告信息
//2. 在{""} 中,可以写入你希望抑制(不显示)警告信息
//3. 可以指定的警告类型有
// all,抑制所有警告
// boxing,抑制与封装/拆装作业相关的警告
// //cast,抑制与强制转型作业相关的警告
// //dep-ann,抑制与淘汰注释相关的警告
// //deprecation,抑制与淘汰的相关警告
// //fallthrough,抑制与 switch 陈述式中遗漏 break 相关的警告
// //finally,抑制与未传回 finally 区块相关的警告
// //hiding,抑制与隐藏变数的区域变数相关的警告
// //incomplete-switch,抑制与 switch 陈述式(enum case)中遗漏项目相关的警告
// //javadoc,抑制与 javadoc 相关的警告
        // //nls,抑制与非 nls 字串文字相关的警告
// //null,抑制与空值分析相关的警告
// //rawtypes,抑制与使用 raw 类型相关的警告
// //resource,抑制与使用 Closeable 类型的资源相关的警告
// //restriction,抑制与使用不建议或禁止参照相关的警告
// //serial,抑制与可序列化的类别遗漏 serialVersionUID 栏位相关的警告
// //static-access,抑制与静态存取不正确相关的警告
// //static-method,抑制与可能宣告为 static 的方法相关的警告
// //super,抑制与置换方法相关但不含 super 呼叫的警告
// //synthetic-access,抑制与内部类别的存取未最佳化相关的警告
// //sync-override,抑制因为置换同步方法而遗漏同步化的警告
// //unchecked,抑制与未检查的作业相关的警告
// //unqualified-field-access,抑制与栏位存取不合格相关的警告
// //unused,抑制与未用的程式码及停用的程式码相关的警告
//4. 关于 SuppressWarnings 作用范围是和你放置的位置相关
// 比如 @SuppressWarnings 放置在 main 方法,那么抑制警告的范围就是 main
// 通常我们可以放置具体的语句, 方法, 类. //5. 看看 @SuppressWarnings 源码
//(1) 放置的位置就是 TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE
//(2) 该注解类有数组 String[] values() 设置一个数组比如 {"rawtypes", "unchecked", "unused"}
/*
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
@Retention(RetentionPolicy.SOURCE)
public @interface SuppressWarnings {
String[] value();
韩顺平循序渐进学 Java 零基础
第 498页
}
*/
        public static void main(String[] args) {
            List list = new ArrayList();
            list.add("jack");
            list.add("tom");
            list.add("mary");
            int i;
            System.out.println(list.get(1));
        }
        public void f1() {
// @SuppressWarnings({"rawtypes"})
            List list = new ArrayList();
            list.add("jack");
            list.add("tom");
            list.add("mary");
// @SuppressWarnings({"unused"})
            int i;
            System.out.println(list.get(1));
        }
    }



2、JDK 的元 Annotation(元注解)

JDK 的元 Annotation 用于修饰其他 Annotation
(1) Retention //指定注解的作用范围,三种 SOURCE,CLASS,RUNTIME
(2) Target // 指定注解可以在哪些地方使用
(3)Documented //指定该注解是否会在 javadoc 体现
(4)Inherited //子类会继承父类注解

1、 @Retention 注解

说明
只能用于修饰一个 Annotation 定义, 用于指定该 Annotation 可以保留多长时间, @Rentention 包含一个 RetentionPolicy
类型的成员变量, 使用 @Rentention 时必须为该 value 成员变量指定值:
@Retention 的三种值
(1) RetentionPolicy.SOURCE: 编译器使用后,直接丢弃这种策略的注解
(2) RetentionPolicy.CLASS: 编译器将把注解记录在 class 文件中. 当运行 Java 程序时, JVM 不会保留注解。 这是默认值
(3)RetentionPolicy.RUNTIME:编译器将把注解记录在 class 文件中. 当运行 Java 程序时, JVM 会保留注解. 程序可以通过反射获取该注解

2、@Target

用于修饰注解的定义,用于指定被修饰的注解能用于哪些程序元素,@Target也包含了一个名为values的成员变量
在这里插入图片描述

3、@Documented

用于指定被修饰的注解将被Javadoc工具提取成文档,即在生成文档时,可以看到该被修饰的注解。

4、@Inherited 注解

被修饰的注解将具有继承性,如果某个类使用了被@Inherited 注解修饰的注解,则其子类将自动拥有这个被修饰的注解,@Inherited 注解在实际应用中使用较少。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值