Gaoge's island

Effective Java ReadingNotes 10

Wed, 28 Dec 2016 16:18:24 +0800

Effective Java阅读笔记(10)

Effective Java第11章序列化

74.谨慎地实现Serializable接口

实现Serializable接口的代价：

一旦一个类被发布，就大大降低了“改变这个类的实现”的灵活性。因为这个类的字节流编码成为了它导出的API的一部分，如果采用默认的序列化形式，甚至私有以及包级私有的成员都会被导出。这会迫使程序员维护这种序列形式。同时，这也违反了第13条的“最低限度访问域”的建议。如果接受了默认的序列化形式，并且以后又要改变这个类的内部表示方法，则可能会导致序列化形式的不兼容，虽然在改变内部表示法的同时仍然维持着原来的序列化形式（使用ObjectoutputStream.putFields和ObjectInputStream.readFields）是可能的，但是过程复杂。序列化还会使类的演变收到限制，比如说受到序列版本UID(serial version UID)的限制。如果不显式指定一个UID，系统会自动生成它，生成的UID受到类的名称、实现的接口的名称、以及所有公有的和受保护的成员的名称的影响。如果后期向这个类中增加或者删减了任何东西，都有可能导致这个自动生成的UID的变化，从而影响到这个类序列化/反序列化是否成功。
增加了出现Bug和安全漏洞的可能性。反序列化就像是一个隐藏的构造器一样，这个过程中同样需要有像构造器一样建立起该类的各种条件约束，但这在反序列化中容易忘记。
随着类的版本更新，对实现了Serializable接口的类的测试负担会加重。每一次版本变化都要测试当前版本的类到以前版本的类的序列化/反序列化是否可以兼容。除了二进制兼容，还要语义兼容。

什么时候实现Serializable接口：

一般来说值类应该实现，而代表活动实体的类不应该实现。
为了继承而设计的类应该尽可能少地实现，但是这个类的子类也许需要实现Serializable接口。这种情况下需要这个专门为继承而设计的类提供一个无参的构造器。提供无参构造器一般来说是容易的，但是如果这个为了继承而设计的类是有状态的（也就是说不可能无参数），这时提供无参构造器比较复杂。推荐的做法是在无参构造器之外再提供额外的初始化方法和状态检测方法，调用其他方法前要有初始化，每次进入其他方法还要进行状态检测。
内部类不应该实现序列化，因为它的默认序列化定义不清楚，而静态成员类是可以实现Serializable接口序列化的。

75.考虑使用自定义的序列化形式

如果一个对象的物理表示法等同于它的逻辑内容，可能就适合于使用默认的序列化形式。

当一个对象的物理表示法与它的逻辑数据内容有实质性区别的时候，使用默认的序列化形式存在以下缺点：

它使这个类的导出API永远束缚在该类的内部表示法上。
它会消耗过多空间。
它会消耗过多时间。
它会引起栈溢出（在一个对象的物理表示法使用链表，需要对链表进行遍历的时候）。

建议：

使用transient关键字标记要从默认序列化形式中省略的成员，然后在writeObject中对它们进行自定义操作，同时编写readObject方法。
对于实现了自定义序列化形式的类，使用JavaDoc进行注释，尽管readObject/writeObject方法是私有的也是如此。这里需要使用标签@serial和@serialData。
自定义序列版本UID(serial version UID)，这样会避免它成为不兼容的原因，同时还会提高性能。
如果自定义序列化形式的类的其他有关状态更改的方法使用了同步，那么在对象序列化上也要同步。

76.保护性地编写readObject方法

对于序列化形成的字节流，并不都是安全的，里面可能有伪造的有害数据，对它们不加分辨地反序列化，可能会导致程序收到损害。伪造的有害数据一方面可以是不正确的字节流；另一方面还可能是在正确的字节流中夹带“私货”，通过“私货”可以恶意修改反序列化的对象。

本条建议：

在readObject反序列化之后，检查对象成员的有效性。
进行保护性拷贝，这里的注意点和第39条一样：保护性拷贝先于参数有效性检测和避免使用clone方法（但是保护性拷贝会导致这个类需要保护性拷贝的成员不能为final）。
尽管Java1.4中为了阻止恶意攻击并且节省保护性拷贝的开销，在ObjectOutputStream/ObjectInputStream中引入了writeObjectUnshared/readObjectUnshared方法，并且比保护性拷贝更快，但是这些方法可能会受到复杂的攻击，不建议使用。
readObject方法和构造器行为类似，所以对构造器的注意事项同样适用于readObject方法：不要调用可被覆盖的方法。

编写readObject方法的建议：

对于对象引用域必须保持为私有的类，要保护性地拷贝这些域中的每一个对象。不可变类的可变组件就属于这一类。
对于任何约束条件，如果检查失败，则抛出InvalidObjectException异常。这些检查动作应该跟在所有的保护性拷贝之后。
如果整个对象图在被反序列化之后必须进行检验，就应该使用ObjectInputValidation接口。
无论是直接方式还是间接方式，都不要调用类中任何可能被覆盖的方法。

77.对于实例控制，枚举类型优先于readResolve

readObject方法实现的难点：

readResolve的调用是在readObject之后，readResolve方法会返回一个对象，取代readObject反序列化的对象。也就是说存在一种可能，在readResolve调用之前，readObject调用之后，有人恶意地得到反序列化的新的对象，取得它的引用，进而破坏单例。因此需要单例的类的所有实例域都是transient的。
对于readObject，它的可访问性值得考虑，私有意味着这个类失去了被子类化的能力；如果它是受保护或者公有的，而这个类的子类没有覆盖readObject方法，反序列化会产生一个这个类（超类）的实例，可能导致ClassCastException异常。

建议使用枚举实现单例（实例控制）。但是，如果一个单例的实例在编译时还不能确定（未实例化），那么是无法使用枚举类型的。

78.考虑用序列化代理代替序列化实例

序列化代理：

在需要序列化的类的内部创建一个私有的静态内部类，这个静态内部类同样实现Serializable接口。静态内部类通过构造函数传入外围类的引用，保留外围类的逻辑状态（比如保留所有数据、约束条件），并且有readObject方法。
同样实现了Serializable接口的外部类需要编写方法writeReplace，返回一个new出来的静态内部类（传入了自己的引用）。writeReplace会在序列化的时候对写入的对象进行替换，替换为这个静态内部类。
当反序列化的时候，不是调用外围类，而是调用静态内部类的反序列化的方法readResolve，返回一个使用当初保留的外部类的全部信息构造的外部类。

使用序列化代理的好处：

可以像保护性拷贝方法一样阻止伪字节流的攻击以及内部域的盗用攻击。
允许域为final。
允许反序列化实例有着与原始序列化实例不同的类。

使用序列化代理的局限性：

不能与可被客户扩展的类兼容。
不能与对象图中包含循环的某些类兼容：因为不能从对象的序列化代理的readResolve方法中调用这个对象的方法，因为这个对象还不存在。
可能增加性能开销。

Effective Java ReadingNotes 9

Wed, 28 Dec 2016 10:18:24 +0800

Effective Java阅读笔记(9)

Effective Java第10章并发

66.同步访问共享的可变数据

当多个线程共享可变数据的时候，每个读或者写数据的线程都必须执行同步。

67.避免过度同步

为了避免死锁和数据破坏，千万不要从同步区域内部调用外来方法，并要尽量限制同步区域内部的工作量。

68.executor和task优先于线程

现在应当优先使用executor和task而不是Thread，因为在以前Thread既是工作单元又是执行单元，但是现在二者分离，executor是执行单元，Runnable和Callable是工作单元。

使用ScheduledThreadPool代替Timer作为多线程的定时器。

对于ThreadPool：

使用Executor.newCachedThreadPool来应对一个轻负载的服务器。
使用Executor.newFixedThreadPool来应对一个重负载的服务器。
为了最大限度控制它，直接使用ThreadPoolExecutor。

69.并发工具优先于wait和notify

考虑使用java.util.concurrent而非wait和notify。如果你在维护使用wait和notify的代码，务必确保始终是利用标准的模式从while循环内部调用wait。一般情况下，你应该优先使用notifyAll，而不是使用notify。如果使用notify，请一定要小心，以确保程序的活性。

70.线程安全性的文档化

线程安全性的几种级别：

不可变的immutable，这个类的实例是不变的，所以不需要外部的同步。例如：String、Long和BigInteger。
无条件的线程安全unconditionally thread-safe,这个类的实例是可变的，但是这个类有着足够的内部同步，所以它的实例可以被并发使用，无需任何外部同步。例如：Random和ConcurrentHashMap。
有条件的线程安全conditionally thread-safe，除了有些方法为进行安全的并发而使用需要外部同步之外，这种线程安全级别与无条件的线程安全相同。例如：Collections.synchronized包装返回的集合，它们的迭代器iterator要求外部同步。
非线程安全not thread-safe，这个实例是可变的。为了并发地使用它们，客户必须利用自己选择的外部同步包围每个方法调用（或者调用序列）。例如：ArrayList和HashMap。
线程对立的thread-hostie，这个类不能安全地被多个线程并发使用，即使所有的方法调用都被外部同步包围。

如果编写无条件的线程安全类，建议使用私有锁，隐藏内部实现，私有锁尤其适合于专门为继承而设计的类。如果编写有条件的线程安全类，一定要在API文档中注明哪个方法调用序列需要外部同步，以及执行这些序列需要哪把锁。

71.慎用延迟初始化

除非绝对必要，否则就不要这么做。如果域只在类的实例部分被访问，并且初始化这个域的开销很高，可能就值得进行延迟初始化。在大多数情况下，正常的初始化要优先于延迟初始化。

四种延迟初始化的方式：

1.最普通的：

private FieldType field;
synchronized Field getField(){
    if(field==null){
        field=computeFieldValue();
    }
    return field;
}

2.对静态域的出于性能考虑的初始化方式：

private static class FieldHolder{
    static final FieldType field=computeFieldValue();
}
static FieldType getField(){ return FieldHolder.field; }

3.双重检查模式（出于性能考虑，避免初始化之后的锁定访问的开销）：

private volatile FieldType field;
Field getField(){
    FieldType result=field;
    if(result==null){
        synchronized(this){
            result=field;
            if(result==null){
                field=result=computeFieldValue();
            }
        }
    }
    return result;
}

4.单重检查模式（双重检查模式的变式，可以接受重复初始化）：

private volatile FieldType field; 
private FieldType getField(){ 
    FieldType result=field; 
    if(result==null){ 
        field=result=computeFieldValue(); 
    } 
    return result; 
}

72.不要依赖于线程调度器

线程只做有意义的工作，不应该忙等。

不要依赖Thread.yield改变优先级，因为它在不同环境下效果不同，而且实现也不同。对于大多数程序员来说，Thread.yield的唯一用途是在测试期间人为地增加程序的并发性。

不要使用调整线程优先级的方法，它不具有可移植性。

线程优先级可以提高一个已经能够正常工作的程序的服务质量，但永远不应该用来“修正”一个本来不能工作的程序。

要编写健壮的、相应良好的、可移植的多线程应用程序，最好的办法是确保可运行线程的平均数量不明显多于处理器的数量，这使得线程调度器没有更多的选择：它只需要运行这些可运行的线程，直到它们不再可运行。在等待的线程并不是可运行的。

73.避免使用线程组

ThreadGroup API已经过时。

Effective Java ReadingNotes 8

Tue, 27 Dec 2016 23:18:24 +0800

Effective Java阅读笔记(8)

Effective Java第9章异常

57.只针对异常的情况才使用异常

不要将异常用于普通的控制流，也不要编写迫使它们这么做的API。

58.对可恢复的情况使用受检异常，对编程错误使用运行时异常

59.避免不必要地使用受检的异常

如果方法只是抛出单个受检的异常，仅仅一个异常就会导致该方法不得不外于try块中，在这些情况下，应该问自己，是否有别的途径来避免使用受检的异常。一种方法是把这个抛出异常的方法分成两个方法，其中第一个方法返回一个boolean，表明是否应该抛出异常。

60.优先使用标准的异常

以下为最常见的可重用异常：

IllegalArgumentException非null的参数值不正确；IllegalStateException对于方法调用而言，对象状态不合适；NullPointerException在禁止使用null的情况下参数值为null；IndexOutOfBoundsException下标参数值越界；ConcurrentModificationException在禁止并发修改的情况下，检测到对象的并发修改；UnsupportedOperationException对象不支持用户请求的方法。

61.抛出与抽象相对应的异常

更高层的实现应该捕获低层的异常，同时抛出可以按照高层抽象进行解释的异常，这就是异常转译。

如果不能阻止或者处理来自更低层的异常，一般的做法是使用异常转译，除非低层方法碰巧可以保证它抛出的所有异常对高层也合适才可以将异常从低层传播到高层。异常链对高层和低层异常都提供了最佳的功能：它允许抛出适当的高层异常，同时又能捕获底层的原因进行失败分析。

62.每个方法抛出的异常都要有文档

始终要单独地声明受检的异常，并且利用Javadoc的@throw标记，准确地记录下抛出每个异常的条件，但不要使用throws关键字将未受检的异常包含在方法的声明中。如果一个类中的许多方法出于同样的原因而抛出同一个异常，在该类的文档注释中对这个异常建立文档，这是可以接受的，而不是为每个方法单独建立文档。

63.在细节消息中包含能捕获失败的信息

为了捕获失败，异常的细节信息应该包含所有“对该异常有贡献”的参数和域的值。

64.努力使失败保持原子性

失败的方法调用应该使对象保持在被调用之前的状态。

部分实现途径：

设计一个不可变的对象。
在执行操作之前检查参数的有效性。
调整计算处理过程的顺序，使得任何可能会失败的计算部分都在对象状态被修改之前发生。
编写一段恢复代码。

65.不要忽略异常

Effective Java ReadingNotes 7

Tue, 27 Dec 2016 17:18:24 +0800

Effective Java第8章通用程序设计

45.将局部变量的作用域最小化

在第一次使用它的地方声明；
几乎每个局部变量的声明都应该包含一个初始化表达式；
使方法小而集中。

46.for-each循环优先于传统的for循环

for-each循环在简洁性和预防bug方面有着传统的for循环无法比拟的优势，并且没有性能损失。

三种无法使用for-each循环的情况：

过滤——如果需要遍历集合，并删除选定的元素，就需要使用显式的迭代器，以便可以调用它的remove方法。
转换——如果需要遍历列表或者数组，并取代它部分或者全部的元素值，就需要列表迭代器或者数组索引，以便设定元素的值。
平行迭代——如果需要并行地遍历多个集合，就需要显式地控制迭代器或者索引变量，以便所有迭代器或者索引变量都可以得到同步前移。

47.了解和使用类库

48.如果需要精确的答案，请避免使用float和double

float和double类型的主要设计目的是为了科学计算和工程计算。它们执行二进制浮点运算，这是为了在广域数值范围上提供较为精确的快速近似计算而精心设计的。然而，它们没有提供完全精确的结果，所以不应该被用于要求精确结果的场合。因为要让一个float或者double精确地表示0.1(或者10的任何负数次方值)是不可能的，float和double类型对于货币计算尤为不合适，因为要让一个float或double精确地表示0.1或10的任何其他负数次方值是不可能的。比如System.out.println(2.0-1.1)将会打印0.899999999999999,而不是你所希望的0.9，这种舍入错误产生的原因是浮点数实际上是用二进制系统实现的，而分数1⁄10在二进制系统中没有精确的表示，其道理就如同在十进制系统中无法精确表示1⁄3一样；再比如0.5在二进制系统中有精确表示，而0.55在二进制系统中没有精确表示。

对于任何要精确答案的计算任务，请不要用double和float。如果你想计算十进制小数点，并且不介意非基本类型带来的不便，那就用BigDecimal；使用BigDecimal还有个额外的好处就是他允许你完全控制舍入，每当一个操作涉及舍入的时候它允许你从8种舍入模式中选择一种。如果你正确通过法定要求的舍入行为进行业务计算使用BigDecimal时非常方便的；如果性能十分关键，并且你又不介意自己记录十进制的小数点，而且涉及数值不大，就可以使用int或者long；如果数值范围没有超过9位的十进制数字，可以用int；如果数值范围没有超过18位的十进制数字，用long如果范围超过了18位数，那我们必须使用BigDecimal。

49.基本类型优先于装箱基本类型

基本类型和装箱基本类型的区别：

基本类型只有值，而装箱基本类型则具有与它们的值不同的同一性。
基本类型只有功能完备的值，而每个装箱基本类型除了它对应基本类型的所有功能值之外，还有个非功能值：null。
基本类型通常比装箱基本类型更节省时间和空间。

当在一项操作中混合使用基本类型和装箱基本类型时，装箱基本类型就会自动拆箱，这种情况无一例外。如果null对象引用被自动拆箱，就会得到一个NullPointerException异常。

装箱基本类型的合理用处：

作为集合中的元素、键和值。你不能将基本类型放在集合中，因此必须使用装箱基本类型。
在参数化类型中，必须使用装箱基本类型作为类型参数，因为Java不允许使用基本类型。
在进行反射的方法调用时，必须使用装箱基本类型。

基本类型与装箱基本类型==比较出现的几种情况：

Integer.valueOf()和Integer.intValue()进行了自动装箱和自动拆箱。
通过==对两个new出来的Integer类型的实例进行比较时，即使表示相同的数值，由于Integer类型的数据还要进行同一性的比较，因此不相等。
通过==比较两个自动装箱的Integer实例时，只要两者所表示的数值相同，结果就是相等的，因为它们的同一性是相同的。
通过equals进行比较的时候，只要同类型（包括自动装箱和拆箱）代表的数值相同，就是相等的。

50.如果其他类型更适合，则尽量避免使用字符串

字符串不适合代替其他的值类型。
字符串不适合代替枚举类型。
字符串不适合代替聚集类型。
字符串不适合代替能力表。

51.当心字符串连接的性能

由于字符串不可变，为连接n个字符串而重复地使用字符串连接操作符，需要n的平方级的时间。考虑使用StringBuilder替代String。

52.通过接口引用对象

如果有合适的接口类型存在，那么对于参数、返回值、变量和域来说，就都应该使用接口类型进行声明。

比如声明Vector类，它是List接口的实现，在声明变量的时候应该养成这样的习惯：List<String> strs = new Vector<String>();

而不是这样的声明：Vector<String> strs = new Vector<String>();

如果养成用接口作为类型的习惯，你的程序会更加灵活，当你决定更换实现时，所有要做的事只是改变构造器中类的实现，或者使用不同的静态工厂：List<String> strs = new ArrayList<String>();

不存在适当接口类型的部分情形：

值类，比如String和BigInteger。记住值类很少会用多个实现编写，它们通常是final，并且很少有对应的接口。使用值类做参数、变量、域或者返回值类型是再合适不过的。
对象属于框架，而框架的基本类型的类，不是接口。如果对象属于这种基于类的框架，那么就应该使用基类(通常是抽象类)来引用这个对象，而不是实现类。Java.util.TimerTask抽象类就是这种情景。
类实现接口，但是它提供接口中不存在的额外方法，如果程序依赖这些额外方法，这种类应该只被用来引用它的实例。

53.接口优先于反射机制

反射的代价：

丧失了编译时类型检查的好处，包括异常检查。
执行反射访问所需要的代码非常笨拙和冗长。
性能损失。

54.谨慎地使用本地方法

本地方法主要有三种用途：1.提供了“访问特定于平台的机制”的能力；2.提供了访问遗留代码库的能力，从而可以访问遗留数据；3.本地方法可以通过本地语言，编写应用程序中注重性能的部分，以提高系统的性能。

本地方法的缺点：1.不安全；2.与平台相关，使用本地方法的应用程序也不再是可自由移植的；3.更难调试。

55.谨慎地进行优化

56.遵守普遍接受的命名惯例

Effective Java ReadingNotes 6

Tue, 20 Dec 2016 18:18:24 +0800

Effective Java阅读笔记(6)

Effective Java第7章方法

38.检查参数的有效性

对于公有的方法，要用Javadoc的@throws标签在文档中说明违反参数值限制时会抛出的异常。

非公有的方法通常应该使用断言assertion来检查它们的参数。

由于无效的参数值而导致计算过程抛出的异常，与文档中标明这个方法将抛出的异常并不相符，这种情况下，应该使用异常转译exception translation技术，讲计算过程中抛出的异常转换为正确的异常。

39.必要时进行保护性拷贝

如果类具有从客户端得到或者返回到客户端的可变组件，类就必须保护性地拷贝这些组件。如果拷贝的成本受到限制，并且类信任它的客户端不会不恰当地修改组件，就可以在文档中指明客户端的职责是不得修改受到影响的组件，以此来代替保护性拷贝。

public final class Period {  
    private final Date start;  
    private final Date end;  
    public Period(Date start,Date end) {  
        if(start.compareTo(end) > 0){  
            throw new IllegalArgumentException(start + " after " + end);  
        }  
        this.start = start;  
        this.end = end;  
    }  
      
    public Date start(){  
        return start;  
    }  
      
    public Date end(){  
        return end;  
    }  
    //remainder omitted  
}

修改后：

public Period(Date start,Date end) {  
    this.start = new Date(start.getTime());  
    this.end = new Date(end.getTime());  
    if(this.start.compareTo(this.end) > 0){  
        throw new IllegalArgumentException(this.start + " after " + this.end);  
    }

    public Date start(){  
        return new Date(start.getTime());  
    }   
    
    public Date end(){  
        return new Date(end.getTime());  
    }    
}

40.谨慎设计方法签名

谨慎地选择方法的名称。

不要过于追求提供便利的方法。

避免过长的参数列表。三种方法：1.把方法分解成多个方法，每个方法只需要这些参数的一个子集；2.创建辅助类，用来保存参数的分组；3.从对象构建到方法调用都采用Builder模式。

对于参数类型，要优先使用接口而不是类；对于boolean参数，要优先使用两个元素的枚举类型。

41.慎用重载

对于重载方法的选择是静态的，而对于被覆盖的方法的选择则是动态的。

一般情况下，对于多个具有相同参数数目的方法来说，应该尽量避免重载方法。对于涉及构造器的时候要避免同一组参数只需经过类型转换就可以被传递给不同的重载方法。如果不能就应该保证当传递同样的参数时，所有重载方法的行为必须一致。

42.慎用可变参数

在定义参数数目不定的方法时，可变参数方法是一种很方便的方式，但是它们不应该被过度滥用。为了避免某些错误，可以让该方法带有两个参数，一个是指定类型的正常参数，另一个是这种类型的varargs参数。

43.返回零长度的数组或者集合，而不是null

返回类型为数组或集合的方法没理由返回null，而不是返回一个零长度的数组或者集合。

44.为所有导出的API元素编写文档注释

采用一致地风格来遵循标准的约定为API编写文档注释。

Effective Java ReadingNotes 5

Tue, 20 Dec 2016 13:18:24 +0800

Effective Java阅读笔记(5)

Effective Java第6章枚举和注解

30.用enum代替int常量


public enum PayrollDay {  
    MONDAY(PayType.WEEKDAY), TUESDAY(PayType.WEEKDAY), WEDNESDAY(  
            PayType.WEEKDAY), THURSDAY(PayType.WEEKDAY), FRIDAY(PayType.WEEKDAY), SATURDAY(  
            PayType.WEEKEND), SUNDAY(PayType.WEEKEND);  
    private final PayType payType;  
  
    PayrollDay(PayType payType) {  
        this.payType = payType;  
    }  
      
    double pay(double hoursWorked, double payRate) {  
        return payType.pay(hoursWorked, payRate);  
    }  
  
    private enum PayType {  
        WEEKDAY {  
            double overtimePay(double hours, double payRate) {  
                return hours <= HOURS_PER_SHIFT ? 0 : (hours - HOURS_PER_SHIFT)  
                        * payRate / 2;  
            }  
        },  
        WEEKEND {  
            double overtimePay(double hours, double payRate) {  
                return hours * payRate / 2;  
            }  
        };  
        private static final int HOURS_PER_SHIFT = 8;  
  
        abstract double overtimePay(double hours, double payRate);  
  
        double pay(double hoursWorked, double payRate) {  
            double basePay = hoursWorked * payRate;  
            return basePay + overtimePay(hoursWorked, payRate);  
        }  
    }  
}

与int常量相比，枚举要易读得多，也更加安全，功能更加强大。许多枚举都不需要显式的构造器或者成员，但许多其它枚举则受益于“每个常量与属性的关联”以及“提供行为受这个属性影响的方法”。只有极少数的枚举受益于将多种行为与单个方法关联。在这种相对少见的情况下，特定于常量的方法要优先于启用自有值的枚举。如果多个枚举常量同时享有相同的行为，则考虑策略枚举。

31.用实例域代替序数

永远不要根据枚举的序数导出与它关联的值，而是要将它保存在一个实力域中。

public enum Ensemble{
  SOLO(1), DUET(2), TRIO(3), QUINTET(4), SEXTET(5), 
  SEPTET(7), OCTET(8), DOUBLE_QUARTET(8), NONET(9),
  DECTET(10), TRIPLE_QUARTRT(12);
  
  private final int numberOfMusicians;
  Ensemble(int size){
    this.numberOfMusicians = size;
  }
  public int numberofMusicians(){
    return numberOfMusicians;
  }
}

Enum规范中谈到ordinal时这么写到：“大多数的程序员都不需要这个方法。它是设计成用于像EnumSet和EnumMap这种基于枚举的通用数据结构的。”除非你在编写的是这种数据结构，否则最好完全避免使用ordinal方法。

32.用EnumSet代替位域

EnumSet类集位域的简洁和性能优势及第30条中所述的枚举类型的所有的优点于一身。


public class Text{
    public enum TextStyle{BOLD, ITALIC, UNDERLINE, STRIKETHROUGH}
    public void applyStyles(Set<TextStyle> styles){...}
}

下面是将EnumSet实例传递给applyStyles方法的客户端代码。EnumSet提供了丰富的静态工厂来创建集合，其中一个如这个代码所示：text.applyStyles(EnumSet.of(TextStyle.BOLD,TextStyle.ITALIC));

33.用EnumMap代替序数索引

序数索引是指依赖于枚举成员在枚举中的序数来进行数组索引，如：

public class Plant{
    public enum Type { Fruit, Vegetables, Tree}
    private final String name;
    private final Type type;

    Plant(String name, Type type){
        this.name = name;
        this.type = type;
    }
}

Set<Plant>[] plants = (Set[]) new Set[Plant.Type.valuse().lenght]; 
//根据植物的类型，分别把所有的植物放入三个set中
for(int i = 0; i < plant.lenght; i++){
   plant[i] = new HashSet();
}

for(Plant p : garden){  //garden里放了所有的植物
    plant[p.type.ordinal()].add(p)  //反面教材：利用了枚举的序数来得到想要的数组索引，用户在其他地方可以不使用ordinal函数，而直接使用int值来访问，就可能出错
}

应该使用EnumMap来实现，EnumMap内部是采用数组实现的，具有Map的丰富功能和类型安全以及数组的效率：

Map<Plant.Type, Set> plants = new EnumMap<Plant.Type, Set>(Plant.Type.class);  //构造函数需要 键 类型的Class对象
//根据植物的类型，分别把所有的植物放入三个set中
for(Plant.Type type : Plant.Type.valuse()){
   plant.put(type, new HashSet);
}

for(Plant p : garden){  //garden里放了所有的植物
    plant.get(p.type).add(p)  //用户必须使用正确的键值来访问，即Type类型
}

当需要多维关系时，可以使用EnumMap<..., EnumMap<...>>。

34.用接口模拟可伸缩的枚举

虽然无法编写可扩展的枚举类型，却可以通过编写接口以及实现该接口的基础枚举类型，对它进行模拟。这样允许客户端编写自己的枚举来实现接口。如果API是根据接口编写的，那么在可以使用基础枚举类型的任何地方，也都可以使用这些枚举。

public interface Operation{
    double apply(double x,double y);
}

public enum BasicOperation implements Operation{

    PLUS("^"){
        public double apply(double x,double y){ return Math.pow(x,y);}
    },
    MINUS("%"){
        public double apply(double x,double y){ return x % y;}
    };

    private final String symbool;
    BasicOperation(String symbool){ this.symbool = symbool}

    @Override
    public String toString() {
        return symbool;
    }

    @Override
    public double apply(double x, double y) {
        return 0;
    }
}

可以通过以下两种方法传递完整的扩展枚举类型，并使用它的元素：

<T extends Enum<T> & Operation> Class<T>
Collection<? Extends Operation>

35.注解优先于命名模式

命名模式的缺点：

无法处理命名失误的情况；
无法确保它们只用于响应的程序元素上；
他们没有提供将参数值与程序元素关联起来的好方法。

36.坚持使用Override注解

在每个方法声明中使用Override注解来覆盖超类声明。

37.用标记接口定义类型

标记接口定义的类型是由被标记类的实例实现的；标记注解则没有定义这样的类型；标记接口可以被更加精确地进行锁定。

标记注解胜过标记接口的最大优点在于，它可以通过默认的方式添加一个或者多个注解类型元素，给已被使用的注解类型添加更多的信息，它的另一个优点在于它们使更大的注解机制的一部分。

如果想要定义类型，一定要使用接口。

LeetCode 1 - 10

Mon, 19 Dec 2016 16:16:24 +0800

1. Two Sum

public class Solution {
    public int[] twoSum(int[] nums, int target) {
        int result[] = new int[2];
        Map<Integer, Integer> map = new HashMap<>();
        for(int i = 0; i < nums.length; i++){
            if(map.containsKey(target - nums[i])){
                result[1] = i;
                result[0] = map.get(target - nums[i]);
                return result;
            }
            map.put(nums[i], i);
        }
        return result;
    }
}

2. Add Two Numbers

/**
 * Definition for singly-linked list.
 * public class ListNode {
 *     int val;
 *     ListNode next;
 *     ListNode(int x) { val = x; }
 * }
 */
public class Solution {
    public ListNode addTwoNumbers(ListNode l1, ListNode l2) {
        ListNode result = new ListNode(0);
        ListNode temp = result;
        int sum = 0;
        while(l1 != null || l2 != null){
            sum/=10;
            if(l1 != null){
                sum += l1.val;
                l1 = l1.next;
            }
            if(l2 != null){
                sum += l2.val;
                l2 = l2.next;
            }
            temp.next = new ListNode(sum%10);
            temp = temp.next;
        }
        if(sum/10 >= 1){
            temp.next = new ListNode(sum/10);
        }
        return result.next;
    }
}

3. Longest Substring Without Repeating Characters

public class Solution {
    public int lengthOfLongestSubstring(String s) {
        if(0 == s.length()) return 0;
        Map<Character, Integer> map = new HashMap<>();
        int max = 0;
        for(int i = 0, j = 0; i<s.length(); i++){
            if(map.containsKey(s.charAt(i))){
                j = Math.max(j, map.get(s.charAt(i))+1);
            }
            map.put(s.charAt(i), i);
            max = Math.max(max, i - j + 1);
        }
        return max;
    }
}

4. Median of Two Sorted Arrays

public class Solution {
    public double findMedianSortedArrays(int[] A, int[] B) {
        int m = A.length, n = B.length;
        int l = (m + n + 1) / 2;
        int r = (m + n + 2) / 2;
        return (getkth(A, 0, B, 0, l) + getkth(A, 0, B, 0, r)) / 2.0;
    }

    public double getkth(int[] A, int aStart, int[] B, int bStart, int k) {
        if (aStart > A.length - 1) return B[bStart + k - 1];            
        if (bStart > B.length - 1) return A[aStart + k - 1];                
        if (k == 1) return Math.min(A[aStart], B[bStart]);
    
        int aMid = Integer.MAX_VALUE, bMid = Integer.MAX_VALUE;
        if (aStart + k/2 - 1 < A.length) aMid = A[aStart + k/2 - 1]; 
        if (bStart + k/2 - 1 < B.length) bMid = B[bStart + k/2 - 1];        
    
        if (aMid < bMid) 
            return getkth(A, aStart + k/2, B, bStart,       k - k/2); 
        else 
            return getkth(A, aStart,       B, bStart + k/2, k - k/2);
    }
}

5. Longest Palindromic Substring

public class Solution {
    private int lo, maxLen;
    
    public String longestPalindrome(String s) {
        if (s.length() < 2){
            return s;
        }
    
        for (int i = 0; i < s.length()-1; i++) {
            extendPalindrome(s, i, i);  //assume odd length, try to extend Palindrome as possible
            extendPalindrome(s, i, i+1); //assume even length.
        }
        return s.substring(lo, lo + maxLen);
    }
    
    private void extendPalindrome(String s, int j, int k) {
        while (j >= 0 && k < s.length() && s.charAt(j) == s.charAt(k)) {
            j--;
            k++;
        }
        if (maxLen < k - j - 1) {
            lo = j + 1;
            maxLen = k - j - 1;
        }
    }
}

Effective Java ReadingNotes 4

Fri, 16 Dec 2016 18:18:24 +0800

Effective Java阅读笔记(4)

Effective Java第5章泛型

23.请不要在新代码中使用原生态类型

Set<Object>是个参数化类型，表示可以包含任何对象类型的一个集合；Set<?>则是一个通配符类型，表示只能包含某种未知对象类型的一个集合；Set则是个原生态类型，它脱离了泛型系统。前两种是安全的，最后一种不安全。

24.消除非受检警告

本处主要介绍比较难以消除的警告的示例。

如果无法消除警告，同时可以证明引起警告的代码是类型安全的，可以用一个@SuppressWarnings("unchecked")注解来禁止这条警告。应该始终在尽可能小的范围中使用SuppressWarnings注解，并且每当使用该注解时都要添加一条注释，说明为什么这么做是安全的。

25.列表优先于数组

数组是协变且可以具体化的；泛型是不可变的且可以被擦除的。因此，数组提供了运行时的类型安全，但是没有编译时的类型安全，反之，对于泛型也一样。一般来说，数组和泛型不能很好地混合使用。如果你发现自己将它们混合起来使用，并且得到了编译时错误或者警告，你的第一反应就应该是用列表代替数组。

26.优先考虑泛型

看如下一个简单堆栈的实现：

public class Stack {
    pprivate Object[] elements;
    private int size = 0;
    private static final int DEFAULT_INITAL_CAPACITY = 16;
    
    public Stack() {
        elements = new Object[DEFAULT_INITAL_CAPACITY];
    }
    
    public void push(Object e) {
        ensureCapacity();
        elements[size++] = e;
    }
    
    public Object pop() {
        if(size == 0) {
            throw new EmptyStackException();
        }
        Object result = elements[--size];
        elements[size] = null;
        return result;
    }
    
    public boolean isEmpty() {
        return size == 0;
    }

    private void ensureCapacity() {
        if(elements.length == size)
            elements = Arrays.copyOf(elements, 2 * size + 1);
    }
}

将该类泛型化可以提高类型的安全性，方便客户端使用(无需显式强制转换类型)

用类型参数替换所有的Object类型：private E[] elements;

由于不能创建不可具体化类型的数组，所以会报错generic array creation new E[DEFAULT_INITIAL_CAPACITY]

我们有两种解决办法：

解决方法：

1.创建一个Object数组，并将它转换成泛型数组类型：

elements = (E[]) new Object[DEFAULT_INITIAL_CAPACITY]; 错误变成一条警告，因为可以保证类型安全，所以可以用SupressWarning注释忽略掉该警告。

2.将elements域的类型从E[]改为Object[]：

private Object[] elements;

E result = (E) elements[--size];

产生一条警告，因为可以保证类型安全，所以可以用SupressWarning注释忽略掉该警告。

这两种方法，一般来说禁止数组类型的未受检转换比禁止标题类型更危险，所以建议使用第二种方法。但是在比这个例子更实际的泛型中，或许代码中会有多个地方需要从数组中读取元素，因此第一种方法比第二种方法开销更小一些，这也是第一种方法更常用的原因。这个例子看起来违反了25条(它告诉我们对于泛型列表要优于数组)，实际上因为Java并不是生来就支持列表，所以有些泛型如ArrayList必须使用数组来实现，有的时候为了提升性能，也会考虑用数组来实现，比如HashMap。

总之，使用泛型比使用需要在客户端代码中进行转化的类型来的更安全。也更容易，在设计新类的时候，要确保它们不需要这种转换就可以使用。这通常意味着要把类做成是泛型的。

27.优先考虑泛型方法

考虑如下的方法，它的作用是返回两个集合的联合：

public static Set union(Set s1, Set s2) {  
    Set result = new HashSet(s1);  
    result.addAll(s2);  
    return result;  
}

编译这段代码会产生警告，为了修正这些警告(在新代码中不应该直接使用原始类型，当前是为了举例子)要将方法声名修改为声明一个类型参数，表示这三个元素类型(两个参数及一个返回值)，并在方法中使用类型参数。声名类型参数的类型参数列表，处在方法的修饰符及其返回类型之间，修改后的代码如下：

public static <E> Set<E> union(Set<E> s1, Set<E> s2) {  
    Set<E> result = new HashSet<E>(s1);  
    result.addAll(s2);  
    return result;  
}

当前这个版本的union方法即为一般的泛型方法，但是它有一个限制，要求三个集合的类型(两个输入参数及一个返回值)必须全部相同。利用有限制的通配符类型可以使这个方法变得更回灵活。

泛型方法的一个显著特征是，无需明确指定类型参数的值，不像调用泛型构造器的时候是必须要指定类型参数的，在为泛型方法的类型会存在一个类型推导的过程。编译器通过检查方法参数的类型来计算类型的值。在调用泛型构造器的时候，要明确传递类型参数的值可能有点麻烦。类型参数出现在了变量的声明的左右两边，显得冗余：Map<String, List<String>> anagrams = new HashMap<String, List<String>>();

对于这情况，可以遵照第1条，提供一个静态工厂方法来简化：

public static <K, V> HashMap<K, V> newHashMap() {  
    return new HashMap<K, V>();  
}

利用上面的静态工厂方法，我们可以把变量声明右侧的参数类型省略掉，当参数类型多而复杂时尤其有效。

有时会需要创建不可变但是又适合于许多不同类型的对象，由于泛型是通过擦除来实现的，可以给所有的必要的类型参数使用同一个单个对象，但是需要一个静态的工厂方法来给每个必要的类型参数分发对象。这种模式叫做”泛型单例工厂”，这种模式最常用于函数的对象。假设有一个接口，描述了一个方法，该方法接受和返回某个类型T的值：

public interface UnaryFunction<T> {  
    T apply(T arg);
}

现在假设要提供一个恒等函数，如果在每次需要的时候都重新创建一个这样会很浪费，因为它是无状态的。如果泛型被具体化，那个每个类型都必须持有相应类型的恒等函数，但是在运行时擦除类型信息后，它们并没有什么区别，所以在这种情况下，只需要一个泛型单例就够了。

private static UnaryFunction
 INDENTITY_FUNCTION = new UnaryFunction {
    public Object apply(Object arg) { return arg; }  
}; 

@SuppressWarnings("unchecked")
public static  UnaryFunction indentityFunction() {
    return (UnaryFunction)INDENTITY_FUNCTION;
}

递归类型限制最普遍的用途与Comparable接口有关，它定义类型的自然顺序。许多方法都带有一个实现Comparable接口的元素列表，为了对列表进行排序，并在其中进行搜索，计算出它的最小值或者最大值等等。要完成这其中的任何一项工作要求列表中的每个元素都能够与列表中的其他元素相比较，一个示例：public static <T extends Comparable<T>> T max(List<T> list) { }

上面的声名要求T是可以与自身同类型对象相比较的类型，extends可以解释为”实现某功能”。

总之，泛型方法就像泛型一样，使用起来比要求客户端转换输入参数并返回值的方法来的更加安全，也更加容易。就像类型一样，你应该确保新的方法可以不用转换就能使用，这通常意味着要将它们泛型化。并且就像类型一样，还应该将现有的方法泛型化，使新用户使用起来更加轻松，且不会破坏现有的客户端。

28.利用有限制通配符来提升API的灵活性

为了获得最大限度的灵活性，要在表示生产者或者消费者的输入参数上使用通配符类型。PESC表示producter-extends, consumer-super。如果参数化类型表示一个T生产者，就使用<? extends T>；如果它表示一个T消费者，就使用<? super T>。

如果类型参数只在方法声明中出现一次，就可以用通配符取代它。

public static void swap(List<?> list, int i, int j) {  
    swapHelper(list, i, j);  
}  
  
private static <E> void swapHelper(List<E> list, int i, int j) {  
    list.set(i, list.set(j, list.get(i)));  
}

所有的comparable和comparator都是消费者。

29.优先考虑类型安全的异构容器

有时会需要未限定固定数目的类型参数的容器，此时，可以将容器的键进行参数化而不是将容器参数化。然后将参数化的键交给容器来插入或者获得值。用泛型系统来确保值的类型和它的键相符。

public class ManyTypeClass
{
    //一个存放数据的容器,由于键值类型是不确定的，那么值类型就只能是object类型
    private Map<Class<?>, Object> data = new HashMap<Class<?>, Object>();
    
    public <T> void putData(Class<T> type, T instance)
    {
        //吧数据放入进去
        if(type != null)
        {
            //这里需要进行一下类型转换，通过Class的cast方法，因为泛型是基于擦除的，如果不进行验证的话，那么插入的数据到底是不是真的type类型就无法确定的了
            data.put(type, type.cast(instance));
        }
    }
    
    public <T> T getDate(Class<T> type)
    {
        //取出数据,由于数据存放进去是object类型的，那么取出来的时候就需要进行一次类型转换
        return type.cast(data.get(type));
    }
    
    public static void main(String[] args)
    {
        ManyTypeClass mtc = new ManyTypeClass();
        mtc.putData(String.class, "cutter_point");
        mtc.putData(Integer.class, 0xcab145de);
        mtc.putData(Class.class, ManyTypeClass.class);
        mtc.putData(ManyTypeClass.class, mtc);
        
        String dataString = mtc.getDate(String.class);
        int dataInteger = mtc.getDate(Integer.class);
        Class<?> dataClass = mtc.getDate(Class.class);
        ManyTypeClass mtc1 = mtc.getDate(ManyTypeClass.class);
        
        System.out.printf("%s %x %s %s%n", dataString,
                dataInteger, dataClass.getName(), mtc1.getDate(String.class));
    }
}

不能存储List<String>。因为在运行时他们的类型会被擦除，所以List<String>与List<Integer>实际上是共用一个Class。

Effective Java ReadingNotes 3

Fri, 16 Dec 2016 14:18:24 +0800

Effective Java阅读笔记(3)

Effective Java第4章类和接口

13.使类和成员的可访问性最小化

访问控制机制决定了类、接口和成员的可访问性。实体的可访问性是由该实体声明所在的位置，以及该实体声明中所出现的访问修饰符共同决定的。

尽可能地使每个类或者成员不被外界访问。

私有的private——只有在声明该成员的顶层类内部才可以访问这个成员。
包级私有的package-private/default——声明该成员的包内部的任何类都可以访问这个成员。
受保护的protected——声明该成员的类的子类可以访问这个成员（有一些限制），并且，声明该成员的包内部的任何类也可以访问这个成员。
公有的public——在任何地方都可以访问该成员。

实现了Serializable接口的类的私有域可能会被“泄漏”。

子类中的访问级别不允许低于超类中的访问级别。

除了公有静态final域的特殊情形之外，公有类都不应该包含公有域。

14.在公有类中使用访问方法而非公有域

如果类可以在它所在的包的外部进行访问，就提供访问方法。公有类永远都不应该暴露可变的域。但是，有时候会需要用包级私有的或者私有的嵌套类来暴露域，无论这个类是可变还是不可变的。

15.使可变性最小化

不可变类只是其实例不能被修改的类。每个实例中包含的所有信息都必须在创建该实例的时候就提供，并在对象的整个生命周期内固定不变。不可变类比可变类更加易于设计、实现和使用。它们不容易出错，且更加安全。

为了使类成为不可变，要遵循下面五条规则：

不要提供任何会修改对象状态的方法。
保证类不会被扩展。一般使类成为final，但后面还会讨论其他做法。
使所有的域都是final的。
使所有的域都成为私有的。
确保对于任何可变组件的互斥访问。

不可变对象本质上是线程安全的，它们不要求同步；不仅可以共享不可变对象，甚至也可以共享它们的内部信息；不可以对象为其他对象提供了大量的构件。不可变类真正唯一的缺点是，对于每个不同的值都需要一个单独的对象。

让不可变的类变成final的另一种方法就是，让类的所有构造器都变成私有的或者包级私有的，并添加公有的静态工厂来代替公有的构造器。

*16.复合优先于继承

继承打破了封装性，子类依赖于其超类中特定功能的实现细节。只有当子类和超类之间确实存在子类型关系时，使用继承才是恰当的。

为了避免继承导致的脆弱性，我们可以用复合和转发机制来代替继承，尤其是当存在适当的接口可以实现包装类的时候。

public class ForwardingSet implements Set {
    private final Set s;

    public ForwardingSet(Set s) {
        this.s = s;
    }

    public void clear() {
        s.clear();
    }

    public boolean contains(Object o) {
        return s.contains(o);
    }

    public boolean isEmpty() {
        return s.isEmpty();
    }

    public int size() {
        return s.size();
    }

    public Iterator iterator() {
        return s.iterator();
    }

    public boolean add(E e) {
        return s.add(e);
    }

    public boolean remove(Object o) {
        return s.remove(o);
    }

    public boolean containsAll(Collection c) {
        return s.containsAll(c);
    }

    public boolean addAll(Collection c) {
        return s.addAll(c);
    }

    public boolean removeAll(Collection c) {
        return s.removeAll(c);
    }

    public boolean retainAll(Collection c) {
        return s.retainAll(c);
    }

    public Object[] toArray() {
        return s.toArray();
    }

    public  T[] toArray(T[] a) {
        return s.toArray(a);
    }

    @Override
    public boolean equals(Object o) {
        return s.equals(o);
    }

    @Override
    public int hashCode() {
        return s.hashCode();
    }

    @Override
    public String toString() {
        return s.toString();
    }
}

public class InstrumentedSet extends ForwardingSet {
    private int addCount = 0;

    public InstrumentedSet(Set s) {
        super(s);
    }

    @Override
    public boolean add(E e) {
        addCount++;
        return super.add(e);
    }

    @Override
    public boolean addAll(Collection c) {
        addCount += c.size();
        return super.addAll(c);
    }

    public int getAddCount() {
        return addCount;
    }
}

17.要么为继承而设计，并提供文档说明，要么就禁止继承

为继承而设计的类必须有文档说明它可覆盖overridable的方法的自用性，且必须通过某种形式提供适当的钩子hook，以便能够进入到它的内部工作流程中，这种形式可以使精心选择的受保护protected的方法，也可以是受保护的域，后者比较少见。该类的唯一的测试方法就是编写子类。

为了允许继承，类还必须遵守其他一些约束。构造器决不能调用可被覆盖的方法，无论是直接调用还是间接调用。

18.接口优于抽象类

现有的类可以很容易被更新，以实现新的接口。
接口是定义mixin(混合类型)的理想选择。
接口允许我们构造非层次结构的类型框架。

抽象类的演变比接口的演变要容易得多。接口一旦被公开发行，并且已被广泛实现，再想改变这个接口几乎是不可能的。

19.接口只用于定义类型

接口应该只被用来定义类型，不应该被用来导出常量，导出常量可以使用枚举类型和不可实例化的工具类。

20.类层次优于标签类

标签类过于冗长、容易出错，并且效率低下。标签类很少有适用的时候，当你想要编写一个包含显式标签域的类时，应该考虑一下这个标签是否可以被取消，这个类是否可以使用类层次来代替。

以下为一个标签类：

class Figure {  
    enum Shape { RECTANGLE, CIRCLE };  
  
    // Tag field - the shape of this figure  
    final Shape shape;  
  
    // These fields are used only if shape is RECTANGLE  
    double length;  
    double width;  
  
    // This field is used only if shape is CIRCLE  
    double radius;  
  
    // Constructor for circle  
    Figure(double radius) {  
        shape = Shape.CIRCLE;  
        this.radius = radius;  
    }  
  
    // Constructor for rectangle  
    Figure(double length, double width) {  
        shape = Shape.RECTANGLE;  
        this.length = length;  
        this.width = width;  
    }  
  
    double area() {  
        switch(shape) {  
          case RECTANGLE:  
            return length * width;  
          case CIRCLE:  
            return Math.PI * (radius * radius);  
          default:  
            throw new AssertionError();  
        }  
    }  
}

修改后：

abstract class Figure {  
    abstract double area();  
}  
class Circle extends Figure {  
    final double radius;  
  
    Circle(double radius) { this.radius = radius; }  
  
    double area() { return Math.PI * (radius * radius); }  
}  
class Rectangle extends Figure {  
    final double length;  
    final double width;  
  
    Rectangle(double length, double width) {  
        this.length = length;  
        this.width  = width;  
    }  
    double area() { return length * width; }  
}  
class Square extends Rectangle {  
    Square(double side) {  
        super(side, side);  
    }  
}

21.用函数对象表示策略

函数指针的主要用途就是实现策略模式。为了在Java中实现这种模式，要声明一个接口来表示该策略，并且为每个具体策略声明一个实现了该接口的类。当一个具体的策略只被使用一次时，通常使用匿名内部类来声明和实例化这个具体策略类。当一个具体策略被设计用来重复使用的时候，它的类通常要被实现为私有的静态成员，并通过公有的静态final域被导出，其类型为该策略接口。

Arrays.sort(StringArray,new Comparator(){
    public int compare(String s1, String s2) {
        return s1.length() - s2.length();
    }
});

public class Host {
    private static class StrLenCmp implements Comparator,Serializable{
 
        @Override
        public int compare(String s1, String s2) {
            return s1.length() - s2.length();
        }
    }
     
    public static final Comparator STRING_LENGTH_COMPARATOR = new StrLenCmp();
     
    public static void main(String[] args) {
        String s1 = "";
        String s2 = "";
        int result = Host.STRING_LENGTH_COMPARATOR.compare(s1, s2);
        System.out.println(result);
    }
}

22.优先考虑静态成员类

嵌套类是指被定义在另一个类的内部的类。嵌套类存在的目的应该只是为他的外围类提供服务。如果嵌套类将来可能会用于其他的某个环境中，他就应该是顶层类。嵌套类有四种：静态成员类、非静态成员类、匿名类和局部类。除了第一种之外，其他三种都称为内部类。

从语法上讲，静态成员类和非静态成员类之间的唯一区别是，静态成员类的声明中包含修饰符static。尽管他们的语法非常相似，但是两种嵌套类有很大的不同。非静态成员类的每个实例都隐含着与外围类的一个外围实例相关联。在非静态成员类的实例方法内部，可以调用外围实例上的方法，或者利用修改过的this构造获得外围实例的引用。如果嵌套类的实例可以在他外围类的实力之外独立存在，这个嵌套类就必须是静态成员类，在没有外围实例的情况下，要想创建非静态成员类的实例是不可能的。

当非静态成员类的实例被创建的时候，他和外围之间的关联关系也随之被创立起来；而且，这种关联关系以后不能被修改。通常情况下，当在外围类的某个实例方法的内部调用非静态成员类的构造器时，这种关系被自动建立起来。使用表达式enclosingInstance.new MemberClass(args)来手工建立这种关联关系也是有可能的，但是很少使用。正如你所预料的那样，这种关联关系需要消耗费静态成员类的实例空间，并且构造的时间开销。

如果声明成员类不要求访问外围实例，就要始终把static修饰符放在他的声明中。

匿名类的三种常见用法：1.动态的创建函数对象，如sort方法的调用利用了匿名的Comparator实例；2.创建过程对象，如Runnable、Thread或者TimerTask实例；3.在静态工厂方法的内部使用。

如果一个嵌套类需要在单个方法之外仍然是可见的，或者他太长了，不适合方法内部，就应该使用成员类。如果成员类的每个实例都需要一个指向其外围实例的引用，就要把成员类做成非静态的；否则就做成静态的。假设这个嵌套类属于一个方法的内部，如果你需要在一个地方创建实例，并且已经有了一个预置的类型可以说明这个类的特征，就把他做成匿名类；否则，就做成局部类。

Effective Java ReadingNotes 2

Thu, 15 Dec 2016 19:18:24 +0800

Effective Java阅读笔记(2)

Effective Java第3章对于所有对象都通用的方法

8.覆盖equals时请遵守通用约定

覆盖Object.equals的时机：类具有自己特有的“逻辑相等”概念（不同于对象等同的概念），而且超类还没有覆盖equals以实现期望的行为。这通常属于“值类”的情形，有一种“值类”不需要覆盖equals方法，即用实例受控确保“每个值至多只存在一个对象”的类，比如枚举类型。

在覆盖equals方法的时候，你必须要遵守它的通用约定：

自反性。对于任何非null的引用值x,x.equals(x)必须返回true。
对称性。对于任何非null的引用值x和y，当且仅当y.equals(x)返回true时，x.equals(y)必须返回true。
传递性。对于任何非null的引用值x、y和z，如果x.equals(y)返回true，并且y.equals(z)也返回true，那么x.equals(z)也必须返回true。
一致性。对于任何非null的引用值x和y，只要equals的比较操作在对象中所用的信息没有被修改，多次调用x.equals(y)就会一致地返回true，或者一致地返回false。
对于任何非null的引用值x,x,equals(null)必须返回false。

实现高质量equals方法的诀窍：

使用==操作符检查“参数是否为这个对象的引用”。如果是，则返回true。这只不过是一种性能优化，如果比较操作有可能很昂贵，就值得这么做。
使用instanceof操作符检查“参数是否为正确的类型”。如果不是，则返回false。
把参数转换成正确的类型。因为转换前进行过instanceof测试，所以确保会成功。
对于该类中的每个“关键”域，检查参数中的域是否与该对象中对应的域相匹配。如果这些测试全部成功，则返回true，否则返回false。

对于既不是float也不是double类型的基本类型域，可以使用==操作符进行比较，对于对象引用域，可以递归地调用equals方法；对于float域，可以使用Float.compare方法；对于double域，则使用Double.compare。

9.覆盖equals时总要覆盖hashCode

Object.hashCode的通用约定：

在应用程序的执行期间，只要对象的equals方法的比较操作所用到的信息没有被修改，那么对这同一个对象调用多次,hashCode方法都必须始终如一地返回同一个整数。在同一个应用程序的多次执行过程中，每次执行所返回的整数可以不一致。
如果两个对象根据equals(Object)方法比较是相等的，那么调用这两个对象中任意一个对象的hashCode方法都必须产生同样的整数结果。
如果两个对象根据equals(Object)方法比较是不相等的，那么调用这两个对象中任意一个对象的hashCode方法，则不一定要产生不同的整数结果。但是程序员应该知道，给不相等的对象产生截然不同的整数结果，有可能提高散列表的性能。

10.始终要覆盖toString

提供好的toString实现可以使类用起来更加舒适，在实际应用中，toString方法应该返回对象中包含的所有值得关注的信息。

11.谨慎地覆盖clone

Clone方法的通用约定：对于任何对象x，表达式x.clone() != x 将会是true，并且，表达式x.clone().getClass() == x.getClass()将会是true，但这些都不是绝对的要求。虽然通常情况下，表达式x.clone().equals(x)将会是true，但是，这也不是一个绝对的要求。拷贝对象往往会导致创建它的类的一个新实例，但它同时也会要求拷贝内部的数据结构。这个过程中没有调用构造器。

所有实现了Cloneable接口的类都应该用一个公有的方法覆盖clone。此公有方法首先调用super.clone，然后修正任何需要修正的域。一般情况下，这意味着要拷贝任何包含内部“深层结构”的可变对象，并用指向新对象的引用代替原来指向这些对象的引用。虽然，这些内部拷贝操作往往可以通过递归地调用clone来完成，但这通常并不是最佳方法。如果该类只包含基本类型的域，或者指向不可变对象的引用，那么多半的情况是没有域需要修正。这条规则也有例外，譬如，代表序列号或其他唯一ID值得域，或者代表对象的创建时间的域，不管这些域是基本类型还是不可变的，它们也都需要被修正。

另一个实现对象拷贝的好办法是提供一个拷贝构造器或拷贝工厂。拷贝构造器只是一个构造器，它唯一的参数类型是包含该构造器的类。如public Go(Go go);，拷贝工厂是类似于拷贝构造器的静态工厂public static Go newInstance(Go go);

12.考虑实现Comparable接口

compareTo方法的通用约定：

讲这个对象与指定的对象进行比较。当该对象小于、等于或大于指定对象的时候，分别返回一个负整数、零或者正整数。如果由于指定对象的类型而无法与该对象进行比较，则抛出ClassCastException异常。

在下面的说明中，符号sgn表示数学中的signum函数，它根据表达式的值为负值、零和正值，分别返回-1、0或1。

实现者必须确保所有的x和y都满足sgn(x.compareTo(y)) == -sgn(y.compareTo(x))。
实现者还必须确保这个比较关系是可传递的。
最后，实现者必须确保x.compareTo(y) == 0暗示着所有的z都满足sgn(x.compareTo(z)) == sgn(y.compareTo(z))。
强烈建议(x.compareTo(y) == 0) == (x.equals(y))，但这并非绝对必要。一般说来，任何实现了Comparable接口的类，若违反了这个条件，都应该明确予以说明。推荐使用这样的说法：“注意：该类具有内在的排序功能，但是与equals不一致。”

Effective Java ReadingNotes 1

Thu, 15 Dec 2016 16:16:24 +0800

Effective Java阅读笔记(1)

Effective Java第2章创建和销毁对象

1.考虑用静态工厂方法代替构造器

静态工厂方法相较于构造器有四大优势：（1）它们有名称；（2）不必在每次调用它们的时候都创建一个新对象；（3）它们可以返回原返回类型的任何子类型的对象；（4）在创建参数化类型实例时，它们使代码变得更加简洁。两大缺点：（1）类如果不含公有的或受保护的构造器，就不能被子类化；（2）它们与其他的静态方法实际上并没有任何区别。

2.遇到多个构造器参数时要考虑用构建器

一个很直观的例子：

public class NutritionFacts {
    private final int servingSize;
    private final int servings;
    private final int calories;
    private final int fat;

    public static class Builder {
        private final int servingSize;
        private final int servings;

        private int calories = 0;
        private int fat = 0;

        public Builder(int servingSize, int servings){
            this.servingSize = servingSize;
            this.servings = servings;
        }

        public Builder calories(int val){
            calories = val;
            return this;
        }

        public Builder fat(int val){
            fat = val;
            return this;
        }

        public NutritionFacts build(){
            return new NutritionFacts(this);
        }
    }

    private NutritionFacts(Builder builder){
        servingSize = builder.servingSize;
        servings = builder.servings;
        calories = builder.calories;
        fat = builder.fat;
    }
}

当需要创建一个实例时只需根据自己的需要添加参数NutritionFacts cocaCola = new Builder(240,8).calories(100).build();。

3.用私有构造器或者枚举类型强化Singleton属性

除了非常常见的两种单例实现方法外，在Java 1.5之后我们有了一个更好的选择，使用单元素枚举类型：

public enum SingleTon {
    INSTANCE;
    public void orz() {
        //blablabla
    }
}

然后如此调用SingleTon s1 = SingleTon.INSTANCE;s1.orz();

4.通过私有构造器强化不可实例化的能力

对于一些只包含静态方法和静态域的工具类，我们不希望它被实例化，可以通过以下方式进行强化：

public class UtilityClass{
    //Suppress default constructor for moninstantiability
    private UtilityClass(){
        throw new AssertionError();
    }
    ...
}

5.避免创建不必要的对象

一般来说，最好能重用对象而不是在每次需要的时候就创建一个相同功能的新对象。

对于可重用的对象可以通过使用一个静态的初始化器static{}来创建以避免重复创建，要优先使用基本类型而不是装箱基本类型，要当心无意识的自动装箱。维护自己的对象池来避免创建对象并不是一种好的做法，除非池中的对象是非常重量级的，其中一个典型示例为数据库连接池。

6.消除过期的对象引用

要警惕内存泄漏问题，及时清除过期引用，使用合适的数据结构保存缓存、监听器以及其他回调，例如WeakReference。

7.避免使用终结方法

finalizer通常是不可预测的，也是很危险的，一般情况下是不必要的，并且该方法会导致严重的性能损失。如果类的对象中封装的资源确实需要终止，我们应该提供一个显式的终止方法，并要求该类的客户端在每个实例不再有用的时候调用这个方法。终结方法有两种合法用途：1、充当”安全网”；2、终止非关键的本地资源。