《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"
        }
    }

}

　　* 比较保守的做法：尽量不要导出具有相同类型参数数目的重载方法，或至少有一个完全不同类型的入参。

一个反例：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