[豪の学习笔记] JavaReStudy#09
跟学视频：韩顺平Java课程
枚举和注解
枚举对应英文enumeration，简写enum
枚举是一组常量的集合，属于一种特殊的类，里面只包含一组有限的特定的对象
1 - 自定义枚举
不需要提供setXX方法，因为枚举对象通常为只读
对枚举对象/属性使用final+static共同修饰，实现底层优化
枚举对象名通常使用全部大写，常量的命名规范
枚举对象根据需要，也可以有多个属性
public class Enumeration02{
public static void main(String[] args){
System.out.println(Season.AUTUMN);
}
}
//1.将构造器私有化，防止直接new
//2.去掉set方法，防止属性被修改
//3.在内部直接创建固定的对象
//4.优化，可以再添加final修饰符，避免类加载
class Season{
private String name;
private String desc;
public final static Season SPRING = new Season("春天", "温暖");
public final static Season SUMMER = new Season("夏天", "酷热");
public final static Season AUTUMN = new Season("秋天", "凉爽");
public final static Season WINTER = new 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 + '\'' +
'}';
}
}
2 - enum关键字实现枚举
当我们使用enum关键字开发一个枚举类时，默认会继承Enum类
传统的public static final Season2 SPRING = new Season("春天", "温暖");简化成 SPRING("春天", "温暖")，这里必须知道它调用的是哪个构造器，如果使用无参构造器创建枚举对象，则实参列表和小括号都可以省略
当有多个枚举对象时使用逗号间隔，最后一个用分号结尾
枚举对象必须放在枚举类的行首
public class Enumeration02{
public static void main(String[] args){
System.out.println(Season2.AUTUMN);
}
}
//1.使用关键字enum替代class
//2.直接使用 常量名(参数列表)
//3.如果有多个常量(对象)，使用逗号间隔即可
//4.如果使用enum来实现枚举，要求将定义常量对象写在最前面
enum Season2{
SPRING("春天", "温暖"), SUMMER("夏天", "酷热"), AUTUMN("秋天", "凉爽"), WINTER("冬天", "寒冷");
private String name;
private String desc;
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 + '\'' +
'}';
}
}
enum常用方法
values() 返回数组，包含当前枚举类中所有的常量
valueOf() 将字符串转换成枚举对象，要求字符串必须为已有的常量名，否则报异常（传递枚举类型的Class对象和枚举常量名称给静态方法valueOf，会得到与参数匹配的枚举常量）
Season autumn2 = Season.valueOf("AUTUMN");
toString() 得到当前枚举常量的名称，可以通过重写此方法来使得到的结果更易读
equals() 在枚举类型中可以直接使用“”来比较两个枚举常量是否相等，Enum提供的这个equals()方法也是直接使用“”实现的，它的存在是为了在Set、List、Map中使用，注意equals()是不可变的
hashCode() Enum实现了hashCode()来和equals()保持一致，它也是不可变的
getDeclaringClass() 得到枚举常量所属枚举类型的Class对象，可以用它来判断两个枚举常量是否属于同一个枚举类型
name() 得到当前枚举常量的名称，建议优先使用toString()
ordinal() 得到当前枚举常量的次序/编号，从0开始编号
compareTo() 枚举类型实现了Comparable接口，这样可以比较两个枚举常量的大小(按照声明的顺序排列)
// Season.AUTUMN的编号 - Season.SUMMER的编号
Season.AUTUNM.compareTo(Season.SUMMER)
clone 枚举类型不能被Clone，为了防止子类实现克隆方法，Enum实现了一个仅抛出CloneNotSupportedException异常的不变Clone()
enum实现接口
使用enum关键字后，就不能再继承其他类了，因为enum会隐式继承Enum，而Java是单继承机制
枚举类和普通类一样，可以实现接口
3 - 注解
注解(Annotation)也被称为元数据(Metadata)，用于修饰解释包、类、方法、属性、构造器、局部变量等数据信息
和注释一样，注解不影响程序逻辑，但注解可以被编译或运行，相当于嵌入在代码中的补充信息
在JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等；在JavaEE中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗代码和XML配置等
基本介绍
使用Annotation时要在其前面增加@符号，并把该Annotation当成一个修饰符使用，用于修饰它支持的程序元素
三个基本的Annotation：
1）@Override：限定某个方法，是重写父类方法，该注解只能用于方法
2）@Deprecated：用于表示某个程序元素（类，方法等）已过时
3）@SuppressWarnings：抑制编译器警告
Override
限定某个方法，是重写父类方法，该注解只能用于方法
如果写了@Override注解，编译器就会去检查该方法是否真的重写了父类的方法，如果的确重写了则编译通过，如果没有构成重写则编译错误
补充说明：
@Target是修饰注解的注解，称为元注解
@interface不是interface，是注解类，在jdk1.5后加入
Deprecated
@Deprecated用于表示某个程序元素（类、方法等）已过时
过时表示不推荐使用，但仍然可以使用
可以修饰包、类、方法、字段、参数等
@Deprecated的作用可以做到新旧版本的兼容和过度
SuppressWarnings
当我们不希望看到警告时，可以使用SuppressWarnings注解来抑制警告信息
@SuppressWarnings({""})
在{""}中，可以写入你希望抑制（不显示）的警告信息
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 - 元注解
JDK的元Annotation用于修饰其他Annotation
Retention
指定注解的作用范围，三种SOURCE，CLASS，RUNTIME
只能用于修饰一个Annotation定义，用于指定该Annotation可以保留多长时间
@Retention包含一个RetentionPolicy类型的成员变量，使用时必须为该value成员变量指定值
@Retention的三种值
RetentionPolicy.SOURCE：编译器使用后，直接丢弃这种策略的注解
RetentionPolicy.CLASS：编译器将把注释记录在 .class 文件中，当运行Java程序时，JVM不会保留注解，这是默认值
RetentionPolicy.RUNTIME：编译器将把注解记录在 .class 文件中，当运行Java程序时，JVM会保留注解，程序可以通过反射获取该注解。
Target
用于修饰Annotation定义，用于指定被修饰的Annotation能用于修饰哪些程序元素
@Target也包含一个名为value的成员变量
Documented
@Documented用于指定被该元Annotation修饰的Annotation类将被Javadoc工具提取成文档，即在生成文档时可以看到该注解
定义为Documented的注解必须设置Retention值为RUNTIME
Inherited
被它修饰的Annotation将具有继承性，如果某个类使用了被@Inherited修饰的Annotation，则其子类将自动具有该注解
浙公网安备 33010602011771号