chapter11 枚举和注解
chapter11 枚举和注解
基本介绍
需求分析
创建季节对象，属性包含季节名称，当我们创建了春夏秋冬之后，还可以创建夏冬、夏夏等。而实际中季节只有固定的四个，这时候这个类的设计就有缺陷了
问题分析
创建的Season对象有如下特点：
- 季节有几个限定值：春夏秋冬
- 只读，不允许修改
解决方案
- 枚举-对应英文enumeration 简写为enum
- 枚举是一组常量的集合
- 理解：枚举属于一种特殊的类，里面包含一组有限的特定的对象
枚举的两种实现方式
- 自定义类枚举
- 使用enum关键字实现枚举
自定义类实现枚举
- 不提供setXXX方法，应为枚举对象值通常为只读
- 对美剧对象/属性 使用final+static共同修饰，实现底层优化
- 枚举对象名通常使用全部大写，常量的命名规范
- 枚举对象根据需要，也可以有多个属性
package javabase.chapter11;
public class Enumeration02 {
public static void main(String[] args) {
}
}
//自定义枚举类实现
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 AUTUAM = new Season("秋天","凉爽");
public static final Season SUMMER = new Season("夏天","炎热");
//将构造器私有化 防止被new新建
private Season(String name, String desc) {
this.name = name;
this.desc = desc;
}
//去掉setXXX方法，防止属性被修改
public String getName() {
return name;
}
public String getDesc() {
return desc;
}
@Override
public String toString() {
return "Season{" +
"name='" + name + '\'' +
", desc='" + desc + '\'' +
'}';
}
}
自定义实现枚举小结
进行自定义类实现枚举有如下特点：
- 构造器私有化
- 本类内部创建一组对象【四个，春夏秋冬】
- 对外暴露对象（通过为对象添加public finall static修饰符）
- 可以提供get方法，但不提供set方法
enum关键字实现枚举
快速入门
使用enum来实现前面的枚举案例
package javabase.chapter11;
public class Enumeration03 {
public static void main(String[] args) {
}
}
//1.使用关键字enum代替class
enum Season2{
SPRING("春天", "温暖"), summer("夏天", "温暖");
//成员属性
private String name;
private String desc;
//2. 常量名（形参列表） 按照该格式直接使用
//3.多个常量（对象）用 ， 分割开
//4. 如果使用enum关键字 需要将常量对象写在前面
//构造器
private Season2(String name, String desc) {
this.name = name;
this.desc = desc;
}
//5.如果使用午餐构造器，那么常量对象无需填写形参列表
}
enmu关键字实现枚举注意事项
- 当我们使用enum关键字开发一个枚举类时，默认会继承Enum类，而且是一个final类，【通过javap】指令反向编译可看出
- 传统的public static final Season SPRING = new Season("春天","温暖")，简化成SPRING("春天","温暖"),这里必须直到他调用的是哪个构造器
- 如果使用午餐构造器 创建 枚举对象，则实参列表和小括号都可以省略
- 当有多个枚举对象时，使用，间隔，最后有一个分号结尾
- 枚举对象必须放在枚举类的首行
enum常用方法
enum实现接口
- 使用enum关键字后，就不能再继承其他类了，因为enum会隐士继承Enum，而java是单继承机制
- 枚举类和普通类一样，可以实现接口，形式 enum 类名 implements 接口1，接口2{}
package javabase.chapter11;
public class EnumDetail {
public static void main(String[] args) {
}
}
class A{
}
//1.使用enum关键字后不能再继承其他类了 因为enum会隐式继承Enum类
//enum B extends A{} 爆错 不允许继承
//2.enum实现的枚举类 任然是一个类 所以可以实现接口
interface JK{}
enum SsSs implements JK{}
//3.也可以实现多个接口
注解
基本介绍
- 注解（Annotation)也被称为元数据（Metadata），用于修饰解释 包 类 方法 属性 构造器 局部变量 等数据信息
- 和注释一样，注解不影响程序逻辑，但是注解可以被编译或运行，相当于嵌入代码中的补充信息
- 在JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在JavaEE中注解占据了更重要的角色，列入用来配置应用程序的任何切面，代替javaEE旧版中所遗留的繁冗代码和XML配置等
基本的Annotation介绍
使用Annotation时，要在前面加@符号，并把该Annotation当成一个装饰符使用，用于装饰他支持的程序元素；
三个基本的Annotation：
- @Override 限定某个方法，是重写父类方法，该注解只能用于方法
- @Deprecated 用于便是某个程序元素（类、方法）已过时
- @SuppressWarnings 抑制编译器警告
基本的Annotation应用案例
@Override注解案例
package javabase.chapter11.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的定义
/**
* @Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}*/
@Override
public void fly() {
super.fly();
}
}
使用说明：
- @Override表示指定重写父类的方法（从编译层面验证），如果父类没有fly方法，则会报错
- 如果不写@Override注解，而父类仍有public void fly(){}，任然构成重写
- @Override 只能修饰方法，不能修饰其他类、包、属性等
- 查看@Override注解源码为@Target(ElementType.METHOD)，说明只能修饰方法
- @Target 是修饰注解的注解，称为元注解 记住这个概念
@Deprecated注解案例
@Deprecated：用于表示某个程序元素（类、方法等）已经过时
package javabase.chapter11.annotation;
public class Deperecated_ {
public static void main(String[] args) {
A a = new A();
a.hi(2);
System.out.println(a.n1);
}
}
//@Deprecated 修饰某个元素, 表示该元素已经过时 即不在推荐使用，但是仍然可以使用
@Deprecated
class A{
@Deprecated
public int n1 = 10;
@Deprecated
public void hi(@Deprecated int n){}
}
//2.可以修饰类 方法 字段 包 参数等等
//3.查看@Deperected源码
/**@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
public @interface Deprecated {
}
*/
//4.@Deperected可以作为版本审计过渡使用
使用说明在代码中
@SuppressWarnings 注解案例
@SuppressWarnings：抑制编译器警告
package javabase.chapter11.annotation;
import java.util.ArrayList;
@SuppressWarnings("all")
public class SuppressWarnings_ {
/**
* 解读：
* 1.当我们不希望看到这些警告的时候 就可以使用SuppressWarnings注解来抑制警告信息
* 在{}中，可以写入你希望抑制（不显示）的警告信息
* 可以指定的警告类型有
* all 抑制所有警告
* 好多 都不知道干嘛的 用到了再看吧*/
/**2. 关于@SuppressWarnings作用范围和你放置的位置有关系
* 比如放在main方法上，那么抑制的范围就是main方法
* 通常我们可以防止具体的语法、类、方法*/
public static void main(String[] args) {
// List list = new ArrayList();
}
public void f1(){
// List list = new ArrayList();
}
/**
*3.源码分析
* 存放位置：@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
* @Retention(RetentionPolicy.SOURCE)
* public @interface SuppressWarnings {
String[] value(); */
}
最后补充说明
unchecked 忽略没有检查的警告
rawtypes 忽略没有指定泛型的警告（传参时没有指定反省的警告错误）
unused 忽略没有使用某个变量的警告错误
@SuppressWarnings 可以修饰的程序元素为：查看@target
生成@SuppressWarnings时，不用背，直接点击左侧黄色提示，就可以选择（注意 可以指定生成的位置）
JDK 的元 Annotation
元注解 了解
基本介绍
JDK的元Annotation 用于修饰其他Annotation
元注解：本身作用不大，直到是干什么的就可以
元注解的种类（了解）
Retention 指定注解的作用范围，三种 SOURCE,CLASS,RUNTIME
Target 指定注解可以在哪些地方使用
Documented 指定该注解是否会在javadoc中体现
Inherited 子类会继承父类的注解
@retention注解
只能用于修饰一个Annotation定义，用于指定该Annotation可以保留多长时间 @Rentention包含一个RetentionPolicy类型的成员变量，使用@Rentention时必须为该calue成员变量指定值
@Retention三种值：
- RetentionPolicy.SOURCE: 编译器使用后，直接丢弃这种策略的注释
- RetentionPolicy.CLASS: 编译器将把注解记录在 class 文件中. 当运行 Java 程序时, JVM 不会保留注解。 这是默认值
- RetentionPolicy.RUNTIME:编译器将把注解记录在 class 文件中. 当运行 Java 程序时, JVM 会保留注解. 程序可以通过反射获取该注解
@Target注解
用于修饰Annotation定义，用于指定被修饰的Annotation能用于修饰那些程序元素。@Target也包含一个名为value的成员变量
@documented注解
用于指定被该元Annotation修饰的Annotation类将被javadoc工具提取成文档，即在生成文档时，可以看到该注解
说明：定义为Documented的注解必须设置Retention值为RUNTIME
@Inherited 注解
被他修饰的Annotation将具有继承性，如果某个类使用了@Inherited 注解修饰的Annotation 则其子类将会自动具有该注解
说明：实际应用中 使用较少 了解即可
浙公网安备 33010602011771号