Effective Java 要么为继承设计，并提供文档说明，要么就禁止继承

内容导读

互联网集市收集整理的这篇技术教程文章主要介绍了Effective Java 要么为继承设计，并提供文档说明，要么就禁止继承，小编现在分享给大家，供广大互联网技能从业者学习和参考。文章包含3418字，纯文字阅读大概需要5分钟。

内容图文

首先，该类的文档必须精确地描述覆盖每个方法所带来的影响。换句话说，该类必须有文档说明他可覆盖（overridable）的方法的自用型（self-use）。
对于每个共有的或受保护的方法或构造器，他的文档必须指明该方法或者构造器调用了哪些可覆盖的方法，是以什么顺序调用的，每个调用的结果又是如何影响后续的处理过程的。更一般的，类必须在文档中说明，在哪些情况下会调用可覆盖的方法。（例如：后台的线程或者静态的初始化可能会调用这个方法）
按惯例，如果方法调用了可覆盖的方法，在他的文档注释的末尾应该包含关于这些调用的描述信息。
好的API应该是描述一个给定的方法做了什么工作，而不是描述他是如何做到的。
类必须通过某种形式提供适当的钩子（hook），以便能够进入他的内部工作流程中，这种实行可以精心选择受保护的（protected）方法。
demo:

1. AbstractList:

2. /**

3. * Removes from this list all of the elements whose index is between

4. * {@code fromIndex}, inclusive, and {@code toIndex}, exclusive.

5. * Shifts any succeeding elements to the left (reduces their index).

6. * This call shortens the ArrayList by {@code (toIndex - fromIndex)}

7. * elements. (If {@code toIndex==fromIndex}, this operation has no

8. * effect.)

9. *

10. * <p>This method is called by the {@code clear} operation on this list

11. * and its subLists. Overriding this method to take advantage of

12. * the internals of the list implementation can <i>substantially</i>

13. * improve the performance of the {@code clear} operation on this list

14. * and its subLists.

15. *

16. * <p>This implementation gets a list iterator positioned before

17. * {@code fromIndex}, and repeatedly calls {@code ListIterator.next}

18. * followed by {@code ListIterator.remove} until the entire range has

19. * been removed. <b>Note: if {@code ListIterator.remove} requires linear

20. * time, this implementation requires quadratic time.</b>

21. *

22. * @param fromIndex index of first element to be removed

23. * @param toIndex index after last element to be removed

24. */

25. protected void removeRange(int fromIndex, int toIndex) {

26. ListIterator<E> it = listIterator(fromIndex);

27. for (int i=0, n=toIndex-fromIndex; i<n; i++) {

28. it.next();

29. it.remove();

30. }

31. }

32. ArrayList:

33. protected void removeRange(int fromIndex, int toIndex) {

34. modCount++;

35. int numMoved = size - toIndex;

36. System.arraycopy(elementData, toIndex, elementData, fromIndex,

37. numMoved);

38.  

39. // Let gc do its work

40. int newSize = size - (toIndex-fromIndex);

41. while (size != newSize)

42. elementData[--size] = null;

43. }

对于为了继承而设计的类，唯一的测试方法就是编写子类。


构造器决不能调用可覆盖的方法：
超类的构造器在子类的构造器之前运行，所以，子类中覆盖版本的方法将会在子类的构造器运行之前就先被调用。如果该覆盖的版本的方法依赖于子类构造器所执行的任何初始化工作，该方法将不会如预期般的执行。
demo：

1. package cn.partner4java.test;

2.  

3. public class Super {

4. public Super() {

5. overrideMe();

6. }

7. public void overrideMe(){

8.  

9. }

10. }

11. package cn.partner4java.test;

12.  

13. import java.util.Date;

14.  

15. public final class Sub extends Super {

16. private final Date date;

17. public Sub() {

18. date = new Date();

19. }

20. public void overrideMe() {

21. System.out.println(date);

22. }

23. public static void main(String[] args) {

24. Sub sub = new Sub();

25. sub.overrideMe();

26. // 后台打印：

27. // null

28. // Wed Mar 21 22:28:49 CST 2012

29. }

30. }

在为了继承而设计类时，Cloneable和Serializable接口出现了特殊的困难。


为了继承而实现类，对这个类会有一些实质性的限制。


对于那些并非为了安全的进行子类化而设计和编写的文档的类，要禁止子类化。
有两种方法禁止之类化：
把类声明为final的；把所有的构造器变为私有的，或者包级私有的，并增加一些共有的静态工厂来替代构造器。

内容总结

以上是互联网集市为您收集整理的Effective Java 要么为继承设计，并提供文档说明，要么就禁止继承全部内容，希望文章能够帮你解决Effective Java 要么为继承设计，并提供文档说明，要么就禁止继承所遇到的程序开发问题。 如果觉得互联网集市技术教程内容还不错，欢迎将互联网集市网站推荐给程序员好友。

内容备注

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 gblab@vip.qq.com 举报，一经查实，本站将立刻删除。

内容手机端