第41条:用标记接口定义类型
如果一个标记(例如注解或注释)是应用于一个类,并且会影响这个类在未来的行为或可操作性,那么最好将它定义为一个"标记接口",而不是一个"标记注解"。
简单来说,当你的标记有资格成为一个"类型"时,就应该使用接口。
标记接口
标记接口(Marker Interface) 是指没有任何方法声明,只是用来表明一个类拥有某种属性或能力的接口。
最经典的例子就是 java.io.Serializable:
java
public interface Serializable {
// 空空如也,没有定义任何方法
}
一个类实现了 Serializable,只是告诉JVM:"这个类的对象可以被序列化"。
标记接口与标记注解的使用
标记接口定义的类型是由被标记类的实例实现的;标记注解则没有定义这样的类型。
根本区别
- 标记接口:实现了该接口的类,变成了该接口的子类型。这带来了编译期的类型检查优势。
- 标记注解:注解只是给类打了个标签,它不会改变类的类型。
标记接口能在编译时捕获错误,而标记注解只能在运行时抛出异常。
标记接口可以被更精确地锁定
因为标记接口本身是一个类型,它可以成为其他API中泛型约束的一部分。
例如,你可以写一个 Set,确保这个集合里只能存放可序列化的对象。这是注解做不到的。
标记注解的优势
-
可以添加额外信息:注解可以通过添加元素,在标记的同时传递更多的元数据。例如,JPA中的 @Entity 注解可以附带 name 属性。
-
属于更大的注解体系:如果一个框架大量使用了注解(如Spring),那么在该框架内统一使用注解,比混合使用接口和注解更符合使用习惯。
案例
-
java.io.Serializable:必须用接口。因为 ObjectOutputStream.write(Object) 方法内部会检查对象是否是 Serializable 的实例,如果不是则抛出 NotSerializableException。这种检查依赖于类型系统。
-
java.lang.Override:必须用注解。因为它只用于方法,且仅仅作为编译器的辅助检查,本身不构成类型系统的一部分。
总结
如果你的标记是给别人用的"身份证"(类型),就用接口;如果你的标记是给自己看的"便利贴"(元数据),就用注解。