目录
枚举和注解
枚举
看一个需求
要求创建季节(Season) 对象,请设计并完成。
package com11.enum_;
/**
* @author 甲柒
* @version 1.0
* 2023/1/2 15:02
* com11.enum_
*/
public class Enumeration01 {
public static void main(String[] args) {
//使用
Season spring = new Season("春天", "温暖");
Season summer = new Season("夏天", "炎热");
Season autumn = new Season("秋天", "凉爽");
Season winter = new Season("冬天", "寒冷");
// autumn.setName("哈哈哈");
// autumn.setDesc("666");
//因为对于季节而言,它的对象(具体值),是固定的四个,不会有其他的
//按照这个设计思路,不能体现季节是固定的四个对象
//因此这样设计不好===>枚举类[枚:一个一个 举:举例]即 把具体的对象一个一个列举出来,就称为枚举类
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;
}
}
创建Season对象有如下特点
1、季节的值是有限的几个值(spring, summer, autumn, winter)
2、只读,不需要修改。
解决方案-枚举
1、枚举对应英文(enumeration,简写enum)
2、枚举是一组常量的集合。
3、可以这里理解:枚举属于一种特殊的类,里面只包含一组有限的特定的对象。
自定义类实现枚举-应用案例
1、不需要提供setXxx方法,因为枚举对象值通常为只读
2、对枚举对象/属性使用final + static共同修饰,实现底层优化
3、枚举对象名通常使用全部大写,常量的命名规范
4、枚举对象根据需要,也可以有多个属性
package com11.enum_;
/**
* @author 甲柒
* @version 1.0
* 2023/1/2 15:19
* com11.enum_
*/
public class Enumeration02 {
public static void main(String[] args) {
System.out.println(Season.SPRING);
System.out.println(Season.SUMMER);
System.out.println(Season.AUTUMN);
System.out.println(Season.WINTER);
}
}
//演示自定义枚举实现
class Season {//类
//定义了四个对象
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("冬天", "寒冷");
private String name;
private String desc;//描述
//1.将构造器私有化,目的 防止直接new
//2.去掉set方法,防止属性被修改
//3.在Season内部,直接创建固定的对象
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、构造器私有化
2、本类内部创建一组对象
3、对外暴露对象(通过为对象添加public final static修饰符)
4、可以提供get方法,但是不要提供 set
enum关键字实现枚举-快速入门
使用enum来实现前面的枚举案例
package com11.enum_;
//演示使用enum关键字来实现枚举类
enum Season2 {//类
//定义了四个对象
// 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来实现枚举类
//1.使用关键字enum代替class
//2.public static final Season SPRING = new Season("春天", "温暖");直接使用
// SPRING("春天","温暖");//解读 常量名(实参列表)
//3.如果有多个常量(对象),使用,号间隔即可
//4.如果使用enum来实现枚举,要求将定义常量对象 写在前面
SPRING("春天", "温暖"), SUMMER("夏天", "炎热"),
AUTUMN("秋天", "凉爽"), WINTER("冬天", "寒冷");
private String name;
private String desc;//描述
//1.将构造器私有化,目的 防止直接new
//2.去掉set方法,防止属性被修改
//3.在Season内部,直接创建固定的对象
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 + '\'' +
'}';
}
}
/**
* @author 甲柒
* @version 1.0
* 2023/1/2 15:35
* com11.enum_
*/
public class Enumeration03 {
public static void main(String[] args) {
System.out.println(Season2.SPRING);
System.out.println(Season2.SUMMER);
System.out.println(Season2.AUTUMN);
System.out.println(Season2.WINTER);
}
}
enum关键字实现枚举注意事项
1、当我们使用enum 关键字开发一个枚举类时,默认会继承Enum类
2、传统的public static final Season2 SPRING = new Season2("春天", "温暖");
简化成SPRING("春天", "温暖"),这里必须知道,它调用的是哪个构造器
3、如果使用无参构造器创建枚举对象,则实参列表和小括号都可以省略
4、当有多个枚举对象时,使用,间隔,最后有一个分号结尾
5、枚举对象必须放在枚举类的行首
enum 关键字实现枚举-课堂练
下面代码是否正确,并说明表示的含义
enum Gender {
BOY, GIRL;//这里其实就是调用Gender类的无参构造器
}
1、上面语法正确
2、有一个枚举类Gender,没有属性
3、有两个枚举对象BOY,GIRL,使用的无参构造器创建
下面代码输出什么
package com11.enum_;
enum Gender2 {//父类Enum的toString
BOY, GIRL;
}
/**
* @author 甲柒
* @version 1.0
* 2023/1/2 16:01
* com11.enum_
*/
public class EnumExercise01 {
public static void main(String[] args) {
Gender2 boy = Gender2.BOY;//ok
Gender2 boy2 = Gender2.BOY;//ok
System.out.println(boy);//输出BOY,本质就是调用Gender2的父类Enum的toString()
// public String toString() {
// return name;
// }
System.out.println(boy2 == boy);//true
}
}
运行结果
enum常用方法说明
说明:使用关键字enum时,会隐式继承Enum类,这样我们就可以使用Enum类相关的方法。[看下源码定义]
enum常用方法一览表
举例说明enum常用的方法的使用
1、toString:Enum 类已经重写过了,返回的是当前对象名,子类可以重写该方法,用于返回对象的属性信息
2、name:返回当前对象名(常量名),子类中不能重写
3、ordinal:返回当前对象的位置号,默认从0开始
4、values:返回当前枚举类中所有的常量
5、valueOf:将字符串转换成枚举对象,要求字符串必须为已有的常量名,否则报异常!
6、compareTo:比较两个枚举常量,比较的就是编号!
package com11.enum_;
enum Season3 {//类
//定义了四个对象
// 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来实现枚举类
//1.使用关键字enum代替class
//2.public static final Season SPRING = new Season("春天", "温暖");直接使用
// SPRING("春天","温暖");//解读 常量名(实参列表)
//3.如果有多个常量(对象),使用,号间隔即可
//4.如果使用enum来实现枚举,要求将定义常量对象 写在前面
SPRING("春天", "温暖"), SUMMER("夏天", "炎热"),
AUTUMN("秋天", "凉爽"), WINTER("冬天", "寒冷");
private String name;
private String desc;//描述
//1.将构造器私有化,目的 防止直接new
//2.去掉set方法,防止属性被修改
//3.在Season内部,直接创建固定的对象
private Season3(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 + '\'' +
'}';
}
}
/**
* @author 甲柒
* @version 1.0
* 2023/1/2-16:15
* com11.enum_
*/
public class EnumMethod {
public static void main(String[] args) {
//使用Season3枚举类,来演示各种方法
Season3 autumn = Season3.AUTUMN;
//输出枚举对象的名字
System.out.println(autumn.name());
//ordinal()输出的是该枚举对象的次序/编号,从0开始编号
//AUTUMN枚举对象是第3个,因此输出2
System.out.println(autumn.ordinal());
//从反编译可以看出values方法,返回 Season2[]
//含有定义的所有枚举对象
Season3[] values = Season3.values();
System.out.println("=====遍历取出枚举对象=====");
for (Season3 season : values) {//增强for 循环
System.out.println(season);
}
//valueOf:将字符串转换成枚举对象,要求字符串必须为已有的常量名,否则报异常!
//执行流程
//1.根据你输入的"AUTUMN"到Season2的枚举对象去查找
//2.如果找到了,就返回,如果没有找到,就报错
Season3 autumn1 = Season3.valueOf("AUTUMN");
System.out.println("autumn1=" + autumn1);
System.out.println(autumn == autumn1);
//compareTo:比较两个枚举常量,比较的就是编号!
//解读
//1.就是把Season3.AUTUMN枚举对象的编号和Season3.SUMMER枚举对象的编号比较
//2.看结果
// public final int compareTo(E o) {
// Enum<?> other = (Enum<?>)o;
// Enum<E> self = this;
// if (self.getClass() != other.getClass() && // optimization
// self.getDeclaringClass() != other.getDeclaringClass())
// throw new ClassCastException();
// return self.ordinal - other.ordinal;
// }
// Season3.AUTUMN的编号[2] - Season3.SUMMER的编号[1] = 1
System.out.println(Season3.AUTUMN.compareTo(Season3.SUMMER));
//补充了一个增强for循环
// int[] nums = {1, 2, 9};
// //普通for循环
// System.out.println("=====普通for循环=====");
// for (int i = 0; i < nums.length; i++) {
// System.out.println(nums[i]);
// }
// //增强for循环
// System.out.println("=====增强for循环=====");
// for (int i : nums) {//执行流程
// //依次从nums数组中取出数据,赋给i,如果取出完毕,则退出for
// System.out.println("i=" + i);
// }
}
}
运行结果
练习题
1、声明Week枚举类,其中包含星期一至星期日的定义
MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY;
2、使用values返回所有的枚举数组,并遍历,输出下图效果
package com11.enum_;
//声明Week枚举类,其中包含星期一至星期日的定义
//MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY;
//使用values返回所有的枚举数组,并遍历,输出下图效果
enum Week {
//定义Week的枚举对象
MONDAY("星期一"), TUESDAY("星期二"), WEDNESDAY("星期三"),
THURSDAY("星期四"), FRIDAY("星期五"), SATURDAY("星期六"), SUNDAY("星期日");
private String name;
private Week(String name) {
this.name = name;
}
@Override
public String toString() {
return name;
}
}
/**
* @author 甲柒
* @version 1.0
* 2023/1/2-16:59
* com11.enum_
*/
public class EnumExercise02 {
public static void main(String[] args) {
//获取到所有的枚举对象,即数组
Week[] weeks = Week.values();
//遍历,使用增强for
System.out.println("===所有星期的信息如下===");
for (Week week : weeks) {
System.out.println(week);
}
}
}
运行结果
enum实现接口
1、使用enum关键字后,就不能再继承其它类了,因为enum会隐式继承Enum,而Java是单继承机制。
2、枚举类和普通类一样,可以实现接口,如下形式。
enum类名implements接口1, 接口20
package com11.enum_;
/**
* @author 甲柒
* @version 1.0
* 2023/1/2-17:12
* com11.enum_
*/
public class EnumDetail {
public static void main(String[] args) {
Music.CLASSIC_MUSIC.playing();
}
}
class B {
}
//1.使用enum关键字后,就不能再继承其它类了,因为enum会隐式继承Enum,而Java是单继承机制。
//enum Season4 extends B{
//
//}
//2.enum实现的枚举类,仍然是一个类,所以还是可以实现接口的。
interface IPlaying {
public void playing();
}
enum Music implements IPlaying{
CLASSIC_MUSIC;
@Override
public void playing() {
System.out.println("播放音乐~~~~");
}
}
注解的理解
1、注解(Annotation)也被称为元数据(Metadata),用于修饰解释包、类、方法、属性、构造器、局部变量等数据信息。
2、和注释一样,注解不影响程序逻辑,但注解可以被编译或运行,相当于嵌入在代码中的补充信息。
3、在JavaSE中,注解的使用目的比较简单,例如标记过时的功能,忍略警告等。在JavaEE中注解占据了更重要的角色,例如用来配置应用程序的任何切面,代替java EE旧版中所遗留的繁冗代码和XML配置等。
基本的 Annotation介绍
使用Annotation时要在其前面增加@符号,并把该Annotation当成一个修饰符使用。用于修饰它支持的程序元素
三个基本的Annotation:
1、@Override:限定某个方法,是重写父类方法,该注解只能用于方法
2、@Deprecated:用于表示某个程序元素(类,方法等)已过时
3、@SuppressWarnings:抑制编译器警告
基本的Annotation应用案例
@Override注解的案例
@Override:限定某个方法,是重写父类方法,该注解只能用于方法
补充说明:@interface的说明
interface不是interface,是注解类是jdk1.5之后加入的
package com11.annotation_;
/**
* @author 甲柒
* @version 1.0
* 2023/1/2-17:30
* com11.annotation_
*/
public class Override_ {
public static void main(String[] args) {
}
}
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)
// @Retention(RetentionPolicy.SOURCE)
// public @interface Override {
// }
//说明
public void fly() {
System.out.println("Son fly...");
}
@Override
public void say() {}
}
Override使用说明
1、@Override表示指定重写父类的方法(从编译层面验证),如果父类没有fly方法,则会报错
2、如果不写@Override 注解,而父类仍有public void fly(){},仍然构成重写
3、@Override只能修饰方法,不能修饰其它类,包,属性等等
4、查看@Override注解源码为@Target(ElementType.METHOD),说明只能修饰方法
5、@Target是修饰注解的注解,称为元注解
@Deprecated注解的案例
@Deprecated:用于表示某个程序元素(类,方法等)已过时
@Deprecated的说明
1、用于表示某个程序元素(类,方法等)已过时
2、可以修饰方法,类,字段,包,参数等等
3、@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD,
PACKAGE, PARAMETER, TYPE})
4、@Deprecated的作用可以做到新旧版本的兼容和过渡
package com11.annotation_;
/**
* @author 甲柒
* @version 1.0
* 2023/1/2-17:45
* com11.annotation_
*/
public class Deprecated_ {
public static void main(String[] args) {
A a = new A();
a.hi();
System.out.println(a.n1);
}
}
//解读
//1.@Deprecated修饰某个元素,表示该元素已经过时了
//2.即不推荐使用,但是仍然可以使用
//3.查看@Documented注解类的源码
//4.可以修饰方法,类,字段,包,参数等等
//5.@Documented可以做版本升级过渡使用
//@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() {
}
}
@SuppressWarnings 注解的案例
@SuppressWarnings: 抑制编译器警告
package com11.annotation_;
import java.util.ArrayList;
import java.util.List;
/**
* @author 甲柒
* @version 1.0
* 2023/1/2-17:52
* com11.annotation_
*/
@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源码
// @Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
// @Retention(RetentionPolicy.SOURCE)
// public @interface SuppressWarnings {
// String[] value();
// }
//(1)放置的位置就是TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE
//(2)该注解类有数组String[] value();设置一个数组比如{"rawtypes", "unchecked", "unused"}
// @SuppressWarnings({"rawtypes", "unchecked", "unused"})
public static void main(String[] args) {
List list = new ArrayList<>();
list.add("甲柒");
list.add("薛之谦");
list.add("毛不易");
int i;
System.out.println(list.get(1));
}
public void f1() {
List list = new ArrayList<>();
list.add("甲柒");
list.add("薛之谦");
list.add("毛不易");
int i;
System.out.println(list.get(1));
}
}
@SuppressWarning 中的属性介绍以及属性说明
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,抑制与未用的程式码及停用的程式码相关的警告
@SuppressWarnings注解的案例
说明各种值
1、unchecked是忽略没有检查的警告
2、rawtypes是忽略没有指定泛型的警告(传参时没有指定泛型的警告错误)
3、unused是忽略没有使用某个变量的警告错误
4、@SuppressWarnings 可以修饰的程序元素为,查看@Target
5、生成@SupperssWarnings时,不用背,直接点击左侧的黄色提示,就可以选择(注意可以指定生成的位置)
JDK的元Annotation(元注解,了解)
元注解的基本介绍
JDK的元 Annotation 用于修饰其他 Annotation
元注解:本身作用不大,看源码时可以知道他是干什么就行
元注解的种类(使用不多,了解,不用深入研究)
1、Retention 指定注解的作用范围,三种 SOURCE,CLASS,RUNTIME
2、Target 指定注解可以在哪些地方使用
3、Documented 指定该注解是否会在javadoc体现
4、Inherited 子类会继承父类注解
@Retention 注解
说明
只能用于修饰一个Annotation定义,用于指定该Annotation可以保留多长时间,@Rentention包含一个 RetentionPolicy类型的成员变量,使用@Rentention时必须为该value成员变量指定值: @Retention的三种值
1) RetentionPolicy.SOURCE:编译器使用后,直接丢弃这种策略的注释
2) RetentionPolicy.CLASS:编译器将把注解记录在class文件中,当运行Java程序时,JVM 不会保留注解。 这是默认值
3) RetentionPolicy.RUNTIME:编译器将把注解记录在class文件中,当运行Java程序时,JVM 会保留注解,程序可以通过反射获取该注解
@Target 注解
基本说明
用于修饰Annotation定义,用于指定被修饰的Annotation能用于修饰哪些程序元素。
@Target也包含一个名为value的成员变量。
@Documented 注解
基本说明
@Documented:用于指定被该元 Annotation修饰的Annotation类将被javadoc工具提取成文档,即在生成文档时,可以看到该注解。
说明:定义为Documented的注解必须设置Retention值为RUNTIME。
@Inherited 注解
基本说明
@Inherited:被它修饰的Annotation将具有继承性,如果某个类使用了被@Inherited修饰的Annotation,则其子类将自动具有该注解
说明:实际应用中,使用较少,了解即可。