《Effective Java》学习笔记 —— 枚举、注解与方法

  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

上一篇:用事件与CSS改变按钮不同状态下的颜色


下一篇:Android(java)学习笔记267:Android线程池形态