Java的枚举、注解与方法...
第30条 用枚举代替int常量
第31条 用实例域代替序数
可以考虑定义一个final int 代替枚举中的 ordinal() 方法。
第32条 用EnumSet代替位域(bit field)
如果底层的枚举类型不超过64个,则整个 EnumSet 就是用单个 long 来表示,因此性能上比得上位域的性能。
第33条 用EnumMap代替序数索引
第34条 用接口模拟可伸缩的枚举
定义一个接口,然后根据需要,采用不同的枚举,枚举都实现相同的接口,在应用中采用接口作形参。这种模式虽然可以模拟可扩展的枚举类型,但在使用上与原先的枚举类型相比会有很多限制,比如无法使用EnumMap等。
第35条 注解优先于命名模式
就单元测试而言,现在Java一般都用junit和jmockit的注解,命名模式在标注测试方法上对于编译器而言没有用武之地了。但一般测试方法都还是习惯以test开头。
第36条 坚持使用Override注解
第37条 用标记接口)定义类型
* 标记接口(maker interface)是没有包含方法声明的接口,例如Serializable
以下为“方法”章节部分:
第38条 检查参数的有效性
特别是来自不可信域的参数。
第39条 必要时进行保护性拷贝
反例:
public Period(Date start, Date end) {
this.start = start;
this.end = end;
}
正例:
public Period(Date start, Date end) {
this.start = new Date(start.getTime());
this.end = new Date(end.getTime());
}
第40条 谨慎设计方法签名
* 方法的名称应当始终遵循标准的命名习惯。
* 不要过于追求提供便利的方法。
* 避免过长的参数列表。
第41条 慎用重载
* 对于重载方法(overloaded method)的选择是静态的,而对于被覆盖的方法(overridden method)的选择则是动态的。
对于下面的例子,其实在未运行时已经确定了实际调用的方法。
import java.util.*;
import java.util.concurrent.DelayQueue; /**
* @author https://www.cnblogs.com/laishenghao/
* @date 2018/10/13
*/
public class BadOverload { public String getType(List<?> list) {
return "List";
} public String getType(Set<?> set) {
return "Set";
} public String getType(Collection<?> collection) {
return "Unknown";
} public static void main(String[] args) { Collection<?>[] collections = {
new ArrayList<>(),
new HashSet<>(),
new DelayQueue<>()
}; BadOverload badOverload = new BadOverload();
for (Collection<?> item : collections) {
System.out.println(badOverload.getType(item)); // all print "Unknown"
}
} }
Bad overload
* 比较保守的做法:尽量不要导出具有相同类型参数数目的重载方法,或至少有一个完全不同类型的入参。
一个反例:Set 与 List 的 remove 方法造成的混淆:
Set只有一个remove方法,而List有两个:
boolean remove(Object o);
E remove(int index);
public static void main(String[] args) {
Set<Integer> set = new TreeSet<>();
List<Integer> list = new ArrayList<>(); // construct same data
for (int i = -3; i < 3; i++) {
set.add(i);
list.add(i);
} // try to remove the non-negative numbers
for (int i = 0; i < 3; i++) {
set.remove(i);
list.remove(i);
} // result: [-3, -2, -1] [-2, 0, 2]
System.out.println(set + " " + list);
}
第42条 慎用可变参数
* 检查参数的个数或在前面多写一个相同类型的参数。
static int min(int first, int... remainingArgs) {
int min = first;
for (int i : remainingArgs) {
if (i < min) {
min = i;
}
}
return min;
}
第43条 返回零长度的数组或者集合,而不是null
书中推荐返回固定的静态零长度数组或集合。对于固定的返回值,我认为应该视情况而定,如果是后台返回给前台,在没有元素的情况下,返回Collections.emptySet()等是合理的;但如果是在本模块下进行操作,这种不可变的集合就不太适用了,特别是需要对集合做进一步修改的时候。
第44条 为所有导出的API元素编写文档注释
本文地址:https://www.cnblogs.com/laishenghao/p/effective_java_note_enums_annotations_methods.html