Effective.Java第56-66条(规范相关)】的更多相关文章

<<Effective Java>> 第四十三条:返回零长度的数组或者集合,而不是null 如果一个方法的返回值类型是集合或者数组 ,如果在方法内部需要返回的集合或者数组是零长度的,也就是没有实际对象在里面, 我们也应该放回一个零长度的数组或者集合,而不是返回null.如果返回了null,客户端程序员就要检测返回的是不是null,然后才能 进行下一步操作,否则就会引发NullPointException.但是如果是返回的的是空数组或者集合,就不会再后续的使用这个对象上,引发 空指针…
56.  为所有已公开的API元素编写文档注释 要正确地记录API,必须在每个导出的类.接口.构造方法.方法和属性声明之前加上文档注释.如果一个类是可序列化的,还需要记录它的序列化形式. 文档注释在源代码和生成的代码中都应该是可读的通用原则. 类或接口中的两个成员方法或构造方法不应具有相同的概要描述. 总结起来就是一句话,文档注释要规范. 阿里规约如下: [强制]类.类属性.类方法的注释必须使用 Javadoc 规范,使用/**内容*/格式,不得使用 // xxx 方式.[强制]所有的抽象方法(…
45.  明智谨慎地使用Stream 46.  优先考虑流中无副作用的函数 47.  优先使用Collection而不是Stream作为方法的返回类型 48.  谨慎使用流并行 49.  检查参数有效性 大多数方法和构造方法对可以将哪些值传到其对应参数有一些限制.例如:索引必须是非负数.对象引用必须是非null.你应该清楚地在文档中记载所有这些限制,并在方法主体的开头用检查来强制执行. 每次编写方法或构造方法时,都应该考虑对其参数存在哪些限制.应该记住这些限制,并在方法体的开头使用显示检查来强制…
第63条建议使用工具函数downloadAllAsync接收一个URL数组并下载所有文件,结果返回一个存储了文件内容的数组,每个URL对应一个字符串.downloadAllAsync并不只有清理嵌套回调函数的好处,其主要好处是并行下载文件.我们可以在同一个事件循环中一次启动所有文件的下载,而不用等待每个文件完成下载.并行逻辑是微妙的,很容易出错.下面有实现有一个隐藏的缺陷. function downloadAllAsync(urls,onsuccess,onerror){ var result…
对于类而言,为了让client获取它自身的一个实例,最经常使用的方法就是提供一个共同拥有的构造器. 另一种放你发,也应该子每一个程序猿的工具箱中占有一席之地.类能够提供一个共同拥有的静态 工厂方法.它仅仅是返回类的实例的静态方法. 类能够通过静态工厂方法类提供它的client(对象),而不是通过构造器.提这样做的优点有: 1.静态工厂方法与构造器不同的第一大优势在于.它们有名称.比方构造器BigInteger(int,int,Random)返回的BigInteger可能为素数,假设用名为BigI…
使用JAVA这门OO语言,第一要义就是,如果类不是专门设计来用于被继承的就尽量不要使用继承而应该使用组合 从上图2看,我们的类B复写了类A的add喝addALL方法,目的是每次调用的时候,我们就能统计调用类A的次数,实际上我们调用了一次类B 但是实例对象b的count变量却变成了2,解释的原因在图1里面我已经做了黑板画了,这个例子是effective Java里面的一条忠告,十分有意义, 少用继承,除非类是专门被用于来继承的,例如安卓开发里面的activity类是专门被设计用于继承的,这些类可以…
概要 本章是从<Effective Java>摘录整理出来的关于异常处理的几条建议.内容包括:第1条: 只针对不正常的情况才使用异常第2条: 对于可恢复的条件使用被检查的异常,对于程序错误使用运行时异常第3条: 避免不必要的使用被检查的异常第4条: 尽量使用标准的异常第5条: 抛出的异常要适合于相应的抽象第6条: 每个方法抛出的异常都要有文档第7条: 在细节消息中包含失败 -- 捕获消息第8条: 努力使失败保持原子性第9条: 不要忽略异常 它们对应原书中"第8章 异常"部分…
<Effective Java>这本书的结构是90来条tips,有长有短,每条tip都值的学习.这里根据对书中每条tip的理解做简短的总结,方便日后回顾.持续更新~ 1. 考虑用静态方法代替构造方法 要考虑使用静态方法返回对象的理由如下: (1)构造方法名字没有特殊含义,只能是类名.而静态方法可以自己取名,让人一看就知道这个方法的作用.如:Executors.newFixedThreadPool(); (2)构造方法没有静态方法灵活,构造方法一旦调用就必然生成了对象,而静态方法里则可以自己写代…
避免使用终结方法(finalizer) 终结方法(finalizer)通常是不可预测的,也是很危险的,一般情况下是不必要的. 不要把finalizer当成C++中析构函数的对应物.java中,当对象不可达时(即没有引用指向这个对象时),会由垃圾回收器来回收与该对象相关联的内存资源:而其他的内存资源,则一般由try-finally代码块来完成类似的工作. 一.finalizer的缺点: 1. 终结方法的缺点在于不能保证会被及时地执行. 及时执行finalizer方法是JVM垃圾回收方法的一个主要功…
Effective Java通俗理解(上) 第31条:用实例域代替序数 枚举类型有一个ordinal方法,它范围该常量的序数从0开始,不建议使用这个方法,因为这不能很好地对枚举进行维护,正确应该是利用实例域,例如: 1 /** 2 * 枚举类型错误码 3 * Created by yulinfeng on 8/20/17. 4 */ 5 public enum ErrorCode { 6 FAILURE(0), 7 SUCCESS(1); 8 9 private final int code;…