From 8351bda672a8f374022ab30e6afb89fd5de532f8 Mon Sep 17 00:00:00 2001 From: 1326670425 <1326670425@qq.com> Date: Thu, 11 Jul 2019 09:35:42 +0800 Subject: [PATCH 01/25] =?UTF-8?q?=E7=AC=AC=E5=8D=81=E4=BA=8C=E7=AB=A0=20?= =?UTF-8?q?=E9=9B=86=E5=90=88=20=E7=BF=BB=E8=AF=91=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E8=87=B3List?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/12-Collections.md | 308 ++++++++++++++++++++++++++++++++++++ 1 file changed, 308 insertions(+) diff --git a/docs/book/12-Collections.md b/docs/book/12-Collections.md index bf50850..684b280 100644 --- a/docs/book/12-Collections.md +++ b/docs/book/12-Collections.md @@ -3,22 +3,330 @@ # 第十二章 集合 +> 如果一个程序只包含固定数量的对象且对象的生命周期都是已知的，那么这是一个非常简单的程序。 + +通常，程序总是根据运行时才知道的某些条件去创建新的对象。在此之前，无法知道所需对象的数量甚至确切类型。为了解决这个普遍的编程问题，需要在任意时刻和任意位置创建任意数量的对象。因此，不能依靠创建命名的引用来持有每一个对象： +```java +MyType aReference +``` +因为从来不会知道实际需要多少个这样的引用。 + +大多数编程语言都提供了某种方法来解决这个基本问题。Java有多种方式保存对象（确切地说，是对象的引用）。例如前边曾经学习过的数组，它是编译器支持的类型。数组是保存一组对象的最有效的方式，如果想要保存一组基本类型数据，也推荐使用数组。但是数组具有固定的大小尺寸，而且在更一般的情况下，在写程序的时候并不知道将需要多少个对象，或者是否需要更复杂的方式来存储对象，因此数组尺寸固定这一限制就显得太过受限了。 + +**java.util** 库提供了一套相当完整的*集合类*（collection classes）来解决这个问题，其中基本的类型有 **List** 、**Set** 、 **Queue** 和 **Map**。这些类型也被称作*容器类*（container classes），但我将使用Java类库使用的术语。集合提供了完善的方法来保存对象，可以使用这些工具来解决大量的问题。 + +集合还有一些其它特性。例如， **Set** 对于每个值都只保存一个对象， **Map** 是一个关联数组，允许将某些对象与其他对象关联起来。Java集合类都可以自动地调整自己的大小。因此，与数组不同，在编程时，可以将任意数量的对象放置在集合中，而不用关心集合应该有多大。 + +尽管在Java中没有直接的关键字支持，集合类仍然是可以显著增强编程能力的基本工具。在本章中，将介绍Java集合类库的基本知识，并重点介绍一些典型用法。这里将专注于在日常编程中使用的集合。稍后，在[附录：集合主题]()中，还将学习到其余的那些集合和相关功能，以及如何使用它们的更多详细信息。 ## 泛型和类型安全的集合 +使用Java SE5之前的集合的一个主要问题是编译器允许你向集合中插入不正确的类型。例如，考虑一个 **Apple** 对象的集合，这里使用最基本最可靠的 **ArrayList** 。现在，可以把 **ArrayList** 看作“可以自动扩充自身尺寸的数组”来看待。使用 **ArrayList** 相当简单：创建一个实例，用 **add()** 插入对象；然后用 **get()** 来访问这些对象，此时需要使用索引，就像数组那样，但是不需要方括号。 **ArrayList** 还有一个 **size()** 方法，来说明集合中包含了多少个元素，所以不会不小心因数组越界而引发错误（通过抛出*运行时异常*，[异常]()章节介绍了异常）。 + +在本例中， **Apple** 和 **Orange** 都被放到了集合中，然后将它们取出。正常情况下，Java编译器会给出警告，因为这个示例没有使用泛型。在这里，使用特定的注解来抑制警告信息。注解以“@”符号开头，可以带参数。这里的 **@SuppressWarning** 注解及其参数表示只抑制“unchecked”类型的警告（[注解]()章节将介绍更多有关注解的信息）： + +```java +// collections/ApplesAndOrangesWithoutGenerics.java +// Simple collection use (suppressing compiler warnings) +// {ThrowsException} +import java.util.*; + +class Apple { + private static long counter; + private final long id = counter++; + public long id() { return id; } +} + +class Orange {} + +public class ApplesAndOrangesWithoutGenerics { + @SuppressWarnings("unchecked") + public static void main(String[] args) { + ArrayList apples = new ArrayList(); + for(int i = 0; i < 3; i++) + apples.add(new Apple()); + // No problem adding an Orange to apples: + apples.add(new Orange()); + for(Object apple : apples) { + ((Apple) apple).id(); + // Orange is detected only at run time + } + } +} +/* Output: +___[ Error Output ]___ +Exception in thread "main" +java.lang.ClassCastException: Orange cannot be cast to +Apple + at ApplesAndOrangesWithoutGenerics.main(ApplesA +ndOrangesWithoutGenerics.java:23) +*/ +``` + +**Apple** 和 **Orange** 是截然不同的，它们除了都是 **Object** 之外没有任何共同点（如果一个类没有显式地声明继承自哪个类，那么它就自动继承自 **Object**）。因为 **ArrayList** 保存的是 **Object** ，所以不仅可以通过 **ArrayList** 的 **add()** 方法将 **Apple** 对象放入这个集合，而且可以放入 **Orange** 对象，这无论在编译期还是运行时都不会有问题。当使用 **ArrayList** 的 **get()** 方法来取出你认为是 **Apple** 的对象时，得到的只是 **Object** 引用，必须将其转型为 **Apple**。然后需要将整个表达式用括号括起来，以便在调用 **Apple** 的 **id()** 方法之前，强制执行转型。否则，将会产生语法错误。 + +在运行时，当尝试将 **Orange** 对象转为 **Apple**时，会出现输出中显示的错误。 + +在[泛型]()章节中，你将了解到使用Java泛型来创建类可能很复杂。但是，使用预先定义的泛型类却相当简单。例如，要定义一个用于保存 **Apple** 对象的 **ArrayList** ，只需要使用 **ArrayList** 来代替 **ArrayList** 。尖括号括起来的是*类型参数*（可能会有多个），它指定了这个集合实例可以保存的类型。 + +通过使用泛型，就可以在编译期防止将错误类型的对象放置到集合中。下面还是这个示例，但是使用了泛型： +```java +// collections/ApplesAndOrangesWithGenerics.java +import java.util.*; + +public class ApplesAndOrangesWithGenerics { + public static void main(String[] args) { + ArrayList apples = new ArrayList<>(); + for(int i = 0; i < 3; i++) + apples.add(new Apple()); + // Compile-time error: + // apples.add(new Orange()); + for(Apple apple : apples) { + System.out.println(apple.id()); + } + } +} +/* Output: +0 +1 +2 +*/ +``` + +在 **apples** 定义的右侧，可以看到 **new ArrayList<>()** 。这有时被称为“菱形语法”(diamond syntax)。在Java 7之前，必须要在两端都进行类型声明，如下所示： + +```java +ArrayList apples = new ArrayList(); +``` + +随着类型变得越来越复杂，这种重复产生的代码非常混乱且难以阅读。程序员发现所有类型信息都可以从左侧获得，因此，编译器没有理由强迫右侧在重复这些。Java语言团队采纳了这种*类型推断*（type inference）的请求，即使只是这么小的一点。 + +有了 **ArrayList** 声明中的类型指定，编译器会阻止将 **Orange** 放入 **apples** ，因此，这会成为一个编译期错误而不是运行时错误。 + +使用泛型，从 **List** 中获取元素不需要强制类型转换。因为 **List** 知道它持有什么类型，因此当调用 **get()** 时，它会替你执行转型。这样，不仅可以知道编译器将会检查放入集合中的对象的类型，而且在使用集合中的对象时，可以使用更加清晰的语法。 + +当指定了某个类型为泛型参数时，并不仅限于只能将确切类型的对象放入集合中。向上转型也可以像作用于其他类型一样作用于泛型： +```java +// collections/GenericsAndUpcasting.java +import java.util.*; + +class GrannySmith extends Apple {} +class Gala extends Apple {} +class Fuji extends Apple {} +class Braeburn extends Apple {} + +public class GenericsAndUpcasting { + public static void main(String[] args) { + ArrayList apples = new ArrayList<>(); + apples.add(new GrannySmith()); + apples.add(new Gala()); + apples.add(new Fuji()); + apples.add(new Braeburn()); + for(Apple apple : apples) + System.out.println(apple); + } +} +/* Output: +GrannySmith@15db9742 +Gala@6d06d69c +Fuji@7852e922 +Braeburn@4e25154f +*/ +``` + +因此，可以将 **Apple** 的子类型添加到被指定为保存 **Apple** 对象的集合中。 + +程序的输出是从 **Object** 默认的 **toString()** 方法产生的，该方法打印类名，后边跟着对象的散列码的无符号十六进制表示（这个散列码是通过 **hashCode()** 方法产生的）。将在[附录：理解equals和hashcode方法]()中了解有关散列码的内容。 ## 基本概念 +Java集合类库采用“保持对象”（holding objects）的思想，并将其分为两个不同的概念，表示为类库的基本接口： + +1. **集合（Collection）** ：一个独立元素的序列，这些元素都服从一条或多条规则。 **List** 必须以插入的方式保存元素， **Set** 不能包含重复元素， **Queue** 按照*排队规则*来确定对象产生的顺序（通常与它们被插入的顺序相同）。 +2. **映射（Map）** ： 一组成对的“键值对”对象，允许使用键来查找值。 **ArrayList** 使用数字来查找对象，因此在某种意义上讲，它是将数字和对象关联在一起。 **map**允许我们使用一个对象来查找另一个对象，它也被称作*关联数组*（associative array），因为它将对象和其它对象关联在一起；或者称作*字典*（dictionary），因为可以使用一个键对象来查找值对象，就像在字典中使用单词查找定义一样。 **Map**s是强大的编程工具。 + +尽管并非总是可行，但在理想情况下，你编写的大部分代码都在与这些接口打交道，并且唯一需要指定所使用的精确类型的地方就是在创建的时候。因此，可以像下面这样创建一个 **List** ： + +```java +List apples = new ArrayList<>(); +``` + +请注意， **ArrayList** 已经被向上转型为了 **List** ，这与之前示例中的处理方式正好相反。使用接口的目的是，如果想要改变具体实现，只需在创建时修改它就行了，就像下面这样： + +```java +List apples = new LinkedList<>(); +``` + +因此，应该创建一个具体类的对象，将其向上转型为对应的接口，然后在其余代码中都是用这个接口。 + +这种方式并非总是有效的，因为某些具体类有额外的功能。例如， **LinkedList** 具有 **List** 接口中未包含的额外方法，而 **TreeMap** 也具有在 **Map** 接口中未包含的方法。如果需要使用这些方法，就不能将它们向上转型为更通用的接口。 + +**Collection** 接口概括了*序列*的概念——一种存放一组对象的方式。下面是个简单的示例，用 **Integer** 对象填充了一个 **Collection** （这里用 **ArrayList** 表示），然后打印集合中的每个元素： +```java +// collections/SimpleCollection.java +import java.util.*; + +public class SimpleCollection { + public static void main(String[] args) { + Collection c = new ArrayList<>(); + for(int i = 0; i < 10; i++) + c.add(i); // Autoboxing + for(Integer i : c) + System.out.print(i + ", "); + } +} +/* Output: +0, 1, 2, 3, 4, 5, 6, 7, 8, 9, +*/ +``` + +这个例子仅适用 **Collection** 方法，所以任何继承自 **Collection** 的类的对象都可以使用。但是 **ArrayList** 是最基本的序列类型。 + +**add()** 方法的名称就表明它是在 **Collection** 中添加一个新元素。但是，文档中非常详细地叙述到 **add()** “要确保这个 **Collection** 包含指定的元素。”这是因为考虑到了 **Set** 的含义，因为在 **Set**中，只有当元素不存在时才会添加元素。在使用 **ArrayList** ，或任何其他类型的 **List** 时，**add()** 总是表示“把它放进去”，因为 **List** 不关心是否存在重复元素。 + +可以使用 *for-in* 语法来遍历所有的 **Collection** ，就像这里所展示的那样。在本章的后续部分，还将学习到一个更灵活的概念，*迭代器*。 ## 添加元素组 +在**java.util**包中的 **Arrays** 和 **Collections** 类中都有很多实用的方法，可以在一个 **Collection** 中添加一组元素。 **Arrays.asList()** 方法接受一个数组或是逗号分隔的元素列表（使用可变参数），并将其转换为 **List** 对象。 **Collections.addAll()** 方法接受一个 **Collection** 对象，以及一个数组或是一个逗号分隔的列表，将其中元素添加到 **Collection** 中。下边的示例展示了这两个方法，以及更通用的 **addAll()** 方法，所有 **Collection** 类型都包含该方法： + +```java +// collections/AddingGroups.java +// Adding groups of elements to Collection objects +import java.util.*; + +public class AddingGroups { + public static void main(String[] args) { + Collection collection = + new ArrayList<>(Arrays.asList(1, 2, 3, 4, 5)); + Integer[] moreInts = { 6, 7, 8, 9, 10 }; + collection.addAll(Arrays.asList(moreInts)); + // Runs significantly faster, but you can't + // construct a Collection this way: + Collections.addAll(collection, 11, 12, 13, 14, 15); + Collections.addAll(collection, moreInts); + // Produces a list "backed by" an array: + List list = Arrays.asList(16,17,18,19,20); + list.set(1, 99); // OK -- modify an element + // list.add(21); // Runtime error; the underlying + // array cannot be resized. + } +} +``` + +**Collection** 的构造器可以接受另一个 **Collection**，用它来将自身初始化。因此，可以使用 **Arrays.asList()** 来为这个构造器产生输入。但是， **Collections.addAll()** 运行得更快，而且很容易构建一个不包含元素的 **Collection** ，然后调用 **Collections.addAll()** ，因此这是首选方式。 + +**Collection.addAll()** 方法只能接受另一个 **Collection** 作为参数，因此它没有 **Arrays.asList()** 或 **Collections.addAll()** 灵活。这两个方法都使用可变参数列表。 + +也可以直接使用 **Arrays.asList()** 的输出作为一个 **List** ，但是这里的底层实现是数组，没法调整大小。如果尝试在这个 **List** 上调用 **add()** 或 **delete()**，由于这两个方法会尝试修改数组大小，所以会在运行时得到“Unsupported Operation（不支持的操作）”错误： + +```java +// collections/AsListInference.java +import java.util.*; + +class Snow {} +class Powder extends Snow {} +class Light extends Powder {} +class Heavy extends Powder {} +class Crusty extends Snow {} +class Slush extends Snow {} + +public class AsListInference { + public static void main(String[] args) { + List snow1 = Arrays.asList( + new Crusty(), new Slush(), new Powder()); + //- snow1.add(new Heavy()); // Exception + + List snow2 = Arrays.asList( + new Light(), new Heavy()); + //- snow2.add(new Slush()); // Exception + + List snow3 = new ArrayList<>(); + Collections.addAll(snow3, + new Light(), new Heavy(), new Powder()); + snow3.add(new Crusty()); + + // Hint with explicit type argument specification: + List snow4 = Arrays.asList( + new Light(), new Heavy(), new Slush()); + //- snow4.add(new Powder()); // Exception + } +} +``` + +在 **snow4** 中，注意 **Arrays.asList()** 中间的“hint”，告诉编译器 **Arrays.asList()** 生成的结果 **List** 类型的实际目标类型是什么。这称为*显式类型参数说明*（explicit type argument specification）。 ## 集合的打印 +必须使用 **Arrays.toString()** 来生成数组的可打印形式。但是打印集合无需任何帮助。下面是一个例子，这个例子中也介绍了基本的Java集合： +```java +// collections/PrintingCollections.java +// Collections print themselves automatically +import java.util.*; + +public class PrintingCollections { + static Collection + fill(Collection collection) { + collection.add("rat"); + collection.add("cat"); + collection.add("dog"); + collection.add("dog"); + return collection; + } + static Map fill(Map map) { + map.put("rat", "Fuzzy"); + map.put("cat", "Rags"); + map.put("dog", "Bosco"); + map.put("dog", "Spot"); + return map; + } + public static void main(String[] args) { + System.out.println(fill(new ArrayList<>())); + System.out.println(fill(new LinkedList<>())); + System.out.println(fill(new HashSet<>())); + System.out.println(fill(new TreeSet<>())); + System.out.println(fill(new LinkedHashSet<>())); + System.out.println(fill(new HashMap<>())); + System.out.println(fill(new TreeMap<>())); + System.out.println(fill(new LinkedHashMap<>())); + } +} +/* Output: +[rat, cat, dog, dog] +[rat, cat, dog, dog] +[rat, cat, dog] +[cat, dog, rat] +[rat, cat, dog] +{rat=Fuzzy, cat=Rags, dog=Spot} +{cat=Rags, dog=Spot, rat=Fuzzy} +{rat=Fuzzy, cat=Rags, dog=Spot} +*/ +``` + +这显示了Java集合库中的两个主要类型。它们的区别在于集合中的每个“槽”（slot）保存的元素个数。 **Collection** 类型在每个槽中只能保存一个元素。此类集合包括： **List**， 它以特定的顺序保存一组元素； **Set** ，其中元素不允许重复； **Queue** ，只能在集合一端插入对象，并从另一端移除对象（就本例而言，这只是查看序列的另一种方式，因此并没有显示它）。 **Map** 在每个槽中存放了两个元素，即*键*和与之关联的*值*。 + +默认的打印行为，（使用集合几桶的toString（）方法）即可生成可读性很好的结果。 **Collection** 打印出的内容用方括号括住，每个元素由逗号分隔。 **Map** 则由大括号括住，每个键和值用等号连接（键在左侧，值在右侧）。 + +第一个 **fill()** 方法适用于所有类型的 **Collection** ，这些类型都实现了 **add()** 方法以添加新元素。 + +**ArrayList** 和 **LinkedList** 都是 **List** 的类型，从输出中可以看出，它们都按插入顺序保存元素。两者之间的区别不仅在于执行某些类型的操作时的性能，而且 **LinkedList** 包含的操作多于 **ArrayList** 。本章后面将对这些内容进行更全面的探讨。 + +**HashSet** ， **TreeSet** 和 **LinkedHashSet** 是 **Set** 的类型。从输出中可以看到， **Set** 仅保存每个相同项中的一个，并且不同的 **Set** 实现存储元素的方式也不同。 **HashSet** 使用相当复杂的方法存储元素，这在[附录：集合主题]()中进行了探讨。现在只需要知道，这种技术是检索元素的最快方法，因此，存储顺序看似荒谬（通常只关心某事物是否是 **Set** 的成员，而存储顺序并不重要）。如果存储顺序很重要，则可以使用**TreeSet** ，它将按比较结果的升序保存对象）或 **LinkedHashSet** ，它按照被添加的先后顺序保存对象。 + +**Map** （也称为*关联数组*）使用*键*来查找对象，就像一个简单的数据库。所关联的对象称为*值*。 假设有一个 **Map** 将美国州名与它们的首府联系在一起，如果想要俄亥俄州（Ohio）的首府，可以用“Ohio”作为键来查找，几乎就像使用数组下标一样。 这是由于这种行为，对于每个键， **Map** 只接受一次。 + +**Map.put(key, value)** 添加一个所想要添加的值并将它与一个键（用来查找值）相关联。 **Map.get(key)** 生成与该键相关联的值。上面的示例仅添加键值对，并没有执行查找。这将在稍后展示。 + + +请注意，这里没有指定（或考虑） **Map** 的大小，因为它会自动调整大小。 此外， **Map** 还知道如何打印自己，它会显示相关联的键和值。 + +本例使用了 **Map** 的三种基本风格： **HashMap** ， **TreeMap**和 **LinkedHashMap** 。 + +键和值保存在 **HashMap** 中的顺序不是插入顺序，因为 **HashMap** 实现使用了非常快速的算法来控制顺序。 **TreeMap** 通过比较结果的升序来保存键， **LinkedHashMap** 在保持 **HashMap** 查找速度的同时按键的插入顺序保存键。 ## 列表List From aea2f51b3cc7013464c78ce4f62c3d04cae33881 Mon Sep 17 00:00:00 2001 From: xiangflight Date: Thu, 11 Jul 2019 20:50:31 +0800 Subject: [PATCH 02/25] =?UTF-8?q?[feat=2010](=E6=88=AA=E8=87=B3=20?= =?UTF-8?q?=E5=AE=8C=E5=85=A8=E8=A7=A3=E8=80=A6)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/10-Interfaces.md | 245 ++++++++++++++++++++++++++++++++++++- 1 file changed, 244 insertions(+), 1 deletion(-) diff --git a/docs/book/10-Interfaces.md b/docs/book/10-Interfaces.md index 539c056..3cb304b 100644 --- a/docs/book/10-Interfaces.md +++ b/docs/book/10-Interfaces.md @@ -760,22 +760,265 @@ Woodwind.play() MIDDLE_C ## 抽象类和接口 +尤其是在 Java 8 引入 **default** 方法之后，区分何时抽象类还是接口是最好的选择变得更加令人困惑。下表做了明确的区分： +| 特性 | 接口 | 抽象类 | +| :------------------: | :--------------------------------------------------------: | :--------------------------------------: | +| 组合 | 新类可以组合多个接口 | 只能继承单一抽象类 | +| 状态 | 不能包含属性（除了静态属性，不支持对象状态） | 可以包含属性，非抽象方法可能引用这些属性 | +| 默认方法 和 抽象方法 | 不需要在子类中实现默认方法。默认方法可以引用其他接口的方法 | 必须在子类中实现抽象方法 | +| 构造器 | 没有构造器 | 可以有构造器 | +| 可见性 | 隐式 **public** | 可以是 **protected** 或友元 | +抽象类仍然是一个类，在创建新类时只能继承它一个。而创建类的过程中可以实现多个接口。 + +有一条实际经验：尽可能地抽象。因此，更倾向使用接口而不是抽象类。只有当必要时才使用抽象类。除非必须使用，否则不要用接口和抽象类。大多数时候，普通类已经做得很好，如果不行的话，再移动到接口或抽象类中。 + ## 完全解耦 +当方法操纵的是一个类而非接口时，它就只能作用于那个类或其子类。如果想把方法应用于那个继承层级结构之外的类，就会触霉头。接口在很大程度上放宽了这个限制，因而使用接口可以编写复用性更好的代码。 + +例如有一个类 **Process** 有两个方法 `name()` 和 `process()`。`process()` 方法接受输入，修改并输出。把这个类作为基类用来创建各种不同类型的 **Processor**。下例中，**Processor** 的各个子类修改 String 对象（注意，返回类型可能是协变类型而非参数类型）： + +```java +// interfaces/Applicator.java +import java.util.*; + +class Processor { + public String name() { + return getClass().getSimpleName(); + } + + public Object process(Object input) { + return input; + } +} + +class Upcase extends Processor { + // 返回协变类型 + @Override + public String process(Object input) { + return ((String) input).toUpperCase(); + } +} + +class Downcase extends Processor { + @Override + public String process(Object input) { + return ((String) input).toLowerCase(); + } +} + +class Splitter extends Processor { + @Override + public String process(Object input) { + // split() divides a String into pieces: + return Arrays.toString(((String) input).split(" ")); + } +} + +public class Applicator { + public static void apply(Processor p, Object s) { + System.out.println("Using Processor " + p.name()); + System.out.println(p.process(s)); + } + + public static void main(String[] args) { + String s = "We are such stuff as dreams are made on"; + apply(new Upcase(), s); + apply(new Downcase(), s); + apply(new Splitter(), s); + } +} +``` + +输出： + +``` +Using Processor Upcase +WE ARE SUCH STUFF AS DREAMS ARE MADE ON +Using Processor Downcase +we are such stuff as dreams are made on +Using Processor Splitter +[We, are, such, stuff, as, dreams, are, made, on] +``` + +**Applicator** 的 `apply()` 方法可以接受任何类型的 **Processor**，并将其应用到一个 **Object** 对象上输出结果。像本例中这样，创建一个能根据传入的参数类型从而具备不同行为的方法称为*策略*设计模式。方法包含算法中不变的部分，策略包含变化的部分。策略就是传入的对象，它包含要执行的代码。在这里，**Processor** 对象是策略，`main()` 方法展示了三种不同的应用于 **String s** 上的策略。 + +`split()` 是 **String** 类中的方法，它接受 **String** 类型的对象并以传入的参数作为分割界限，返回一个数组 **String[]**。在这里用它是为了更快地创建 **String** 数组。 + +假设现在发现了一组电子滤波器，它们看起来好像能使用 **Applicator** 的 `apply()` 方法： + +```java +// interfaces/filters/Waveform.java +package interfaces.filters; + +public class Waveform { + private static long counter; + private final long id = count++; + + @Override + public String toString() { + return "Waveform " + id; + } +} + +// interfaces/filters/Filter.java +package interfaces.filters; + +public class Filter { + public String name() { + return getClass().getSimpleName(); + } + + public Waveform process(Waveform input) { + return input; + } +} + +// interfaces/filters/LowPass.java +package interfaces.filters; + +public class LowPass extends Filter { + double cutoff; + + public LowPass(double cutoff) { + this.cutoff = cutoff; + } + + @Override + public Waveform process(Waveform input) { + return input; // Dummy processing 哑处理 + } +} + +// interfaces/filters/HighPass.java +package interfaces.filters; + +public class HighPass extends Filter { + double cutoff; + + public HighPass(double cutoff) { + this.cutoff = cutoff; + } + + @Override + public Waveform process(Waveform input) { + return input; + } +} + +// interfaces/filters/BandPass.java +package interfaces.filters; + +public class BandPass extends Filter { + double lowCutoff, highCutoff; + + public BandPass(double lowCut, double highCut) { + lowCutoff = lowCut; + highCutoff = highCut; + } + + @Override + public Waveform process(Waveform input) { + return input; + } +} +``` + +**Filter** 类与 **Processor** 类具有相同的接口元素，但是因为它不是继承自 **Processor** —— 因为 **Filter** 类的创建者根本不知道你想将它当作 **Processor** 使用 —— 因此你不能将 **Applicator** 的 `apply()` 方法应用在 **Filter** 类上，即使这样做也能正常运行。主要是因为 **Applicator** 的 `apply()` 方法和 **Processor** 过于耦合，这阻止了 **Applicator** 的 `apply()` 方法被复用。另外要注意的一点是 Filter 类中 `process()` 方法的输入输出都是 **Waveform**。 + +但如果 **Processor** 是一个接口，那么限制就会变得松动到足以复用 **Applicator** 的 `apply()` 方法，用来接受那个接口参数。下面是修改后的 **Processor** 和 **Applicator** 版本： + +```java +// interfaces/interfaceprocessor/Processor.java +package interfaces.interfaceprocessor; + +public interface Processor { + default String name() { + return getClass().getSimpleName(); + } + + Object process(Object input); +} + +// interfaces/interfaceprocessor/Applicator.java +package interfaces.interfaceprocessor; + +public class Applicator { + public static void apply(Processor p, Object s) { + System.out.println("Using Processor " + p.name()); + System.out.println(p.process(s)); + } +} +``` + +复用代码的第一种方式是客户端程序员遵循接口编写类，像这样： + +```java +// interfaces/interfaceprocessor/StringProcessor.java +// {java interfaces.interfaceprocessor.StringProcessor} +package interfaces.interfaceprocessor; +import java.util.*; + +interface StringProcessor extends Processor { + @Override + String process(Object input); // [1] + String S = "If she weighs the same as a duck, " + "she's made of wood"; // [2] + + static void main(String[] args) { // [3] + Applicator.apply(new Upcase(), S); + Applicator.apply(new Downcase(), S); + Applicator.apply(new Splitter(), S); + } +} + +class Upcase implements StringProcessor { + // 返回协变类型 + @Override + public String process(Object input) { + return ((String) input).toUpperCase(); + } +} + +class Downcase implements StringProcessor { + @Override + public String process(Object input) { + return ((String) input).toLowerCase(); + } +} + +class Splitter implements StringProcessor { + @Override + public String process(Object input) { + return Arrays.toString(((String) input).split(" ")); + } +} +``` + +输出： + +``` +Using Processor Upcase +IF SHE WEIGHS THE SAME AS A DUCK, SHE'S MADE OF WOOD +Using Processor Downcase +if she weighs the same as a duck, she's made of wood +Using Processor Splitter +[If, she, weighs, the, same, as, a, duck,, she's, made, of, wood] +``` + ## 多接口结合 ## 使用继承扩展接口 - + ## 接口适配 From c34e0811df81a26671a2688ca209b1c42edfd712 Mon Sep 17 00:00:00 2001 From: 1326670425 <1326670425@qq.com> Date: Fri, 12 Jul 2019 11:41:11 +0800 Subject: [PATCH 03/25] =?UTF-8?q?=E7=AC=AC=E5=8D=81=E4=BA=8C=E7=AB=A0=20?= =?UTF-8?q?=E9=9B=86=E5=90=88=20=E7=BF=BB=E8=AF=91=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E8=87=B3=20=E5=A0=86=E6=A0=88Stack?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/12-Collections.md | 480 ++++++++++++++++++++++++++++++++++++ 1 file changed, 480 insertions(+) diff --git a/docs/book/12-Collections.md b/docs/book/12-Collections.md index 684b280..9bdeaeb 100644 --- a/docs/book/12-Collections.md +++ b/docs/book/12-Collections.md @@ -331,18 +331,498 @@ public class PrintingCollections { ## 列表List +**List**s承诺以特定顺序保存元素。 **List** 接口在 **Collection** 的基础上添加了许多方法，允许在 **List** 的中间插入和删除元素。 + +有两种类型的 **List** ： + +- 基本的 **ArrayList** ，擅长随机访问元素，但在 **List** 中间插入和删除元素时速度较慢。 +- **LinkedList** ，它通过代价较低的在 **List** 中间进行的插入和删除操作，提供了优化的顺序访问。 **LinkedList** 对于随机访问来说相对较慢，但它具有比 **ArrayList** 更大的特征集。 + +下面的示例导入 **typeinfo.pets** ，超前使用了[类型信息]()一章中的类库。这个类库包含了 **Pet** 类层次结构，以及用于随机生成 **Pet** 对象的一些工具类。此时不需要了解完整的详细信息，只需要知道两点： + +1. 有一个 **Pet** 类，以及 **Pet** 的各种子类型。 +2. 静态的 **Pets.arrayList()** 方法返回一个填充了随机选取的 **Pet** 对象的 **ArrayList**： + +```java +// collections/ListFeatures.java +import typeinfo.pets.*; +import java.util.*; + +public class ListFeatures { + public static void main(String[] args) { + Random rand = new Random(47); + List pets = Pets.list(7); + System.out.println("1: " + pets); + Hamster h = new Hamster(); + pets.add(h); // Automatically resizes + System.out.println("2: " + pets); + System.out.println("3: " + pets.contains(h)); + pets.remove(h); // Remove by object + Pet p = pets.get(2); + System.out.println( + "4: " + p + " " + pets.indexOf(p)); + Pet cymric = new Cymric(); + System.out.println("5: " + pets.indexOf(cymric)); + System.out.println("6: " + pets.remove(cymric)); + // Must be the exact object: + System.out.println("7: " + pets.remove(p)); + System.out.println("8: " + pets); + pets.add(3, new Mouse()); // Insert at an index + System.out.println("9: " + pets); + List sub = pets.subList(1, 4); + System.out.println("subList: " + sub); + System.out.println("10: " + pets.containsAll(sub)); + Collections.sort(sub); // In-place sort + System.out.println("sorted subList: " + sub); + // Order is not important in containsAll(): + System.out.println("11: " + pets.containsAll(sub)); + Collections.shuffle(sub, rand); // Mix it up + System.out.println("shuffled subList: " + sub); + System.out.println("12: " + pets.containsAll(sub)); + List copy = new ArrayList<>(pets); + sub = Arrays.asList(pets.get(1), pets.get(4)); + System.out.println("sub: " + sub); + copy.retainAll(sub); + System.out.println("13: " + copy); + copy = new ArrayList<>(pets); // Get a fresh copy + copy.remove(2); // Remove by index + System.out.println("14: " + copy); + copy.removeAll(sub); // Only removes exact objects + System.out.println("15: " + copy); + copy.set(1, new Mouse()); // Replace an element + System.out.println("16: " + copy); + copy.addAll(2, sub); // Insert a list in the middle + System.out.println("17: " + copy); + System.out.println("18: " + pets.isEmpty()); + pets.clear(); // Remove all elements + System.out.println("19: " + pets); + System.out.println("20: " + pets.isEmpty()); + pets.addAll(Pets.list(4)); + System.out.println("21: " + pets); + Object[] o = pets.toArray(); + System.out.println("22: " + o[3]); + Pet[] pa = pets.toArray(new Pet[0]); + System.out.println("23: " + pa[3].id()); + } +} +/* Output: +1: [Rat, Manx, Cymric, Mutt, Pug, Cymric, Pug] +2: [Rat, Manx, Cymric, Mutt, Pug, Cymric, Pug, Hamster] +3: true +4: Cymric 2 +5: -1 +6: false +7: true +8: [Rat, Manx, Mutt, Pug, Cymric, Pug] +9: [Rat, Manx, Mutt, Mouse, Pug, Cymric, Pug] +subList: [Manx, Mutt, Mouse] +10: true +sorted subList: [Manx, Mouse, Mutt] +11: true +shuffled subList: [Mouse, Manx, Mutt] +12: true +sub: [Mouse, Pug] +13: [Mouse, Pug] +14: [Rat, Mouse, Mutt, Pug, Cymric, Pug] +15: [Rat, Mutt, Cymric, Pug] +16: [Rat, Mouse, Cymric, Pug] +17: [Rat, Mouse, Mouse, Pug, Cymric, Pug] +18: false +19: [] +20: true +21: [Manx, Cymric, Rat, EgyptianMau] +22: EgyptianMau +23: 14 +*/ +``` + +打印行都编了号，因此输出可以与源代码相关。 第1行输出展示了原始的由 **Pet** 组成的 **List** 。 与数组不同， **List** 可以在创建后添加或删除元素，并自行调整大小。这正是它的重要价值：一种可修改的序列。在第2行输出中可以看到添加一个 **Hamster** 的结果，该对象将被追加到列表的末尾。 + +可以使用 **contains()** 方法确定对象是否在列表中。如果要删除一个对象，可以将该对象的引用传递给 **remove()** 方法。同样，如果有一个对象的引用，可以使用 **indexOf()** 在 **List** 中找到该对象所在位置的下标号，如第4行输出所示中所示。 + +当确定元素是否是属于某个 **List** ，寻找某个元素的索引，以及通过引用从 **List** 中删除元素时，都会用到 **equals()** 方法（根类 **Object** 的一个方法）。每个 **Pet** 被定义为一个唯一的对象，所以即使列表中已经有两个 **Cymrics** ，如果再创建一个新的 **Cymric** 对象并将其传递给 **indexOf()** 方法，结果仍为 **-1** （表示未找到），并且尝试调用 **remove()** 方法来删除这个对象将返回 **false** 。对于其他类， **equals()** 的定义可能有所不同。例如，如果两个 **String** 的内容相同，则这两个 **String** 相等。因此，为了防止出现意外，请务必注意 **List** 行为会根据 **equals()** 行为而发生变化。 + +第7、8行输出展示了删除与 **List** 中的对象完全匹配的对象是成功的。 + +可以在 **List** 的中间插入一个元素，就像在第9行输出和它之前的代码那样。但这会带来一个问题：对于 **LinkedList** ，在列表中间插入和删除都是廉价操作（在本例中，除了对列表中间进行的真正的随机访问），但对于 **ArrayList** ，这可是代价高昂的操作。这是否意味着永远不应该在 **ArrayList** 的中间插入元素，并最好是转换为 **LinkedList** ？不，它只是意味着你应该意识到这个问题，如果你开始在某个 **ArrayList** 中间进执行很多插入操作，并且程序开始变慢，那么你应该看看你的 **List** 实现有可能就是罪魁祸首（发现此类瓶颈的最佳方式是使用仿真器）。优化是一个很棘手的问题，最好的策略就是置之不顾，直到发现必须要去担心它了（尽管去理解这些问题总是一个很好的主意）。 + +**subList()** 方法可以轻松地从更大的列表中创建切片，当将切片结果传递给原来这个较大的列表的 **containsAll()** 方法时，很自然地会得到 **true**。请注意，顺序并不重要，在第11、12行输出中可以看到，在 **sub** 上调用直观命名的 **Collections.sort()** 和 **Collections.shuffle()** 方法，不会影响 **containsAll()** 的结果。 **subList()** 所产生的列表的幕后支持就是原始列表。因此，对所返回列表的更改都将会反映在原始列表中，反之亦然。 + +**retainAll()** 方法实际上是一个“集合交集”操作，在本例中，它保留了同时在 **copy** 和 **sub** 中的所有元素。请再次注意，所产生的结果行为依赖于 **equals()** 方法。 + +第14行输出展示了使用索引号来删除元素的结果，与通过对象引用来删除元素相比，它显得更加直观，因为在使用索引时，不必担心 **equals()** 的行为。 + +**removeAll()** 方法也是基于 **equals()** 方法运行的。 顾名思义，它会从 **List** 中删除在参数 **List** 中的所有元素。 + +**set()** 方法的命名显得很不合时宜，因为它与 **Set** 类存在潜在的冲突。在这里使用“replace”可能更适合，因为它的功能是用第二个参数替换索引处的元素（第一个参数）。 + +第17行输出表明，对于 **List** ，有一个重载的 **addAll()** 方法可以将新列表插入到原始列表的中间，而不仅仅只能用 **Collection** 的 **addAll()** 方法将追加到列表末尾。 + +第18-20行输出展示了 **isEmpty()** 和 **clear()** 方法的效果。 + +第22、23行输出展示了如何使用 **toArray()** 方法将任意的 **Collection** 转换为数组。这是一个重载方法，其无参版本返回一个 **Object** 数组，但是如果将目标类型的数组传递给这个重载版本，那么它会生成一个指定类型的数组（假设它通过了类型检查）。如果参数数组太小而无法容纳 **List** 中的所有元素（就像本例一样），则 **toArray()** 会创建一个具有合适尺寸的新数组。 **Pet** 对象有一个 **id()** 方法，可以在所产生的数组中的对象上调用这个方法。 ## 迭代器Iterators +在任何集合中，都必须有某种方式可以插入元素并再次获取它们。毕竟，保存事物是集合最基本的工作。对于 **List** ， **add()** 是插入元素的一种方式， **get()** 是获取元素的一种方式。 + +如果从更高层次的角度考虑，会发现这里有个缺点：要使用集合，必须对集合的确切类型编程。这一开始可能看起来不是很糟糕，但是考虑下面的情况：如果原本是对 **List** 编码的，但是后来发现如果能够将相同的代码应用于 **Set** 会更方便，此时应该怎么做？或者假设想从一开始就编写一段通用代码，它不知道或不关心它正在使用什么类型的集合，因此它可以用于不同类型的集合，那么如何才能不重写代码就可以应用于不同类型的集合？ + +*迭代器*（也是一种设计模式）的概念实现了这种抽象。迭代器是一个对象，它在一个序列中移动并选择该序列中的每个对象，而客户端程序员不知道或不关心该序列的底层结构。另外，迭代器通常被称为*轻量级对象*（lightweight object）：创建它的代价小。因此，经常可以看到一些对迭代器有些奇怪的约束。例如，Java的 **Iterator** 只能单向移动。这个 **Iterator** 只能用来： +1. 使用 **iterator()** 方法要求集合返回一个 **Iterator**。 **Iterator** 将准备好返回序列中的第一个元素。 +2. 使用 **next()** 方法获得序列中的下一个元素。 +3. 使用 **hasNext()** 方法检查序列中是否还有元素。 +4. 使用 **remove()** 方法将迭代器最近返回的那个元素删除。 + +为了观察它的工作方式，这里再次使用[类型信息]()章节中的 **Pet** 工具： + +```java +// collections/SimpleIteration.java +import typeinfo.pets.*; +import java.util.*; + +public class SimpleIteration { + public static void main(String[] args) { + List pets = Pets.list(12); + Iterator it = pets.iterator(); + while(it.hasNext()) { + Pet p = it.next(); + System.out.print(p.id() + ":" + p + " "); + } + System.out.println(); + // A simpler approach, when possible: + for(Pet p : pets) + System.out.print(p.id() + ":" + p + " "); + System.out.println(); + // An Iterator can also remove elements: + it = pets.iterator(); + for(int i = 0; i < 6; i++) { + it.next(); + it.remove(); + } + System.out.println(pets); + } +} +/* Output: +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx 8:Cymric 9:Rat 10:EgyptianMau 11:Hamster +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx 8:Cymric 9:Rat 10:EgyptianMau 11:Hamster +[Pug, Manx, Cymric, Rat, EgyptianMau, Hamster] +*/ +``` + +有了 **Iterator** ，就不必再为集合中元素的数量操心了。这是由 **hasNext()** 和 **next()** 关心的事情。 + +如果只是想向前遍历 **List** ，并不打算修改 **List** 对象本身，那么使用 *for-in* 语法更加简洁。 + +**Iterator** 还可以删除由 **next()** 生成的最后一个元素，这意味着在调用 **remove()** 之前必须先调用 **next()** 。 + +在集合中的每个对象上执行操作，这种思想十分强大，并且贯穿于本书。 + +现在考虑创建一个 **display()** 方法，它不必知晓集合的确切类型： + +```java +// collections/CrossCollectionIteration.java +import typeinfo.pets.*; +import java.util.*; + +public class CrossCollectionIteration { + public static void display(Iterator it) { + while(it.hasNext()) { + Pet p = it.next(); + System.out.print(p.id() + ":" + p + " "); + } + System.out.println(); + } + public static void main(String[] args) { + List pets = Pets.list(8); + LinkedList petsLL = new LinkedList<>(pets); + HashSet petsHS = new HashSet<>(pets); + TreeSet petsTS = new TreeSet<>(pets); + display(pets.iterator()); + display(petsLL.iterator()); + display(petsHS.iterator()); + display(petsTS.iterator()); + } +} +/* Output: +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +5:Cymric 2:Cymric 7:Manx 1:Manx 3:Mutt 6:Pug 4:Pug +0:Rat +*/ +``` + +**display()** 方法不包含任何有关它所遍历的序列的类型信息。这也展示了 **Iterator** 的真正威力：能够将遍历序列的操作与该序列的底层结构分离。出于这个原因，我们有时会说：迭代器统一了对集合的访问方式。 + +我们可以使用 **Iterable** 接口生成上一个示例的更简洁版本，该接口描述了“可以产生 **Iterator** 的任何东西”： + +```java +// collections/CrossCollectionIteration2.java +import typeinfo.pets.*; +import java.util.*; + +public class CrossCollectionIteration2 { + public static void display(Iterable ip) { + Iterator it = ip.iterator(); + while(it.hasNext()) { + Pet p = it.next(); + System.out.print(p.id() + ":" + p + " "); + } + System.out.println(); + } + public static void main(String[] args) { + List pets = Pets.list(8); + LinkedList petsLL = new LinkedList<>(pets); + HashSet petsHS = new HashSet<>(pets); + TreeSet petsTS = new TreeSet<>(pets); + display(pets); + display(petsLL); + display(petsHS); + display(petsTS); + } +} +/* Output: +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +5:Cymric 2:Cymric 7:Manx 1:Manx 3:Mutt 6:Pug 4:Pug +0:Rat +*/ +``` + +这里所有的类都是 **Iterable** ，所以现在对 **display()** 的调用显然更简单。 + + +### ListIterator + +**ListIterator** 是一个更强大的 **Iterator**子类型，它只能由各种 **List** 类生成。虽然 **Iterator** 只能向前移动，但 **ListIterator** 可以双向移动。它还可以生成相对于迭代器在列表中指向的当前位置的后一个和前一个元素的索引，并且可以使用 **set()** 方法替换它访问过的最后一个元素。可以通过调用 **listIterator()** 方法来生成指向 **List** 开头处的 **ListIterator** ，还可以通过调用** listIterator(n)** 创建一个一开始就指向列表索引号为 **n** 的元素处的 **ListIterator** 。 下面的示例演示了所有这些能力： + +```java +// collections/ListIteration.java +import typeinfo.pets.*; +import java.util.*; + +public class ListIteration { + public static void main(String[] args) { + List pets = Pets.list(8); + ListIterator it = pets.listIterator(); + while(it.hasNext()) + System.out.print(it.next() + + ", " + it.nextIndex() + + ", " + it.previousIndex() + "; "); + System.out.println(); + // Backwards: + while(it.hasPrevious()) + System.out.print(it.previous().id() + " "); + System.out.println(); + System.out.println(pets); + it = pets.listIterator(3); + while(it.hasNext()) { + it.next(); + it.set(Pets.get()); + } + System.out.println(pets); + } +} +/* Output: +Rat, 1, 0; Manx, 2, 1; Cymric, 3, 2; Mutt, 4, 3; Pug, +5, 4; Cymric, 6, 5; Pug, 7, 6; Manx, 8, 7; +7 6 5 4 3 2 1 0 +[Rat, Manx, Cymric, Mutt, Pug, Cymric, Pug, Manx] +[Rat, Manx, Cymric, Cymric, Rat, EgyptianMau, Hamster, +EgyptianMau] +*/ +``` + +**Pets.get()** 方法用来从位置3开始替换 **List** 中的所有Pet对象。 ## 链表LinkedList +**LinkedList** 也像 **ArrayList** 一样实现了基本的 **List** 接口，但它在 **List** 中间执行插入和删除操作时，比 **ArrayList** 更高效。但在随机访问操作效率方面却要逊色一些。 +**LinkedList还添加了一些方法，使其可以被用作栈、队列或双端队列（deque）** 。在这些方法中，有些彼此之间可能只是名称有些差异，或者只存在些许差异，以使得这些名字在特定用法的上下文环境中更加适用（特别是在 **Queue** 中）。例如： + +- **getFirst()** 和 **element()** 是相同的，它们都返回列表的头部（第一个元素）而并不删除它，如果 **List** 为空，则抛出 **NoSuchElementException** 异常。 **peek()** 方法与这两个方法只是稍有差异，它在列表为空时返回 **null** 。 +- **removeFirst()** 和 **remove()** 也是相同的，它们删除并返回列表的头部元素，并在列表为空时抛出 **NoSuchElementException** 异常。 **poll()** 稍有差异，它在列表为空时返回 **null** 。 +- **addFirst()** 在列表的开头插入一个元素。 +- **offer()** 与 **add()** 和 **addLast()** 相同。 它们都在列表的尾部（末尾）添加一个元素。 +- **removeLast()** 删除并返回列表的最后一个元素。 + +下面的示例展示了这些功能之间基本的相似性和差异性。它并不是重复执行 **ListFeatures.java** 中所示的行为： + +```java +// collections/LinkedListFeatures.java +import typeinfo.pets.*; +import java.util.*; + +public class LinkedListFeatures { + public static void main(String[] args) { + LinkedList pets = + new LinkedList<>(Pets.list(5)); + System.out.println(pets); + // Identical: + System.out.println( + "pets.getFirst(): " + pets.getFirst()); + System.out.println( + "pets.element(): " + pets.element()); + // Only differs in empty-list behavior: + System.out.println("pets.peek(): " + pets.peek()); + // Identical; remove and return the first element: + System.out.println( + "pets.remove(): " + pets.remove()); + System.out.println( + "pets.removeFirst(): " + pets.removeFirst()); + // Only differs in empty-list behavior: + System.out.println("pets.poll(): " + pets.poll()); + System.out.println(pets); + pets.addFirst(new Rat()); + System.out.println("After addFirst(): " + pets); + pets.offer(Pets.get()); + System.out.println("After offer(): " + pets); + pets.add(Pets.get()); + System.out.println("After add(): " + pets); + pets.addLast(new Hamster()); + System.out.println("After addLast(): " + pets); + System.out.println( + "pets.removeLast(): " + pets.removeLast()); + } +} +/* Output: +[Rat, Manx, Cymric, Mutt, Pug] +pets.getFirst(): Rat +pets.element(): Rat +pets.peek(): Rat +pets.remove(): Rat +pets.removeFirst(): Manx +pets.poll(): Cymric +[Mutt, Pug] +After addFirst(): [Rat, Mutt, Pug] +After offer(): [Rat, Mutt, Pug, Cymric] +After add(): [Rat, Mutt, Pug, Cymric, Pug] +After addLast(): [Rat, Mutt, Pug, Cymric, Pug, Hamster] +pets.removeLast(): Hamster +*/ +``` + +**Pets.list()** 的结果被传递给 **LinkedList** 的构造器，以便使用它来填充 **LinkedList** 。如果查看 **Queue** 接口就会发现，它在 **LinkedList** 的基础上添加了 **element()** ， **offer()** ， **peek()** ， **poll()** 和 **remove()** 方法，以使其可以成为一个 **Queue** 的实现。 **Queue** 的完整示例将在本章稍后给出。 + ## 堆栈Stack +堆栈是“后进先出”（LIFO）集合。它有时被称为*叠加栈*（pushdown stack），因为最后“压入”（push）栈的元素，第一个被“弹出”（pop）栈。经常用来类比栈的事物是带有弹簧支架的自助餐厅托盘。最后装入的托盘总是最先拿出来使用的。 + +Java 1.0中附带了一个 **Stack** 类，结果设计得很糟糕（为了向后兼容，我们永远坚持Java中的旧设计错误）。Java 6添加了 **ArrayDeque** ，其中包含直接实现堆栈功能的方法： + +```java +// collections/StackTest.java +import java.util.*; + +public class StackTest { + public static void main(String[] args) { + Deque stack = new ArrayDeque<>(); + for(String s : "My dog has fleas".split(" ")) + stack.push(s); + while(!stack.isEmpty()) + System.out.print(stack.pop() + " "); + } +} +/* Output: +fleas has dog My +*/ +``` + +即使它是作为一个堆栈在使用，我们仍然必须将其声明为 **Deque** 。有时一个名为 **Stack** 的类更能把事情讲清楚： + +```java +// onjava/Stack.java +// A Stack class built with an ArrayDeque +package onjava; +import java.util.Deque; +import java.util.ArrayDeque; + +public class Stack { + private Deque storage = new ArrayDeque<>(); + public void push(T v) { storage.push(v); } + public T peek() { return storage.peek(); } + public T pop() { return storage.pop(); } + public boolean isEmpty() { return storage.isEmpty(); } + @Override + public String toString() { + return storage.toString(); + } +} +``` + +这里引入了使用泛型的类定义的最简单的可能示例。类名称后面的 **** 告诉编译器这是一个参数化类型，而其中的类型参数，即在类被使用时将会被实际类型替换的参数，就是 **T** 。基本上，这个类是在声明“我们在定义一个可以持有 **T** 类型对象的 **Stack** 。” **Stack** 是使用 **ArrayDeque** 实现的，而 **ArrayDeque** 也被告知它将持有 **T** 类型对象。注意， **push()** 接受类型为 **T** 的对象，而 **peek()** 和 **pop()** 返回类型为 **T** 的对象。 **peek()** 方法将返回栈顶元素，但并不将其从栈顶删除，而 **pop()** 删除并返回顶部元素。 + +如果只需要栈的行为，那么使用继承是不合适的，因为这将产生一个具有 **ArrayDeque** 的其它所有方法的类（在[附录：集合主题]()中将会看到， **Java 1.0** 设计者在创建 **java.util.Stack** 时，就犯了这个错误）。使用组合，可以选择要公开的方法以及如何命名它们。 + +下面将使用 **StackTest.java** 中的相同代码来演示这个新的 **Stack** 类： + +```java +// collections/StackTest2.java +import onjava.*; + +public class StackTest2 { + public static void main(String[] args) { + Stack stack = new Stack<>(); + for(String s : "My dog has fleas".split(" ")) + stack.push(s); + while(!stack.isEmpty()) + System.out.print(stack.pop() + " "); + } +} +/* Output: +fleas has dog My +*/ +``` + +如果想在自己的代码中使用这个 **Stack** 类，当在创建其实例时，就需要完整指定包名，或者更改这个类的名称；否则，就有可能会与 **java.util** 包中的 **Stack** 发生冲突。例如，如果我们在上面的例子中导入 **java.util.***，那么就必须使用包名来防止冲突： + +```java +// collections/StackCollision.java + +public class StackCollision { + public static void main(String[] args) { + onjava.Stack stack = new onjava.Stack<>(); + for(String s : "My dog has fleas".split(" ")) + stack.push(s); + while(!stack.isEmpty()) + System.out.print(stack.pop() + " "); + System.out.println(); + java.util.Stack stack2 = + new java.util.Stack<>(); + for(String s : "My dog has fleas".split(" ")) + stack2.push(s); + while(!stack2.empty()) + System.out.print(stack2.pop() + " "); + } +} +/* Output: +fleas has dog My +fleas has dog My +*/ +``` + +尽管已经有了 **java.util.Stack** ，但是 **ArrayDeque** 可以产生更好的 **Stack** ，因此更可取。 + +还可以使用显式导入来控制对“首选” **Stack** 实现的选择： +```java +import onjava.Stack; +``` + +现在,任何对 **Stack** 的引用都将选择 **onjava** 版本，而在选择 **java.util.Stack** 时，必须使用全限定名称（full qualification）。 ## 集合Set From bbebb8d57c777f2ae76ff33f6843218c98709f85 Mon Sep 17 00:00:00 2001 From: 1326670425 <1326670425@qq.com> Date: Sat, 13 Jul 2019 12:21:43 +0800 Subject: [PATCH 04/25] =?UTF-8?q?=E7=AC=AC=E5=8D=81=E4=BA=8C=E7=AB=A0=20?= =?UTF-8?q?=E9=9B=86=E5=90=88=20=E7=BF=BB=E8=AF=91=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E8=87=B3=20=E9=98=9F=E5=88=97Queue?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/12-Collections.md | 427 ++++++++++++++++++++++++++++++++++++ 1 file changed, 427 insertions(+) diff --git a/docs/book/12-Collections.md b/docs/book/12-Collections.md index 9bdeaeb..c861b3a 100644 --- a/docs/book/12-Collections.md +++ b/docs/book/12-Collections.md @@ -827,14 +827,441 @@ import onjava.Stack; ## 集合Set +**Set** 不保存重复的元素。 如果试图将相同对象的多个实例添加到 **Set** 中，那么它会阻止这种行为。 **Set** 最常见的用途是测试归属性，可以很轻松地询问某个对象是否在一个 **Set** 中。因此，查找通常是 **Set** 最重要的操作，因此通常会选择 **HashSet** 实现，该实现针对快速查找进行了优化。 + +**Set** 具有与 **Collection** 相同的接口，因此没有任何额外的功能，不像前面两种不同类型的 **List** 那样。实际上， **Set** 就是一个 **Collection** ，只是行为不同。（这是继承和多态思想的典型应用：表现不同的行为。）**Set** 根据对象的“值”确定归属性，更复杂的问题将在[附录：集合主题]()中介绍。 + +下面是使用存放 **Integer** 对象的 **HashSet** 的示例： + +```java +// collections/SetOfInteger.java +import java.util.*; + +public class SetOfInteger { + public static void main(String[] args) { + Random rand = new Random(47); + Set intset = new HashSet<>(); + for(int i = 0; i < 10000; i++) + intset.add(rand.nextInt(30)); + System.out.println(intset); + } +} +/* Output: +[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, +16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29] +*/ +``` + +在0到29之间的10000个随机整数被添加到 **Set** 中，因此可以想象每个值都重复了很多次。但是从结果中可以看到，每一个数只有一个实例出现在结果中。 + +早期Java版本中的 **HashSet** 产生的输出没有可辨别的顺序。这是因为出于对速度的追求， **HashSet** 使用了散列，请参阅[附录：集合主题]()一章。由 **HashSet** 维护的顺序与 **TreeSet** 或 **LinkedHashSet** 不同，因为它们的实现具有不同的元素存储方式。 **TreeSet** 将元素存储在红-黑树数据结构中，而 **HashSet** 使用散列函数。 **LinkedHashSet** 因为查询速度的原因也使用了散列，但是看起来使用了链表来维护元素的插入顺序。显然，哈希算法已经更改，现在 **Integer** 按顺序排序。 但是，您不应该依赖此行为： + +```java +// collections/SetOfString.java +import java.util.*; + +public class SetOfString { + public static void main(String[] args) { + Set colors = new HashSet<>(); + for(int i = 0; i < 100; i++) { + colors.add("Yellow"); + colors.add("Blue"); + colors.add("Red"); + colors.add("Red"); + colors.add("Orange"); + colors.add("Yellow"); + colors.add("Blue"); + colors.add("Purple"); + } + System.out.println(colors); + } +} +/* Output: +[Red, Yellow, Blue, Purple, Orange] +*/ +``` + +**String** 对象似乎没有排序。要对结果进行排序，一种方法是使用 **TreeSet** 而不是 **HashSet** ： + +```java +// collections/SortedSetOfString.java +import java.util.*; + +public class SortedSetOfString { + public static void main(String[] args) { + Set colors = new TreeSet<>(); + for(int i = 0; i < 100; i++) { + colors.add("Yellow"); + colors.add("Blue"); + colors.add("Red"); + colors.add("Red"); + colors.add("Orange"); + colors.add("Yellow"); + colors.add("Blue"); + colors.add("Purple"); + } + System.out.println(colors); + } +} +/* Output: +[Blue, Orange, Purple, Red, Yellow] +*/ +``` + +最常见的操作之一是使用 **contains()** 测试成员归属性，但也有一些其它操作，可能会让你想起在小学学过的文氏图（译者注：用圆表示集与集之间关系的图）： + +```java +// collections/SetOperations.java +import java.util.*; + +public class SetOperations { + public static void main(String[] args) { + Set set1 = new HashSet<>(); + Collections.addAll(set1, + "A B C D E F G H I J K L".split(" ")); + set1.add("M"); + System.out.println("H: " + set1.contains("H")); + System.out.println("N: " + set1.contains("N")); + Set set2 = new HashSet<>(); + Collections.addAll(set2, "H I J K L".split(" ")); + System.out.println( + "set2 in set1: " + set1.containsAll(set2)); + set1.remove("H"); + System.out.println("set1: " + set1); + System.out.println( + "set2 in set1: " + set1.containsAll(set2)); + set1.removeAll(set2); + System.out.println( + "set2 removed from set1: " + set1); + Collections.addAll(set1, "X Y Z".split(" ")); + System.out.println( + "'X Y Z' added to set1: " + set1); + } +} +/* Output: +H: true +N: false +set2 in set1: true +set1: [A, B, C, D, E, F, G, I, J, K, L, M] +set2 in set1: false +set2 removed from set1: [A, B, C, D, E, F, G, M] +'X Y Z' added to set1: [A, B, C, D, E, F, G, M, X, Y, +Z] +*/ +``` + +这些方法名都是自解释的，JDK文档中还有一些其它的方法。 + +能够产生每个元素都唯一的列表是相当有用的功能。例如，假设想要列出上面的 **SetOperations.java** 文件中的所有单词，通过使用本书后面介绍的 **java.nio.file.Files.readAllLines()** 方法，可以打开一个文件，并将其作为一个 **List\** 读取，每个 **String** 都是输入文件中的一行： + +```java +// collections/UniqueWords.java +import java.util.*; +import java.nio.file.*; + +public class UniqueWords { + public static void + main(String[] args) throws Exception { + List lines = Files.readAllLines( + Paths.get("SetOperations.java")); + Set words = new TreeSet<>(); + for(String line : lines) + for(String word : line.split("\\W+")) + if(word.trim().length() > 0) + words.add(word); + System.out.println(words); + } +} +/* Output: +[A, B, C, Collections, D, E, F, G, H, HashSet, I, J, K, +L, M, N, Output, Set, SetOperations, String, System, X, +Y, Z, add, addAll, added, args, class, collections, +contains, containsAll, false, from, import, in, java, +main, new, out, println, public, remove, removeAll, +removed, set1, set2, split, static, to, true, util, +void] +*/ +``` + +我们逐步浏览文件中的每一行，并使用 **String.split()** 将其分解为单词，这里使用正则表达式 **\\\ W +** ，这意味着它会依据一个或多个（即 **+** ）非单词字母来拆分字符串（正则表达式将在[字符串]()章节介绍）。每个结果单词都会添加到 **Set words** 中。因为它是 **TreeSet** ，所以对结果进行排序。这里，排序是按*字典顺序*（lexicographically）完成的，因此大写和小写字母位于不同的组中。如果想按*字母顺序*（alphabetically）对其进行排序，可以向 **TreeSet** 构造器传入 **String.CASE_INSENSITIVE_ORDER** 比较器（比较器是一个建立排序顺序的对象）： + +```java +// collections/UniqueWordsAlphabetic.java +// Producing an alphabetic listing +import java.util.*; +import java.nio.file.*; + +public class UniqueWordsAlphabetic { + public static void + main(String[] args) throws Exception { + List lines = Files.readAllLines( + Paths.get("SetOperations.java")); + Set words = + new TreeSet<>(String.CASE_INSENSITIVE_ORDER); + for(String line : lines) + for(String word : line.split("\\W+")) + if(word.trim().length() > 0) + words.add(word); + System.out.println(words); + } +} +/* Output: +[A, add, addAll, added, args, B, C, class, collections, +contains, containsAll, D, E, F, false, from, G, H, +HashSet, I, import, in, J, java, K, L, M, main, N, new, +out, Output, println, public, remove, removeAll, +removed, Set, set1, set2, SetOperations, split, static, +String, System, to, true, util, void, X, Y, Z] +*/ +``` + +**Comparator** 比较器将在[数组]()章节详细介绍。 ## 映射Map +将对象映射到其他对象的能力是解决编程问题的有效方法。例如，考虑一个程序，它被用来检查Java的 **Random** 类的随机性。理想情况下， **Random** 会产生完美的数字分布，但为了测试这一点，则需要生成大量的随机数，并计算落在各种范围内的数字个数。 **Map** 可以很容易地解决这个问题。在本例中，键是 **Random** 生成的数字，而值是该数字出现的次数： + +```java +// collections/Statistics.java +// (c)2017 MindView LLC: see Copyright.txt +// We make no guarantees that this code is fit for any purpose. +// Visit http://OnJava8.com for more book information. +// Simple demonstration of HashMap +import java.util.*; + +public class Statistics { + public static void main(String[] args) { + Random rand = new Random(47); + Map m = new HashMap<>(); + for(int i = 0; i < 10000; i++) { + // Produce a number between 0 and 20: + int r = rand.nextInt(20); + Integer freq = m.get(r); // [1] + m.put(r, freq == null ? 1 : freq + 1); + } + System.out.println(m); + } +} +/* Output: +{0=481, 1=502, 2=489, 3=508, 4=481, 5=503, 6=519, +7=471, 8=468, 9=549, 10=513, 11=531, 12=521, 13=506, +14=477, 15=497, 16=533, 17=509, 18=478, 19=464} +*/ +``` + +- **[1]** 自动包装机制将随机生成的 **int** 转换为可以与 **HashMap** 一起使用的 **Integer** 引用（不能使用基本类型的集合）。如果键不在集合中，则 **get()** 返回 **null** （这意味着这是第一次找到该数字）。否则， **get()** 会为键生成与之关联的 **Integer** 值，然后该值被递增（自动包装机制再次简化了表达式，但实际上确实发生了对 **Integer** 的装箱和拆箱）。 + +接下来的示例将使用一个 **String** 描述来查找 **Pet** 对象。它还展示了通过使用 **containsKey()**和 **containsValue()** 方法去测试一个 **Map** ，以查看它是否包含某个键或某个值： + +```java +// collections/PetMap.java +import typeinfo.pets.*; +import java.util.*; + +public class PetMap { + public static void main(String[] args) { + Map petMap = new HashMap<>(); + petMap.put("My Cat", new Cat("Molly")); + petMap.put("My Dog", new Dog("Ginger")); + petMap.put("My Hamster", new Hamster("Bosco")); + System.out.println(petMap); + Pet dog = petMap.get("My Dog"); + System.out.println(dog); + System.out.println(petMap.containsKey("My Dog")); + System.out.println(petMap.containsValue(dog)); + } +} +/* Output: +{My Dog=Dog Ginger, My Cat=Cat Molly, My +Hamster=Hamster Bosco} +Dog Ginger +true +true +*/ +``` + +**Map** 与数组和其他的 **Collection** 一样，可以轻松地扩展到多个维度，只需要创建一个值为 **Map** 的 **Map**（这些 **Map** 的值可以是其他集合，甚至是其他 **Map**）。因此，能够很容易地将集合组合起来以快速生成强大的数据结构。例如，假设你正在追踪有多个宠物的人，只需要一个 **Map\\>** 即可： + +```java + +// collections/MapOfList.java +// {java collections.MapOfList} +package collections; +import typeinfo.pets.*; +import java.util.*; + +public class MapOfList { + public static final Map> + petPeople = new HashMap<>(); + static { + petPeople.put(new Person("Dawn"), + Arrays.asList( + new Cymric("Molly"), + new Mutt("Spot"))); + petPeople.put(new Person("Kate"), + Arrays.asList(new Cat("Shackleton"), + new Cat("Elsie May"), new Dog("Margrett"))); + petPeople.put(new Person("Marilyn"), + Arrays.asList( + new Pug("Louie aka Louis Snorkelstein Dupree"), + new Cat("Stanford"), + new Cat("Pinkola"))); + petPeople.put(new Person("Luke"), + Arrays.asList( + new Rat("Fuzzy"), new Rat("Fizzy"))); + petPeople.put(new Person("Isaac"), + Arrays.asList(new Rat("Freckly"))); + } + public static void main(String[] args) { + System.out.println("People: " + petPeople.keySet()); + System.out.println("Pets: " + petPeople.values()); + for(Person person : petPeople.keySet()) { + System.out.println(person + " has:"); + for(Pet pet : petPeople.get(person)) + System.out.println(" " + pet); + } + } +} +/* Output: +People: [Person Dawn, Person Kate, Person Isaac, Person +Marilyn, Person Luke] +Pets: [[Cymric Molly, Mutt Spot], [Cat Shackleton, Cat +Elsie May, Dog Margrett], [Rat Freckly], [Pug Louie aka +Louis Snorkelstein Dupree, Cat Stanford, Cat Pinkola], +[Rat Fuzzy, Rat Fizzy]] +Person Dawn has: + Cymric Molly + Mutt Spot +Person Kate has: + Cat Shackleton + Cat Elsie May + Dog Margrett +Person Isaac has: + Rat Freckly +Person Marilyn has: + Pug Louie aka Louis Snorkelstein Dupree + Cat Stanford + Cat Pinkola +Person Luke has: + Rat Fuzzy + Rat Fizzy +*/ +``` + +**Map** 可以返回由其键组成的 **Set** ，由其值组成的 **Collection** ，或者其键值对的 **Set** 。 **keySet()** 方法生成由在 **petPeople** 中的所有键组成的 **Set** ，它在*for-in*语句中被用来遍历该 **Map** 。 ## 队列Queue +队列是一个典型的“先进先出”（FIFO）集合。 即从集合的一端放入事物，再从另一端去获取它们，事物放入集合的顺序和被取出的顺序是相同的。队列通常被当做一种可靠的将对象从程序的某个区域传输到另一个区域的途径。队列在[并发编程]()中尤为重要，因为它们可以安全地将对象从一个任务传输到另一个任务。 + +**LinkedList** 实现了 **Queue** 接口，并且提供了一些方法以支持队列行为，因此 **LinkedList** 可以用作 **Queue** 的一种实现。 通过将 **LinkedList** 向上转换为 **Queue** ，下面的示例使用了在 **Queue** 接口中与 **Queue** 相关(Queue-specific)的方法： + +```java +// collections/QueueDemo.java +// Upcasting to a Queue from a LinkedList +import java.util.*; + +public class QueueDemo { + public static void printQ(Queue queue) { + while(queue.peek() != null) + System.out.print(queue.remove() + " "); + System.out.println(); + } + public static void main(String[] args) { + Queue queue = new LinkedList<>(); + Random rand = new Random(47); + for(int i = 0; i < 10; i++) + queue.offer(rand.nextInt(i + 10)); + printQ(queue); + Queue qc = new LinkedList<>(); + for(char c : "Brontosaurus".toCharArray()) + qc.offer(c); + printQ(qc); + } +} +/* Output: +8 1 1 1 5 14 3 1 0 1 +B r o n t o s a u r u s +*/ +``` + +**offer()** 是与 **Queue** 相关的方法之一，它在允许的情况下，在队列的尾部插入一个元素，或者返回 **false** 。 **peek()** 和 **element()** 都返回队头元素而不删除它，但是如果队列为空，则 **element()** 抛出 **NoSuchElementException** ，而 **peek()** 返回 **null** 。 **poll()** 和 **remove()** 都删除并返回队头元素，但如果队列为空，**poll()** 返回 **null** ，而 **remove()** 抛出 **NoSuchElementException** 。 + +自动包装机制会自动将 **nextInt()** 的 **int** 结果转换为 **queue** 所需的 **Integer** 对象，并将 **char c** 转换为 **qc** 所需的 **Character** 对象。 **Queue** 接口窄化了对 **LinkedList** 方法的访问权限，因此只有适当的方法才能使用，因此能够访问到的 **LinkedList** 的方法会变少（这里实际上可以将 **Queue** 强制转换回 **LinkedList** ，但至少我们不鼓励这样做）。 + +与 **Queue** 相关的方法提供了完整而独立的功能。 也就是说，对于 **Queue** 所继承的 **Collection** ，在不需要使用它的任何方法的情况下，就可以拥有一个可用的 **Queue** 。 + + +### 优先级队列PriorityQueue + +先进先出（FIFO）描述了最典型的*队列规则*（queuing discipline）。队列规则是指在给定队列中的一组元素的情况下，确定下一个弹出队列的元素的规则。先进先出声明的是下一个弹出的元素应该是等待时间最长的元素。 + +优先级队列声明下一个弹出的元素是最需要的元素（具有最高的优先级）。例如，在机场，当飞机临近起飞时，这架飞机的乘客可以在办理登机手续时排到队头。如果构建了一个消息传递系统，某些消息比其他消息更重要，应该尽快处理，而不管它们何时到达。在Java 5中添加了 **PriorityQueue** ，以便自动实现这种行为。 + +当在 **PriorityQueue** 上调用 **offer()** 方法来插入一个对象时，该对象会在队列中被排序。默认的排序使用队列中对象的*自然顺序*（natural order），但是可以通过提供自己的 **Comparator** 来修改这个顺序。 **PriorityQueue** 确保在调用**peek()** ， **poll()** 或 **remove()** 方法时，获得的元素将是队列中优先级最高的元素。 + +让 **PriorityQueue** 与 **Integer** ， **String** 和 **Character** 这样的内置类型一起工作易如反掌。在下面的示例中，第一组值与前一个示例中的随机值相同，可以看到它们从 **PriorityQueue** 中弹出的顺序与前一个示例不同： + +```java +// collections/PriorityQueueDemo.java +import java.util.*; + +public class PriorityQueueDemo { + public static void main(String[] args) { + PriorityQueue priorityQueue = + new PriorityQueue<>(); + Random rand = new Random(47); + for(int i = 0; i < 10; i++) + priorityQueue.offer(rand.nextInt(i + 10)); + QueueDemo.printQ(priorityQueue); + + List ints = Arrays.asList(25, 22, 20, + 18, 14, 9, 3, 1, 1, 2, 3, 9, 14, 18, 21, 23, 25); + priorityQueue = new PriorityQueue<>(ints); + QueueDemo.printQ(priorityQueue); + priorityQueue = new PriorityQueue<>( + ints.size(), Collections.reverseOrder()); + priorityQueue.addAll(ints); + QueueDemo.printQ(priorityQueue); + + String fact = "EDUCATION SHOULD ESCHEW OBFUSCATION"; + List strings = + Arrays.asList(fact.split("")); + PriorityQueue stringPQ = + new PriorityQueue<>(strings); + QueueDemo.printQ(stringPQ); + stringPQ = new PriorityQueue<>( + strings.size(), Collections.reverseOrder()); + stringPQ.addAll(strings); + QueueDemo.printQ(stringPQ); + + Set charSet = new HashSet<>(); + for(char c : fact.toCharArray()) + charSet.add(c); // Autoboxing + PriorityQueue characterPQ = + new PriorityQueue<>(charSet); + QueueDemo.printQ(characterPQ); + } +} +/* Output: +0 1 1 1 1 1 3 5 8 14 +1 1 2 3 3 9 9 14 14 18 18 20 21 22 23 25 25 +25 25 23 22 21 20 18 18 14 14 9 9 3 3 2 1 1 + A A B C C C D D E E E F H H I I L N N O O O O S S +S T T U U U W +W U U U T T S S S O O O O N N L I I H H F E E E D D C C +C B A A + A B C D E F H I L N O S T U W +*/ +``` + +**PriorityQueue** 是允许重复的，最小的值具有最高的优先级（如果是 **String** ，空格也可以算作值，并且比字母的优先级高）。为了展示如何通过提供自己的 **Comparator** 对象来改变顺序，第三个对 **PriorityQueue\** 构造器的调用，和第二个对 **PriorityQueue\** 的调用使用了由 **Collections.reverseOrder()** （Java SE5中新添加的）产生的反序的 **Comparator** 。 + +最后一部分添加了一个 **HashSet** 来消除重复的 **Character**。 + +**Integer** ， **String** 和 **Character** 可以与 **PriorityQueue** 一起使用，因为这些类已经内置了自然排序。如果想在 **PriorityQueue** 中使用自己的类，则必须包含额外的功能以产生自然排序，或者必须提供自己的 **Comparator** 。在[附录：集合主题]()中有一个更复杂的示例来演示这种情况。 ## 集合与迭代器 From 60c8e92dc0b9fd146eb842ef83caa78bf155e4cf Mon Sep 17 00:00:00 2001 From: xiangflight Date: Sat, 13 Jul 2019 23:17:40 +0800 Subject: [PATCH 05/25] =?UTF-8?q?[feat=2010](=E6=8E=A5=E5=8F=A3=20?= =?UTF-8?q?=E5=AE=8C=E7=BB=93)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 +- docs/book/10-Interfaces.md | 778 +++++++++++++++++++++++++++++++++- docs/images/1562999314238.png | Bin 0 -> 164564 bytes 3 files changed, 778 insertions(+), 2 deletions(-) create mode 100644 docs/images/1562999314238.png diff --git a/README.md b/README.md index a326871..c06720a 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ - [x] [第七章 封装](docs/book/07-Implementation-Hiding.md) - [x] [第八章 复用](docs/book/08-Reuse.md) - [x] [第九章 多态](docs/book/09-Polymorphism.md) -- [ ] [第十章 接口](docs/book/10-Interfaces.md) +- [x] [第十章 接口](docs/book/10-Interfaces.md) - [x] [第十一章 内部类](docs/book/11-Inner-Classes.md) - [ ] [第十二章 集合](docs/book/12-Collections.md) - [x] [第十三章 函数式编程](docs/book/13-Functional-Programming.md) diff --git a/docs/book/10-Interfaces.md b/docs/book/10-Interfaces.md index 3cb304b..aff455e 100644 --- a/docs/book/10-Interfaces.md +++ b/docs/book/10-Interfaces.md @@ -966,7 +966,7 @@ import java.util.*; interface StringProcessor extends Processor { @Override String process(Object input); // [1] - String S = "If she weighs the same as a duck, " + "she's made of wood"; // [2] + String S = "If she weighs the same as a duck, she's made of wood"; // [2] static void main(String[] args) { // [3] Applicator.apply(new Upcase(), S); @@ -1009,34 +1009,810 @@ Using Processor Splitter [If, she, weighs, the, same, as, a, duck,, she's, made, of, wood] ``` +>[1] 该声明不是必要的，即使移除它，编译器也不会报错。但是注意这里的协变返回类型从 Object 变成了 String。 +> +>[2] S 自动就是 final 和 static 的，因为它是在接口中定义的。 +> +>[3] 可以在接口中定义 `main()` 方法。 + +这种方式运作得很好，然而你经常遇到的情况是无法修改类。例如在电子滤波器的例子中，类库是被发现而不是创建的。在这些情况下，可以使用*适配器*设计模式。适配器允许代码接受已有的接口产生需要的接口，如下： + +```java +// interfaces/interfaceprocessor/FilterProcessor.java +// {java interfaces.interfaceprocessor.FilterProcessor} +package interfaces.interfaceprocessor; +import interfaces.filters.*; + +class FilterAdapter implements Processor { + Filter filter; + + FilterAdapter(Filter filter) { + this.filter = filter; + } + + @Override + public String name() { + return filter.name(); + } + + @Override + public Waveform process(Object input) { + return filter.process((Waveform) input); + } +} + +punlic class FilterProcessor { + public static void main(String[] args) { + Waveform w = new Waveform(); + Applicator.apply(new FilterAdapter(new LowPass(1.0)), w); + Applicator.apply(new FilterAdapter(new HighPass(2.0)), w); + Applicator.apply(new FilterAdapter(new BandPass(3.0, 4.0)), w); + } +} +``` + +输出： + +``` +Using Processor LowPass +Waveform 0 +Using Processor HighPass +Waveform 0 +Using Processor BandPass +Waveform 0 +``` + +在这种使用适配器的方式中，**FilterAdapter** 的构造器接受已有的接口 **Filter**，继而产生需要的 **Processor** 接口的对象。你可能还注意到 **FilterAdapter** 中使用了委托。 + +协变允许我们从 `process()` 方法中产生一个 **Waveform** 而非 **Object** 对象。 + +将接口与实现解耦使得接口可以应用于多种不同的实现，因而代码更具可复用性。 + ## 多接口结合 +接口没有任何实现——也就是说，没有任何与接口相关的存储——因此无法阻止结合的多接口。这是有价值的，因为你有时需要表示“一个 **x** 是一个 **a** 和一个 **b** 以及一个 **c**”。 + +![类图](../images/1562999314238.png) + +在一个派生类中，你不能要求必须有一个是抽象的活“具体的”（没有任何抽象方法）的基类。如果确实要继承一个非接口的类，那么只能继承一个，其余的基元素必须都是接口。需要将所有的接口名称置于 **implements** 关键字之后且用逗号分隔。可以有任意多个接口，并可以向上转型为每个接口，因为每个接口都是独立的类型。下例展示了一个组合了多接口的具体类产生了新类： + +```java +// interfaces/Adventure.java +// Multiple interfaces +interface CanFight { + void fight(); +} + +interface CanSwim { + void swim(); +} + +interface CanFly { + void fly(); +} + +class ActionCharacter { + public void fight(){} +} + +class Hero extends ActionCharacter implements CanFight, CanSwim, CanFly { + public void swim() {} + + pubilc void fly() {} +} + +public class Adventure { + public static void t(CanFight x) { + x.fight(); + } + + public static void u(CanSwim x) { + x.swim(); + } + + public staic void v(CanFly x) { + x.fly(); + } + + public static void w(ActionCharacter x) { + x.fight(); + } + + public static void main(String[] args) { + Hero h = new Hero(); + t(h); // Treat it as a CanFight + u(h); // Treat it as a CanSwim + v(h); // Treat it as a CanFly + w(h); // Treat it as an ActionCharacter + } +} +``` + +类 **Hero** 结合了具体类 **ActionCharacter** 和接口 **CanFight**、**CanSwim** 和 **CanFly**。当通过这种方式结合具体类和接口时，需要将具体类放在前面，后面跟着接口（否则编译器会报错）。 + +接口 **CanFight** 和类 **ActionCharacter** 中的 `flight()` 方法签名相同，而在类 Hero 中也没有提供 `fight()` 的定义。可以扩展一个接口，但是得到的是另一个接口。当想创建一个对象时，所有的定义必须首先都存在。类 **Hero** 中没有显式地提供 `fight()` 的定义，是由于该方法在类 **ActionCharacter** 中已经定义过，这样才使得创建 **Hero** 对象成为可能。 + +在类 **Adventure** 中可以看到四个方法，它们把不同的接口和具体类作为参数。当创建一个 **Hero** 对象时，它可以被传入这些方法中的任意一个，意味着它可以依次向上转型为每个接口。Java 中这种接口的设计方式，使得程序员不需要付出特别的努力。 + +记住，前面例子展示了使用接口的核心原因之一：为了能够向上转型为多个基类型（以及由此带来的灵活性）。然而，使用接口的第二个原因与使用抽象基类相同：防止客户端程序员创建这个类的对象，确保这仅仅只是一个接口。这带来了一个问题：应该使用接口还是抽象类呢？如果创建不带任何方法定义或成员变量的基类，就选择接口而不是抽象类。事实上，如果知道某事物是一个基类，可以考虑用接口实现它（这个主题在本章总结会再次讨论）。 + ## 使用继承扩展接口 +通过继承，可以很容易在接口中增加方法声明，还可以在新接口中结合多个接口。这两种情况都可以得到新接口，如下例所示： + +```java +// interfaces/HorrorShow.java +// Extending an interface with inheritance +interface Monster { + void menace(); +} + +interface DangerousMonster extends Monster { + void destroy(); +} + +interface Lethal { + void kill(); +} + +class DragonZilla implements DangerousMonster { + @Override + public void menace() {} + + @Override + public void destroy() {} +} + +interface Vampire extends DangerousMonster, Lethal { + void drinkBlood(); +} + +class VeryBadVampire implements Vampire { + @Override + public void menace() {} + + @Override + public void destroy() {} + + @Override + public void kill() {} + + @Override + public void drinkBlood() {} +} + +public class HorrorShow { + static void u(Monster b) { + b.menace(); + } + + static void v(DangerousMonster d) { + d.menace(); + d.destroy(); + } + + static void w(Lethal l) { + l.kill(); + } + + public static void main(String[] args) { + DangerousMonster barney = new DragonZilla(); + u(barney); + v(barney); + Vampire vlad = new VeryBadVampire(); + u(vlad); + v(vlad); + w(vlad); + } +} +``` + +接口 **DangerousMonster** 是 **Monster** 简单扩展的一个新接口，类 **DragonZilla** 实现了这个接口。 + +**Vampire** 中使用的语法仅适用于接口继承。通常来说，**extends** 只能用于单一类，但是在构建接口时可以引用多个基类接口。注意到，接口名之间用逗号分隔。 + +### 结合接口时的命名冲突 + +当实现多个接口时可能会存在一个小陷阱。在前面的例子中，**CanFlight** 和 **ActionCharacter** 具有完全相同的 `flight()` 方法。完全相同的方法没有问题，但是如果它们的签名或返回类型不同会怎么样呢？这里有一个例子： + +```java +// interfaces/InterfaceCollision.java +interface I1 { + void f(); +} + +interface I2 { + int f(int i); +} + +interface I3 { + int f(); +} + +class C { + public int f() { + return 1; + } +} + +class C2 implements I1, I2 { + @Override + public void f() {} + + @Override + public int f(int i) { + return 1; // 重载 + } +} + +class C3 extends C implements I2 { + @Override + public int f(int i) { + return 1; // 重载 + } +} + +class C4 extends C implements I3 { + // 完全相同，没问题 + @Override + public int f() { + return 1; + } +} + +// 方法的返回类型不同 +//- class C5 extends C implements I1 {} +//- interface I4 extends I1, I3 {} +``` + +覆写、实现和重载令人不快地搅和在一起带来了困难。同时，重载方法仅根据返回类型是区分不了的。当不注释最后两行时，报错信息如下： + +``` +error: C5 is not abstract and does not override abstract +method f() in I1 +class C5 extends C implements I1 {} +error: types I3 and I1 are incompatible; both define f(), +but with unrelated return types +interfacce I4 extends I1, I3 {} +``` + +当打算组合接口时，在不同的接口中使用相同的方法名通常会造成代码可读性的混乱，尽量避免这种情况。 + ## 接口适配 +接口最吸引人的原因之一是相同的接口可以有多个实现。在简单情况下体现在一个方法接受接口作为参数，该接口的实现和传递对象给方法则交由你来做。 + +因此，接口的一种常见用法是前面提到的*策略*设计模式。编写一个方法执行某些操作并接受一个指定的接口作为参数。可以说：“只要对象遵循接口，就可以调用方法” ，这使得方法更加灵活，通用，并更具可复用性。 + +例如，类 **Scanner** 的构造器接受的是一个 **Readable** 接口（在“字符串”一章中学习更多相关内容）。你会发现 **Readable** 没有用作 Java 标准库中其他任何方法的参数——它是单独为 **Scanner** 创建的，因此 **Scanner** 没有将其参数限制为某个特定类。通过这种方式，**Scanner** 可以与更多的类型协作。如果你创建了一个新类并想让 **Scanner** 作用于它，就让它实现 **Readable** 接口，像这样： + +```java +// interfaces/RandomStrings.java +// Implementing an interface to conform to a method +import java.nio.*; +import java.util.*; + +public class RandomStrings implements Readable { + private statdic Random rand = new Random(47); + private static final char[] CAPITALS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ".toCharArray(); + private static final char[] LOWERS = "abcdefghijklmnopqrstuvwxyz".toCharArray(); + private static final char[] VOWELS = "aeiou".toCharArray(); + private int count; + + public RandomStrings(int count) { + this.count = count; + } + + @Override + public int read(CharBuffer cb) { + if (count-- == 0) { + return -1; // indicates end of input + } + cb.append(CAPITALS[rand.nextInt(CAPITALS.length)]); + for (int i = 0; i < 4; i++) { + cb.append(VOWELS[rand.nextInt(VOWELS.length)]); + cb.append(LOWERS[rand.nextInt(LOWERS.length)]); + } + cb.append(" "); + return 10; // Number of characters appended + } + + public static void main(String[] args) { + Scanner s = new Scanner(new RandomStrings(10)); + while (s.hasNext()) { + System.out.println(s.next()); + } + } +} +``` + +输出： + +``` +Yazeruyac +Fowenucor +Goeazimom +Raeuuacio +Nuoadesiw +Hageaikux +Ruqicibui +Numasetih +Kuuuuozog +Waqizeyoy +``` + +**Readable** 接口只需要实现 `read()` 方法（注意 `@Override` 注解的突出方法）。在 `read()` 方法里，将输入内容添加到 **CharBuffer** 参数中（有多种方法可以实现，查看 **CharBuffer** 文档），或在没有输入时返回 **-1**。 + +假设你有一个类没有实现 **Readable** 接口，怎样才能让 **Scanner** 作用于它呢？下面是一个产生随机浮点数的例子： + +```java +// interfaces/RandomDoubles.java +import java.util.*; + +public interface RandomDoubles { + Random RAND = new Random(47); + + default double next() { + return RAND.nextDouble(); + } + + static void main(String[] args) { + RandomDoubles rd = new RandomDoubles(){}; + for (int i = 0; i < 7; i++) { + System.out.println(rd.next() + " "); + } + } +} +``` + +输出： + +``` +0.7271157860730044 +0.5309454508634242 +0.16020656493302599 +0.18847866977771732 +0.5166020801268457 +0.2678662084200585 +0.2613610344283964 +``` + +我们可以再次使用适配器模式，但这里适配器类可以实现两个接口。因此，通过关键字 **interface** 提供的多继承，我们可以创建一个既是 **RandomDoubles**，又是 **Readable** 的类： + +```java +// interfaces/AdaptedRandomDoubles.java +// creating an adapter with inheritance +import java.nio.*; +import java.util.*; + +public class AdaptedRandomDoubles implements RandomDoubles, Readable { + private int count; + + public AdaptedRandomDoubles(int count) { + this.count = count; + } + + @Override + public int read(CharBuffer cb) { + if (count-- == 0) { + return -1; + } + String result = Double.toString(next()) + " "; + cb.append(result); + return result.length(); + } + + public static void main(String[] args) { + Scanner s = new Scanner(new AdaptedRandomDoubles(7)); + while (s.hasNextDouble()) { + System.out.print(s.nextDouble() + " "); + } + } +} +``` + +输出： + +``` +0.7271157860730044 0.5309454508634242 +0.16020656493302599 0.18847866977771732 +0.5166020801268457 0.2678662084200585 +0.2613610344283964 +``` + +因为你可以以这种方式在已有类中增加新接口，所以这就意味着一个接受接口类型的方法提供了一种让任何类都可以与该方法进行适配的方式。这就是使用接口而不是类的强大之处。 + ## 接口字段 +因为接口中的字段都自动是 **static** 和 **final** 的，所以接口就成为了创建一组常量的方便的工具。在 Java 5 之前，这是产生与 C 或 C++ 中的 enum (枚举类型) 具有相同效果的唯一方式。所以你可能在 Java 5 之前的代码中看到： + +```java +// interfaces/Months.java +// Using interfaces to create groups of constants +public interface Months { + int + JANUARY = 1, FEBRUARY = 2, MARCH = 3, + APRIL = 4, MAY = 5, JUNE = 6, JULY = 7, + AUGUST = 8, SEPTEMBER = 9, OCTOBER = 10, + NOVEMBER = 11, DECEMBER = 12; +} +``` + +注意 Java 中使用大写字母的风格定义具有初始化值的 **static** **final** 变量。接口中的字段自动是 **public** 的，所以没有显式指明这点。 + +自 Java 5 开始，我们有了更加强大和灵活的关键字 **enum**，那么在接口中定义常量组就显得没什么意义了。然而当你阅读遗留的代码时，在很多场合你还会碰到这种旧的习惯用法。在“枚举”一章中你会学习到更多关于枚举的内容。 + +### 初始化接口中的字段 + +接口中定义的字段不能是“空 **final**"，但是可以用非常量表达式初始化。例如： + +```java +// interfaces/RandVals.java +// Initializing interface fields with +// non-constant initializers +import java.util.*; + +public interface RandVals { + Random RAND = new Random(47); + int RANDOM_INT = RAND.nextInt(10); + long RANDOM_LONG = RAND.nextLong() * 10; + float RANDOM_FLOAT = RAND.nextLong() * 10; + double RANDOM_DOUBLE = RAND.nextDouble() * 10; +} +``` + +因为字段是 **static** 的，所以它们在类第一次被加载时初始化，这发生在任何字段首次被访问时。下面是个简单的测试： + +```java +// interfaces/TestRandVals.java +public class TestRandVals { + public static void main(String[] args) { + System.out.println(RandVals.RANDOM_INT); + System.out.println(RandVals.RANDOM_LONG); + System.out.println(RandVals.RANDOM_FLOAT); + System.out.println(RandVals.RANDOM_DOUBLE); + } +} +``` + +输出： + +``` +8 +-32032247016559954 +-8.5939291E18 +5.779976127815049 +``` + +这些字段不是接口的一部分，它们的值被存储在接口的静态存储区域中。 + ## 接口嵌套 +接口可以嵌套在类或其他接口中。下面揭示一些有趣的特性： + +```java +// interfaces/nesting/NestingInterfaces.java +// {java interfaces.nesting.NestingInterfaces} +package interfaces.nesting; + +class A { + interface B { + void f(); + } + + public class BImp implements B { + @Override + public void f() {} + } + + public class BImp2 implements B { + @Override + public void f() {} + } + + public interface C { + void f(); + } + + class CImp implements C { + @Override + public void f() {} + } + + private class CImp2 implements C { + @Override + public void f() {} + } + + private interface D { + void f(); + } + + private class DImp implements D { + @Override + public void f() {} + } + + public class DImp2 implements D { + @Override + public void f() {} + } + + public D getD() { + return new DImp2(); + } + + private D dRef; + + public void receiveD(D d) { + dRef = d; + dRef.f(); + } +} + +interface E { + interface G { + void f(); + } + // Redundant "public" + public interface H { + void f(); + } + + void g(); + // Cannot be private within an interface + //- private interface I {} +} + +public class NestingInterfaces { + public class BImp implements A.B { + @Override + public void f() {} + } + + class CImp implements A.C { + @Override + public void f() {} + } + // Cannot implements a private interface except + // within that interface's defining class: + //- class DImp implements A.D { + //- public void f() {} + //- } + class EImp implements E { + @Override + public void g() {} + } + + class EGImp implements E.G { + @Override + public void f() {} + } + + class EImp2 implements E { + @Override + public void g() {} + + class EG implements E.G { + @Override + public void f() {} + } + } + + public static void main(String[] args) { + A a = new A(); + // Can't access to A.D: + //- A.D ad = a.getD(); + // Doesn't return anything but A.D: + //- A.DImp2 di2 = a.getD(); + // cannot access a member of the interface: + //- a.getD().f(); + // Only another A can do anything with getD(): + A a2 = new A(); + a2.receiveD(a.getD()); + } +} +``` + +在类中嵌套接口的语法是相当显而易见的。就像非嵌套接口一样，它们具有 **public** 或包访问权限的可见性。 + +作为一种新添加的方式，接口也可以是 **private** 的，例如 **A.D**（同样的语法同时适用于嵌套接口和嵌套类）。那么 **private** 嵌套接口有什么好处呢？你可能猜测它只是被用来实现一个 **private** 内部类，就像 **DImp**。然而 **A.DImp2** 展示了它可以被实现为 **public** 类，但是 **A.DImp2** 只能被自己使用，你无法说它实现了 **private** 接口 **D**，所以实现 **private** 接口是一种可以强制该接口中的方法定义不会添加任何类型信息（即不可以向上转型）的方式。 + +`getD()` 方法产生了一个与 **private** 接口有关的窘境。它是一个 **public** 方法却返回了对 **private** 接口的引用。能对这个返回值做些什么呢？`main()` 方法里进行了一些使用返回值的尝试但都失败了。返回值必须交给有权使用它的对象，本例中另一个 **A** 通过 `receiveD()` 方法接受了它。 + +接口 **E** 说明了接口之间也能嵌套。然而，作用于接口的规则——尤其是，接口中的元素必须是 **public** 的——在此都会被严格执行，所以嵌套在另一个接口中的接口自动就是 **public** 的，不能指明为 **private**。 + +类 **NestingInterfaces** 展示了嵌套接口的不同实现方式。尤其是当实现某个接口时，并不需要实现嵌套在其内部的接口。同时，**private** 接口不能在定义它的类之外被实现。 + +添加这些特性的最初原因看起来像是出于对严格的语法一致性的考虑，但是我通常认为，一旦你了解了某种特性，就总能找到其用武之地。 + ## 接口和工厂方法模式 +接口是多实现的途径，而生成符合某个接口的对象的典型方式是*工厂方法*设计模式。不同于直接调用构造器，只需调用工厂对象中的创建方法就能生成对象的实现——理论上，通过这种方式可以将接口与实现的代码完全分离，使得可以透明地将某个实现替换为另一个实现。这里是一个展示工厂方法结构的例子： + +```java +// interfaces/Factories.java +interface Service { + void method1(); + void method2(); +} + +interface ServiceFactory { + Service getService(); +} + +class Service1 implements Service { + Service1() {} // Package access + + @Override + public void method1() { + System.out.println("Service1 method1"); + } + + @Override + public void method2() { + System.out.println("Service1 method2"); + } +} + +class Service1Factory implements ServiceFactory { + @Override + public Service getService() { + return new Service1(); + } +} + +class Service2 implements Service { + Service2() {} // Package access + + @Override + public void method1() { + System.out.println("Service2 method1"); + } + + @Override + public void method2() { + System.out.println("Service2 method2"); + } +} + +class Service2Factory implements ServiceFactory { + @Override + public Service getService() { + return new Service2(); + } +} + +public class Factories { + public static void serviceConsumer(ServiceFactory fact) { + Service s = fact.getService(); + s.method1(); + s.method2(); + } + + public static void main(String[] args) { + serviceConsumer(new Service1Factory()); + // Services are completely interchangeable: + serviceConsumer(new Service2Factory()); + } +} +``` + +输出： + +``` +Service1 method1 +Service1 method2 +Service2 method1 +Service2 method2 +``` + +如果没有工厂方法，代码就必须在某处指定将要创建的 **Service** 的确切类型，从而调用恰当的构造器。 + +为什么要添加额外的间接层呢？一个常见的原因是创建框架。假设你正在创建一个游戏系统；例如，在相同的棋盘下国际象棋和西洋跳棋： + +```java +// interfaces/Games.java +// A Game framework using Factory Methods +interface Game { + boolean move(); +} + +interface GameFactory { + Game getGame(); +} + +class Checkers implements Game { + private int moves = 0; + private static final int MOVES = 3; + + @Override + public boolean move() { + System.out.println("Checkers move " + moves); + return ++moves != MOVES; + } +} + +class CheckersFactory implements GameFactory { + @Override + public Game getGame() { + return new Checkers(); + } +} + +class Chess implements Game { + private int moves = 0; + private static final int MOVES = 4; + + @Override + public boolean move() { + System.out.println("Chess move " + moves); + return ++moves != MOVES; + } +} + +class ChessFactory implements GameFactory { + @Override + public Game getGame() { + return new Chess(); + } +} + +public class Games { + public static void playGame(GameFactory factory) { + Game s = factory.getGame(); + while (s.move()) { + ; + } + } + + public static void main(String[] args) { + playGame(new CheckersFactory()); + playGame(new ChessFactory()); + } +} +``` + +输出： + +``` +Checkers move 0 +Checkers move 1 +Checkers move 2 +Chess move 0 +Chess move 1 +Chess move 2 +Chess move 3 +``` + +如果类 **Games** 表示一段很复杂的代码，那么这种方式意味着你可以在不同类型的游戏里复用这段代码。你可以再想象一些能够从这个模式中受益的更加精巧的游戏。 + +在下一章，你将会看到一种更加优雅的使用匿名内部类的工厂实现方式。 + ## 本章小结 +认为接口是好的选择，从而使用接口不用具体类，这具有诱惑性。几乎任何时候，创建类都可以替代为创建一个接口和工厂。 + +很多人都掉进了这个陷阱，只要有可能就创建接口和工厂。这种逻辑看起来像是可能会使用不同的实现，所以总是添加这种抽象性。这变成了一种过早的设计优化。 + +任何抽象性都应该是由真正的需求驱动的。当有必要时才应该使用接口进行重构，而不是到处添加额外的间接层，从而带来额外的复杂性。这种复杂性非常显著，如果你让某人去处理这种复杂性，只是因为你意识到“以防万一”而添加新接口，而没有其他具有说服力的原因——好吧，如果我碰上了这种设计，就会质疑此人所作的所有其他设计了。 + +恰当的原则是优先使用类而不是接口。从类开始，如果使用接口的必要性变得很明确，那么就重构。接口是一个伟大的工具，但它们容易被滥用。 +
\ No newline at end of file diff --git a/docs/images/1562999314238.png b/docs/images/1562999314238.png new file mode 100644 index 0000000000000000000000000000000000000000..16c137d26f19a085c30802090282d6653c9d0e09 GIT binary patch literal 164564 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 tA5!Ro5_Llae literal 0 HcmV?d00001 From ca60f80c740ebc9783d7596987e33dd821af0cd7 Mon Sep 17 00:00:00 2001 From: Joe <736777445@qq.com> Date: Sat, 13 Jul 2019 23:29:49 +0800 Subject: [PATCH 06/25] Update CONTRIBUTING.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 增加视频演示 --- CONTRIBUTING.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2eb2ef8..907a705 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -36,6 +36,10 @@ $ git rebase upstream/master $ git push -f origin master ``` +## 视频演示教程 + +- https://www.bilibili.com/video/av58040840 + ## 排版规范 本开源书籍排版布局和翻译风格上参考**阮一峰**老师的 [中文技术文档的写作规范](https://github.com/ruanyf/document-style-guide) From 84f872317b1352d18a9156d33d832ee447f8dde2 Mon Sep 17 00:00:00 2001 From: 1326670425 <1326670425@qq.com> Date: Sun, 14 Jul 2019 13:28:06 +0800 Subject: [PATCH 07/25] =?UTF-8?q?=E7=AC=AC=E5=8D=81=E4=BA=8C=E7=AB=A0=20?= =?UTF-8?q?=E9=9B=86=E5=90=88=20=E6=AD=A3=E6=96=87=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E5=AE=8C=E6=88=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/12-Collections.md | 518 +++++++++++++++++++++++++++++++++++- 1 file changed, 517 insertions(+), 1 deletion(-) diff --git a/docs/book/12-Collections.md b/docs/book/12-Collections.md index c861b3a..9acbd25 100644 --- a/docs/book/12-Collections.md +++ b/docs/book/12-Collections.md @@ -1266,14 +1266,530 @@ C B A A ## 集合与迭代器 +**Collection** 是所有序列集合共有的根接口。它可能会被认为是一种“附属接口”（incidental interface），即因为要表示其他若干个接口的共性而出现的接口。此外，**java.util.AbstractCollection** 类提供了 **Collection** 的默认实现，使得你可以创建 **AbstractCollection** 的子类型，而其中没有不必要的代码重复。 + +使用接口描述的一个理由是它可以使我们创建更通用的代码。通过针对接口而非具体实现来编写代码，我们的代码可以应用于更多类型的对象。因此，如果所编写的方法接受一个 **Collection** ，那么该方法可以应用于任何实现了 **Collection** 的类——这也就使得一个新类可以选择去实现 **Collection** 接口，以便该方法可以使用它。标准C++类库中的的集合并没有共同的基类——集合之间的所有共性都是通过迭代器实现的。在Java中，遵循C++的方式看起来似乎很明智，即用迭代器而不是 **Collection** 来表示集合之间的共性。但是，这两种方法绑定在了一起，因为实现 **Collection** 就意味着需要提供 **iterator()** 方法： + +```java +// collections/InterfaceVsIterator.java +import typeinfo.pets.*; +import java.util.*; + +public class InterfaceVsIterator { + public static void display(Iterator it) { + while(it.hasNext()) { + Pet p = it.next(); + System.out.print(p.id() + ":" + p + " "); + } + System.out.println(); + } + public static void display(Collection pets) { + for(Pet p : pets) + System.out.print(p.id() + ":" + p + " "); + System.out.println(); + } + public static void main(String[] args) { + List petList = Pets.list(8); + Set petSet = new HashSet<>(petList); + Map petMap = new LinkedHashMap<>(); + String[] names = ("Ralph, Eric, Robin, Lacey, " + + "Britney, Sam, Spot, Fluffy").split(", "); + for(int i = 0; i < names.length; i++) + petMap.put(names[i], petList.get(i)); + display(petList); + display(petSet); + display(petList.iterator()); + display(petSet.iterator()); + System.out.println(petMap); + System.out.println(petMap.keySet()); + display(petMap.values()); + display(petMap.values().iterator()); + } +} +/* Output: +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +{Ralph=Rat, Eric=Manx, Robin=Cymric, Lacey=Mutt, +Britney=Pug, Sam=Cymric, Spot=Pug, Fluffy=Manx} +[Ralph, Eric, Robin, Lacey, Britney, Sam, Spot, Fluffy] +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +*/ +``` + +两个版本的 **display()** 方法都可以使用 **Map** 或 **Collection** 的子类型来工作。 而且**Collection** 接口和 **Iterator** 都将 **display()** 方法与低层集合的特定实现解耦。 + +在本例中，这两种方式都可以奏效。事实上， **Collection** 要更方便一点，因为它是 **Iterable** 类型，因此在 **display(Collection)** 的实现中可以使用*for-in*构造，这使得代码更加清晰。 + +当需要实现一个不是 **Collection** 的外部类时，由于让它去实现 **Collection** 接口可能非常困难或麻烦，因此使用 **Iterator** 就会变得非常吸引人。例如，如果我们通过继承一个持有 **Pet** 对象的类来创建一个 **Collection** 的实现，那么我们必须实现 **Collection** 所有的方法，即使我们不在 **display()** 方法中使用它们，也必须这样做。虽然这可以通过继承 **AbstractCollection** 而很容易地实现，但是无论如何还是要被强制去实现 **iterator()** 和 **size()** 方法，这些方法 **AbstractCollection** 没有实现，但是 **AbstractCollection** 中的其它方法会用到： + +```java +// collections/CollectionSequence.java +import typeinfo.pets.*; +import java.util.*; + +public class CollectionSequence +extends AbstractCollection { + private Pet[] pets = Pets.array(8); + @Override + public int size() { return pets.length; } + @Override + public Iterator iterator() { + return new Iterator() { // [1] + private int index = 0; + @Override + public boolean hasNext() { + return index < pets.length; + } + @Override + public Pet next() { return pets[index++]; } + @Override + public void remove() { // Not implemented + throw new UnsupportedOperationException(); + } + }; + } + public static void main(String[] args) { + CollectionSequence c = new CollectionSequence(); + InterfaceVsIterator.display(c); + InterfaceVsIterator.display(c.iterator()); + } +} +/* Output: +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +*/ +``` + +**remove()** 方法是一个“可选操作”，在[附录：集合主题]()中详细介绍。 这里可以不必实现它，如果你调用它，它将抛出异常。 + +- **[1]** 你可能会认为，因为 **iterator()** 返回 **Iterator\** ，匿名内部类定义可以使用菱形语法，Java可以推断出类型。但这不起作用，类型推断仍然非常有限。 + +这个例子表明，如果实现了 **Collection** ，就必须实现 **iterator()** ，并且只拿实现 **iterator()** 与继承 **AbstractCollection** 相比，花费的代价只有略微减少。但是，如果类已经继承了其他的类，那么就不能继承再 **AbstractCollection** 了。 在这种情况下，要实现 **Collection** ，就必须实现该接口中的所有方法。 此时，继承并提供创建迭代器的能力要容易得多： + +```java +// collections/NonCollectionSequence.java +import typeinfo.pets.*; +import java.util.*; + +class PetSequence { + protected Pet[] pets = Pets.array(8); +} + +public class NonCollectionSequence extends PetSequence { + public Iterator iterator() { + return new Iterator() { + private int index = 0; + @Override + public boolean hasNext() { + return index < pets.length; + } + @Override + public Pet next() { return pets[index++]; } + @Override + public void remove() { // Not implemented + throw new UnsupportedOperationException(); + } + }; + } + public static void main(String[] args) { + NonCollectionSequence nc = + new NonCollectionSequence(); + InterfaceVsIterator.display(nc.iterator()); + } +} +/* Output: +0:Rat 1:Manx 2:Cymric 3:Mutt 4:Pug 5:Cymric 6:Pug +7:Manx +*/ +``` + +生成 **Iterator** 是将序列与消费该序列的方法连接在一起耦合度最小的方式，并且与实现 **Collection** 相比，它在序列类上所施加的约束也少得多。 ## for-in和迭代器 +到目前为止，*for-in*语法主要用于数组，但它也适用于任何 **Collection** 对象。实际上在使用 **ArrayList** 时，已经看到了一些使用它的示例，下面是一个更通用的证明： + +```java +// collections/ForInCollections.java +// All collections work with for-in +import java.util.*; + +public class ForInCollections { + public static void main(String[] args) { + Collection cs = new LinkedList<>(); + Collections.addAll(cs, + "Take the long way home".split(" ")); + for(String s : cs) + System.out.print("'" + s + "' "); + } +} +/* Output: +'Take' 'the' 'long' 'way' 'home' +*/ +``` + +由于 **cs** 是一个 **Collection** ，因此该代码展示了使用*for-in*是所有 **Collection** 对象的特征。 + +这样做的原因是Java SE5引入了一个名为 **Iterable** 的接口，该接口包含一个能够生成 **Iterator** 的 **iterator()** 方法。*for-in*使用此 **Iterable** 接口来遍历序列。因此，如果创建了任何实现了 **Iterable** 的类，都可以将它用于*for-in*语句中： + +```java +// collections/IterableClass.java +// Anything Iterable works with for-in +import java.util.*; + +public class IterableClass implements Iterable { + protected String[] words = ("And that is how " + + "we know the Earth to be banana-shaped." + ).split(" "); + @Override + public Iterator iterator() { + return new Iterator() { + private int index = 0; + @Override + public boolean hasNext() { + return index < words.length; + } + @Override + public String next() { return words[index++]; } + @Override + public void remove() { // Not implemented + throw new UnsupportedOperationException(); + } + }; + } + public static void main(String[] args) { + for(String s : new IterableClass()) + System.out.print(s + " "); + } +} +/* Output: +And that is how we know the Earth to be banana-shaped. +*/ +``` + +**iterator()** 返回的是实现了 **Iterator\** 的匿名内部类的实例，该匿名内部类可以遍历数组中的每个单词。在 **main()** 中，可以看到 **IterableClass** 确实可以用于*for-in*语句。 + +在Java SE5中，许多类都是 **Iterable** ，主要包括所有的 **Collection** 类（但不包括各种 **Maps** ）。 例如，下面的代码可以显示所有的操作系统环境变量： + +```java +// collections/EnvironmentVariables.java +// {VisuallyInspectOutput} +import java.util.*; + +public class EnvironmentVariables { + public static void main(String[] args) { + for(Map.Entry entry: System.getenv().entrySet()) { + System.out.println(entry.getKey() + ": " + + entry.getValue()); + } + } +} +``` + +**System.getenv()** 返回一个 **Map** ， **entrySet()** 产生一个由 **Map.Entry** 的元素构成的 **Set** ，并且这个 **Set** 是一个 **Iterable** ，因此它可以用于*for-in*循环。 + +*for-in*语句适用于数组或其它任何 **Iterable** ，但这并不意味着数组肯定也是个 **Iterable** ，也不会发生任何自动装箱： + +```java +// collections/ArrayIsNotIterable.java +import java.util.*; + +public class ArrayIsNotIterable { + static void test(Iterable ib) { + for(T t : ib) + System.out.print(t + " "); + } + public static void main(String[] args) { + test(Arrays.asList(1, 2, 3)); + String[] strings = { "A", "B", "C" }; + // An array works in for-in, but it's not Iterable: + //- test(strings); + // You must explicitly convert it to an Iterable: + test(Arrays.asList(strings)); + } +} +/* Output: +1 2 3 A B C +*/ +``` + +尝试将数组作为一个 **Iterable** 参数传递会导致失败。这说明不存在任何从数组到 **Iterable** 的自动转换; 必须手工执行这种转换。 + + +### 适配器方法惯用法 + +如果现在有一个 **Iterable** 类，你想要添加一种或多种在*for-in*语句中使用这个类的方法，应该怎么做呢？ 例如，假设你希望可以选择是在正向还是反向遍历一个单词列表。如果直接继承这个类，并覆盖 **iterator()** 方法，则只能替换现有的方法，而不能实现选择。 + +一种解决方案是所谓*适配器方法*（Adapter Method）的惯用法。“适配器”部分来自于设计模式，因为必须要提供特定的接口来满足*for-in*语句。如果已经有一个接口并且需要另一个接口时，则编写适配器就可以解决这个问题。 +在这里，若希望在默认的正向迭代器的基础上，添加产生反向迭代器的能力，因此不能使用覆盖，相反，而是添加了一个能够生成 **Iterable** 对象的方法，该对象可以用于*for-in*语句。这使得我们可以提供多种使用*for-in*语句的方式： + +```java +// collections/AdapterMethodIdiom.java +// The "Adapter Method" idiom uses for-in +// with additional kinds of Iterables +import java.util.*; + +class ReversibleArrayList extends ArrayList { + ReversibleArrayList(Collection c) { + super(c); + } + public Iterable reversed() { + return new Iterable() { + public Iterator iterator() { + return new Iterator() { + int current = size() - 1; + public boolean hasNext() { + return current > -1; + } + public T next() { return get(current--); } + public void remove() { // Not implemented + throw new UnsupportedOperationException(); + } + }; + } + }; + } +} + +public class AdapterMethodIdiom { + public static void main(String[] args) { + ReversibleArrayList ral = + new ReversibleArrayList( + Arrays.asList("To be or not to be".split(" "))); + // Grabs the ordinary iterator via iterator(): + for(String s : ral) + System.out.print(s + " "); + System.out.println(); + // Hand it the Iterable of your choice + for(String s : ral.reversed()) + System.out.print(s + " "); + } +} +/* Output: +To be or not to be +be to not or be To +*/ +``` + +在 **main()** 中，如果直接将 **ral** 对象放在*for-in*语句中，则会得到（默认的）正向迭代器。但是如果在该对象上调用 **reversed()** 方法，它会产生不同的行为。 + +通过使用这种方式，可以在 **IterableClass.java** 示例中添加两种适配器方法： + +```java +// collections/MultiIterableClass.java +// Adding several Adapter Methods +import java.util.*; + +public class MultiIterableClass extends IterableClass { + public Iterable reversed() { + return new Iterable() { + public Iterator iterator() { + return new Iterator() { + int current = words.length - 1; + public boolean hasNext() { + return current > -1; + } + public String next() { + return words[current--]; + } + public void remove() { // Not implemented + throw new UnsupportedOperationException(); + } + }; + } + }; + } + public Iterable randomized() { + return new Iterable() { + public Iterator iterator() { + List shuffled = + new ArrayList(Arrays.asList(words)); + Collections.shuffle(shuffled, new Random(47)); + return shuffled.iterator(); + } + }; + } + public static void main(String[] args) { + MultiIterableClass mic = new MultiIterableClass(); + for(String s : mic.reversed()) + System.out.print(s + " "); + System.out.println(); + for(String s : mic.randomized()) + System.out.print(s + " "); + System.out.println(); + for(String s : mic) + System.out.print(s + " "); + } +} +/* Output: +banana-shaped. be to Earth the know we how is that And +is banana-shaped. Earth that how the be And we know to +And that is how we know the Earth to be banana-shaped. +*/ +``` + +注意，第二个方法 **random()** 没有创建它自己的 **Iterator** ，而是直接返回被打乱的 **List** 中的 **Iterator** 。 + +从输出中可以看到， **Collections.shuffle()** 方法不会影响到原始数组，而只是打乱了 **shuffled** 中的引用。之所以这样，是因为 **randomized()** 方法用一个 **ArrayList** 将 **Arrays.asList()** 的结果包装了起来。如果这个由 **Arrays.asList()** 生成的 **List** 被直接打乱，那么它将修改底层数组，如下所示： + +```java +// collections/ModifyingArraysAsList.java +import java.util.*; + +public class ModifyingArraysAsList { + public static void main(String[] args) { + Random rand = new Random(47); + Integer[] ia = { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }; + List list1 = + new ArrayList<>(Arrays.asList(ia)); + System.out.println("Before shuffling: " + list1); + Collections.shuffle(list1, rand); + System.out.println("After shuffling: " + list1); + System.out.println("array: " + Arrays.toString(ia)); + + List list2 = Arrays.asList(ia); + System.out.println("Before shuffling: " + list2); + Collections.shuffle(list2, rand); + System.out.println("After shuffling: " + list2); + System.out.println("array: " + Arrays.toString(ia)); + } +} +/* Output: +Before shuffling: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] +After shuffling: [4, 6, 3, 1, 8, 7, 2, 5, 10, 9] +array: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] +Before shuffling: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] +After shuffling: [9, 1, 6, 3, 7, 2, 5, 10, 4, 8] +array: [9, 1, 6, 3, 7, 2, 5, 10, 4, 8] +*/ +``` + +在第一种情况下， **Arrays.asList()** 的输出被传递给了 **ArrayList** 的构造器，这将创建一个引用 **ia** 的元素的 **ArrayList** ，因此打乱这些引用不会修改该数组。但是，如果直接使用 **Arrays.asList(ia)** 的结果，这种打乱就会修改 **ia** 的顺序。重要的是要注意 **Arrays.asList()** 生成一个 **List** 对象，该对象使用底层数组作为其物理实现。如果执行的会修改这个 **List** ，并且不希望修改原始数组，那么就应该在另一个集合中创建一个副本。 ## 本章小结 +Java提供了许多保存对象的方法： + +1. 数组将数字索引与对象相关联。它保存类型明确的对象，因此在查找对象时不必对结果做类型转换。它可以是多维的，可以保存基本类型的数据。虽然可以在运行时创建数组，但是一旦创建数组，就无法更改数组的大小。 + +2. **Collection** 保存单一的元素，而 **Map** 包含相关联的键值对。使用Java泛型，可以指定集合中保存的对象的类型，因此不能将错误类型的对象放入集合中，并且在从集合中获取元素时，不必进行类型转换。各种 **Collection** 和各种 **Map** 都可以在你向其中添加更多的元素时，自动调整其尺寸大小。集合不能保存基本类型，但自动装箱机制会负责执行基本类型和集合中保存的包装类型之间的双向转换。 + +3. 像数组一样， **List** 也将数字索引与对象相关联，因此，数组和 **List** 都是有序集合。 + +4. 如果要执行大量的随机访问，则使用 **ArrayList** ，如果要经常从表中间插入或删除元素，则应该使用 **LinkedList** 。 + +5. 队列和堆栈的行为是通过 **LinkedList** 提供的。 + +6. **Map** 是一种将对象（而非数字）与对象相关联的设计。 **HashMap** 专为快速访问而设计，而 **TreeMap** 保持键始终处于排序状态，所以没有 **HashMap** 快。 **LinkedHashMap** 按插入顺序保存其元素，但使用散列提供快速访问的能力。 + +7. **Set** 不接受重复元素。 **HashSet** 提供最快的查询速度，而 **TreeSet** 保持元素处于排序状态。 **LinkedHashSets** 按插入顺序保存其元素，但使用散列提供快速访问的能力。 + +8. 不要在新代码中使用遗留类 **Vector** ， **Hashtable** 和 **Stack** 。 + +浏览一下Java集合的简图（不包含抽象类或遗留组件）会很有帮助。这里仅包括在一般情况下会碰到的接口和类。 + +![simple collection taxonomy](../images/simple-collection-taxonomy.png) + + +可以看到，实际上只有四个基本的集合组件： **Map** ， **List** ， **Set** 和 **Queue** ，它们各有两到三个实现版本（**Queue** 的 **java.util.concurrent** 实现未包含在此图中）。最常使用的集合用黑色粗线线框表示。 + +虚线框表示接口，实线框表示普通的（具体的）类。带有空心箭头的虚线表示特定的类实现了一个接口。实心箭头表示某个类可以生成箭头指向的类的对象。例如，任何 **Collection** 都可以生成 **Iterator** ， **List** 可以生成 **ListIterator** （也能生成普通的 **Iterator** ，因为 **List** 继承自 **Collection** ）。 + +下面的示例展示了各种不同的类在方法上的差异。实际代码来自[泛型]()章节，在这里只是调用它来产生输出。程序的输出还展示了在每个类或接口中所实现的接口： + +```java +// collections/CollectionDifferences.java +import onjava.*; + +public class CollectionDifferences { + public static void main(String[] args) { + CollectionMethodDifferences.main(args); + } +} +/* Output: +Collection: [add, addAll, clear, contains, containsAll, +equals, forEach, hashCode, isEmpty, iterator, +parallelStream, remove, removeAll, removeIf, retainAll, +size, spliterator, stream, toArray] +Interfaces in Collection: [Iterable] +Set extends Collection, adds: [] +Interfaces in Set: [Collection] +HashSet extends Set, adds: [] +Interfaces in HashSet: [Set, Cloneable, Serializable] +LinkedHashSet extends HashSet, adds: [] +Interfaces in LinkedHashSet: [Set, Cloneable, +Serializable] +TreeSet extends Set, adds: [headSet, +descendingIterator, descendingSet, pollLast, subSet, +floor, tailSet, ceiling, last, lower, comparator, +pollFirst, first, higher] +Interfaces in TreeSet: [NavigableSet, Cloneable, +Serializable] +List extends Collection, adds: [replaceAll, get, +indexOf, subList, set, sort, lastIndexOf, listIterator] +Interfaces in List: [Collection] +ArrayList extends List, adds: [trimToSize, +ensureCapacity] +Interfaces in ArrayList: [List, RandomAccess, +Cloneable, Serializable] +LinkedList extends List, adds: [offerFirst, poll, +getLast, offer, getFirst, removeFirst, element, +removeLastOccurrence, peekFirst, peekLast, push, +pollFirst, removeFirstOccurrence, descendingIterator, +pollLast, removeLast, pop, addLast, peek, offerLast, +addFirst] +Interfaces in LinkedList: [List, Deque, Cloneable, +Serializable] +Queue extends Collection, adds: [poll, peek, offer, +element] +Interfaces in Queue: [Collection] +PriorityQueue extends Queue, adds: [comparator] +Interfaces in PriorityQueue: [Serializable] +Map: [clear, compute, computeIfAbsent, +computeIfPresent, containsKey, containsValue, entrySet, +equals, forEach, get, getOrDefault, hashCode, isEmpty, +keySet, merge, put, putAll, putIfAbsent, remove, +replace, replaceAll, size, values] +HashMap extends Map, adds: [] +Interfaces in HashMap: [Map, Cloneable, Serializable] +LinkedHashMap extends HashMap, adds: [] +Interfaces in LinkedHashMap: [Map] +SortedMap extends Map, adds: [lastKey, subMap, +comparator, firstKey, headMap, tailMap] +Interfaces in SortedMap: [Map] +TreeMap extends Map, adds: [descendingKeySet, +navigableKeySet, higherEntry, higherKey, floorKey, +subMap, ceilingKey, pollLastEntry, firstKey, lowerKey, +headMap, tailMap, lowerEntry, ceilingEntry, +descendingMap, pollFirstEntry, lastKey, firstEntry, +floorEntry, comparator, lastEntry] +Interfaces in TreeMap: [NavigableMap, Cloneable, +Serializable] +*/ +``` + +除 **TreeSet** 之外的所有 **Set** 都具有与 **Collection** 完全相同的接口。**List** 和 **Collection** 存在着明显的不同，尽管 **List** 所要求的方法都在 **Collection** 中。另一方面，在 **Queue** 接口中的方法是独立的，在创建具有 **Queue** 功能的实现时，不需要使用 **Collection** 方法。最后， **Map** 和 **Collection** 之间唯一的交集是Map可以使用 **entrySet()** 和 **values()** 方法来产生 **Collection** 。 + +请注意，标记接口 **java.util.RandomAccess** 附加到了 **ArrayList** 上，但不附加到 **LinkedList** 上。这为根据特定 **List** 动态改变其行为的算法提供了信息。 + +从面向对象的继承层次结构来看，这种组织结构确实有些奇怪。但是，当了解了 **java.util** 中更多的有关集合的内容后（特别是在[附录：集合主题]()中的内容），就会发现出了继承结构有点奇怪外，还有更多的问题。集合类库一直以来都是设计难题——解决这些问题涉及到要去满足经常彼此之间互为牵制的各方面需求。所以要做好准备，在各处做出妥协。 + +尽管存在这些问题，但Java集合仍是在日常工作中使用的基本工具，它可以使程序更简洁、更强大、更有效。你可能需要一段时间才能熟悉集合类库的某些方面，但我想你很快就会找到自己的路子，来获得和使用这个类库中的类。 + + -

\ No newline at end of file +
From 7933dc0249918e269545f09463df3ddfb6d0b49f Mon Sep 17 00:00:00 2001 From: 1326670425 <1326670425@qq.com> Date: Sun, 14 Jul 2019 13:29:38 +0800 Subject: [PATCH 08/25] =?UTF-8?q?=E7=AC=AC=E5=8D=81=E4=BA=8C=E7=AB=A0=20?= =?UTF-8?q?=E9=9B=86=E5=90=88=20=E6=B7=BB=E5=8A=A0=E5=8E=9F=E6=96=87?= =?UTF-8?q?=E8=84=9A=E6=B3=A8=E5=86=85=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/12-Collections.md | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/docs/book/12-Collections.md b/docs/book/12-Collections.md index 9acbd25..0674f47 100644 --- a/docs/book/12-Collections.md +++ b/docs/book/12-Collections.md @@ -17,12 +17,12 @@ MyType aReference 集合还有一些其它特性。例如， **Set** 对于每个值都只保存一个对象， **Map** 是一个关联数组，允许将某些对象与其他对象关联起来。Java集合类都可以自动地调整自己的大小。因此，与数组不同，在编程时，可以将任意数量的对象放置在集合中，而不用关心集合应该有多大。 -尽管在Java中没有直接的关键字支持，集合类仍然是可以显著增强编程能力的基本工具。在本章中，将介绍Java集合类库的基本知识，并重点介绍一些典型用法。这里将专注于在日常编程中使用的集合。稍后，在[附录：集合主题]()中，还将学习到其余的那些集合和相关功能，以及如何使用它们的更多详细信息。 +尽管在Java中没有直接的关键字支持，[^1]但集合类仍然是可以显著增强编程能力的基本工具。在本章中，将介绍Java集合类库的基本知识，并重点介绍一些典型用法。这里将专注于在日常编程中使用的集合。稍后，在[附录：集合主题]()中，还将学习到其余的那些集合和相关功能，以及如何使用它们的更多详细信息。 ## 泛型和类型安全的集合 -使用Java SE5之前的集合的一个主要问题是编译器允许你向集合中插入不正确的类型。例如，考虑一个 **Apple** 对象的集合，这里使用最基本最可靠的 **ArrayList** 。现在，可以把 **ArrayList** 看作“可以自动扩充自身尺寸的数组”来看待。使用 **ArrayList** 相当简单：创建一个实例，用 **add()** 插入对象；然后用 **get()** 来访问这些对象，此时需要使用索引，就像数组那样，但是不需要方括号。 **ArrayList** 还有一个 **size()** 方法，来说明集合中包含了多少个元素，所以不会不小心因数组越界而引发错误（通过抛出*运行时异常*，[异常]()章节介绍了异常）。 +使用Java SE5之前的集合的一个主要问题是编译器允许你向集合中插入不正确的类型。例如，考虑一个 **Apple** 对象的集合，这里使用最基本最可靠的 **ArrayList** 。现在，可以把 **ArrayList** 看作“可以自动扩充自身尺寸的数组”来看待。使用 **ArrayList** 相当简单：创建一个实例，用 **add()** 插入对象；然后用 **get()** 来访问这些对象，此时需要使用索引，就像数组那样，但是不需要方括号。[^2] **ArrayList** 还有一个 **size()** 方法，来说明集合中包含了多少个元素，所以不会不小心因数组越界而引发错误（通过抛出*运行时异常*，[异常]()章节介绍了异常）。 在本例中， **Apple** 和 **Orange** 都被放到了集合中，然后将它们取出。正常情况下，Java编译器会给出警告，因为这个示例没有使用泛型。在这里，使用特定的注解来抑制警告信息。注解以“@”符号开头，可以带参数。这里的 **@SuppressWarning** 注解及其参数表示只抑制“unchecked”类型的警告（[注解]()章节将介绍更多有关注解的信息）： @@ -70,7 +70,7 @@ ndOrangesWithoutGenerics.java:23) 在[泛型]()章节中，你将了解到使用Java泛型来创建类可能很复杂。但是，使用预先定义的泛型类却相当简单。例如，要定义一个用于保存 **Apple** 对象的 **ArrayList** ，只需要使用 **ArrayList** 来代替 **ArrayList** 。尖括号括起来的是*类型参数*（可能会有多个），它指定了这个集合实例可以保存的类型。 -通过使用泛型，就可以在编译期防止将错误类型的对象放置到集合中。下面还是这个示例，但是使用了泛型： +通过使用泛型，就可以在编译期防止将错误类型的对象放置到集合中。[^3]下面还是这个示例，但是使用了泛型： ```java // collections/ApplesAndOrangesWithGenerics.java import java.util.*; @@ -517,7 +517,7 @@ public class SimpleIteration { 如果只是想向前遍历 **List** ，并不打算修改 **List** 对象本身，那么使用 *for-in* 语法更加简洁。 -**Iterator** 还可以删除由 **next()** 生成的最后一个元素，这意味着在调用 **remove()** 之前必须先调用 **next()** 。 +**Iterator** 还可以删除由 **next()** 生成的最后一个元素，这意味着在调用 **remove()** 之前必须先调用 **next()** 。[^4] 在集合中的每个对象上执行操作，这种思想十分强大，并且贯穿于本书。 @@ -1200,7 +1200,7 @@ B r o n t o s a u r u s 优先级队列声明下一个弹出的元素是最需要的元素（具有最高的优先级）。例如，在机场，当飞机临近起飞时，这架飞机的乘客可以在办理登机手续时排到队头。如果构建了一个消息传递系统，某些消息比其他消息更重要，应该尽快处理，而不管它们何时到达。在Java 5中添加了 **PriorityQueue** ，以便自动实现这种行为。 -当在 **PriorityQueue** 上调用 **offer()** 方法来插入一个对象时，该对象会在队列中被排序。默认的排序使用队列中对象的*自然顺序*（natural order），但是可以通过提供自己的 **Comparator** 来修改这个顺序。 **PriorityQueue** 确保在调用**peek()** ， **poll()** 或 **remove()** 方法时，获得的元素将是队列中优先级最高的元素。 +当在 **PriorityQueue** 上调用 **offer()** 方法来插入一个对象时，该对象会在队列中被排序。[^5]默认的排序使用队列中对象的*自然顺序*（natural order），但是可以通过提供自己的 **Comparator** 来修改这个顺序。 **PriorityQueue** 确保在调用**peek()** ， **poll()** 或 **remove()** 方法时，获得的元素将是队列中优先级最高的元素。 让 **PriorityQueue** 与 **Integer** ， **String** 和 **Character** 这样的内置类型一起工作易如反掌。在下面的示例中，第一组值与前一个示例中的随机值相同，可以看到它们从 **PriorityQueue** 中弹出的顺序与前一个示例不同： @@ -1268,7 +1268,7 @@ C B A A **Collection** 是所有序列集合共有的根接口。它可能会被认为是一种“附属接口”（incidental interface），即因为要表示其他若干个接口的共性而出现的接口。此外，**java.util.AbstractCollection** 类提供了 **Collection** 的默认实现，使得你可以创建 **AbstractCollection** 的子类型，而其中没有不必要的代码重复。 -使用接口描述的一个理由是它可以使我们创建更通用的代码。通过针对接口而非具体实现来编写代码，我们的代码可以应用于更多类型的对象。因此，如果所编写的方法接受一个 **Collection** ，那么该方法可以应用于任何实现了 **Collection** 的类——这也就使得一个新类可以选择去实现 **Collection** 接口，以便该方法可以使用它。标准C++类库中的的集合并没有共同的基类——集合之间的所有共性都是通过迭代器实现的。在Java中，遵循C++的方式看起来似乎很明智，即用迭代器而不是 **Collection** 来表示集合之间的共性。但是，这两种方法绑定在了一起，因为实现 **Collection** 就意味着需要提供 **iterator()** 方法： +使用接口描述的一个理由是它可以使我们创建更通用的代码。通过针对接口而非具体实现来编写代码，我们的代码可以应用于更多类型的对象。[^6]因此，如果所编写的方法接受一个 **Collection** ，那么该方法可以应用于任何实现了 **Collection** 的类——这也就使得一个新类可以选择去实现 **Collection** 接口，以便该方法可以使用它。标准C++类库中的的集合并没有共同的基类——集合之间的所有共性都是通过迭代器实现的。在Java中，遵循C++的方式看起来似乎很明智，即用迭代器而不是 **Collection** 来表示集合之间的共性。但是，这两种方法绑定在了一起，因为实现 **Collection** 就意味着需要提供 **iterator()** 方法： ```java // collections/InterfaceVsIterator.java @@ -1498,7 +1498,7 @@ public class EnvironmentVariables { } ``` -**System.getenv()** 返回一个 **Map** ， **entrySet()** 产生一个由 **Map.Entry** 的元素构成的 **Set** ，并且这个 **Set** 是一个 **Iterable** ，因此它可以用于*for-in*循环。 +**System.getenv()** [^7]返回一个 **Map** ， **entrySet()** 产生一个由 **Map.Entry** 的元素构成的 **Set** ，并且这个 **Set** 是一个 **Iterable** ，因此它可以用于*for-in*循环。 *for-in*语句适用于数组或其它任何 **Iterable** ，但这并不意味着数组肯定也是个 **Iterable** ，也不会发生任何自动装箱： @@ -1789,6 +1789,14 @@ Serializable] 尽管存在这些问题，但Java集合仍是在日常工作中使用的基本工具，它可以使程序更简洁、更强大、更有效。你可能需要一段时间才能熟悉集合类库的某些方面，但我想你很快就会找到自己的路子，来获得和使用这个类库中的类。 +[^1]: 许多语言，例如Perl，Python和Ruby，都有 +集合的本地支持。 +[^2]: 这里是操作符重载的用武之地，C++和C#的集合类都使用操作符重载生成了更简洁的语法。 +[^3]: 在[泛型]()章节的末尾，有个关于这个问题是否很严重的讨论。但是，[泛型]()章节还将展示Java泛型远不止是类型安全的集合这么简单。 +[^4]: **remove()** 是一个所谓的“可选”方法（还有一些其它的这种方法），这意味着并非所有的 **Iterator** 实现都必须实现该方法。这个问题将在[附录：集合主题]()中介绍。但是，标准Java库集合实现了 **remove()** ，因此在[附录：集合主题]()章节之前，都不必担心这个问题。 +[^5]: 这实际上依赖于具体实现。优先级队列算法通常会按插入顺序排序（维护一个*堆*），但它们也可以在删除时选择最重要的元素。 如果对象的优先级在它在队列中等待时可以修改，那么算法的选择就显得很重要了。 +[^6]: 有些人提倡这样一种自动创建机制，即对一个类中所有可能的方法组合都自动创建一个接口，有时候对于单个的类都是如此。 我相信接口的意义不应该仅限于方法组合的机械地复制，因此我在创建接口之前，总是要先看到增加接口带来的价值。 +[^7]: 这在Java SE5之前是不可用的，因为该方法被认为与操作系统的耦合度过紧，因此违反“一次编写，处处运行”的原则。现在提供它这一事实表明，Java的设计者们更加务实了。 From 1c862babf32165d3e375676046a6f844684a7b85 Mon Sep 17 00:00:00 2001 From: 1326670425 <1326670425@qq.com> Date: Sun, 14 Jul 2019 13:31:04 +0800 Subject: [PATCH 09/25] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c06720a..b11045d 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ - [x] [第九章 多态](docs/book/09-Polymorphism.md) - [x] [第十章 接口](docs/book/10-Interfaces.md) - [x] [第十一章 内部类](docs/book/11-Inner-Classes.md) -- [ ] [第十二章 集合](docs/book/12-Collections.md) +- [x] [第十二章 集合](docs/book/12-Collections.md) - [x] [第十三章 函数式编程](docs/book/13-Functional-Programming.md) - [x] [第十四章 流式编程](docs/book/14-Streams.md) - [x] [第十五章 异常](docs/book/15-Exceptions.md) From 8c6a68f192423ade5b89c3d5ca45588d4db95f04 Mon Sep 17 00:00:00 2001 From: LingCoder <34231795+LingCoder@users.noreply.github.com> Date: Sun, 14 Jul 2019 14:31:09 +0800 Subject: [PATCH 10/25] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E8=AF=91=E8=80=85?= =?UTF-8?q?=E4=BF=A1=E6=81=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index b11045d..0e7fc04 100644 --- a/README.md +++ b/README.md @@ -90,7 +90,7 @@ ## 贡献者 * 主译：[LingCoder](https://github.com/LingCoder)，[sjsdfg](https://github.com/sjsdfg) -* 参译：[xiangflight](https://github.com/xiangflight)，[LortSir](https://github.com/LortSir) +* 参译：[xiangflight](https://github.com/xiangflight)，[1326670425](https://github.com/1326670425)，[LortSir](https://github.com/LortSir) * 校对：[LingCoder](https://github.com/LingCoder)，[xiangflight](https://github.com/xiangflight)，[nickChenyx](https://github.com/nickChenyx) From 360193eb8b231cfaa6d912b852056654d496c7d0 Mon Sep 17 00:00:00 2001 From: AlfredAlan <854723360@mail.com> Date: Mon, 15 Jul 2019 01:38:25 +0800 Subject: [PATCH 11/25] =?UTF-8?q?feat:=E7=AC=AC=E4=B8=80=E8=8A=82=E7=BA=BF?= =?UTF-8?q?=E7=A8=8B=E9=83=A8=E5=88=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/Appendix-Low-Level-Concurrency.md | 201 +++++++++++++++++++- 1 file changed, 199 insertions(+), 2 deletions(-) diff --git a/docs/book/Appendix-Low-Level-Concurrency.md b/docs/book/Appendix-Low-Level-Concurrency.md index 9de1eb6..47dadd8 100644 --- a/docs/book/Appendix-Low-Level-Concurrency.md +++ b/docs/book/Appendix-Low-Level-Concurrency.md @@ -3,16 +3,192 @@ # 附录:并发底层原理 +> 尽管不建议您自己编写底层 Java 并发代码，但是这样通常有助于了解它是如何工作的。 + +[并发编程](./24-Concurrent-Programming.md) 章节中介绍了一些用于高级并发的概念，包括为 Java 并发编程而最新提出的,更安全的概念（ parallel Streams 和 CompletableFutures ）。本附录则介绍在 Java 中底层并发概念，因此在阅读本篇时，您能有所了解掌握这些代码。您还会将进一步了解并发的普遍问题。 + +在 Java 的早期版本中, 底层并发概念是并发编程的重要组成部分。我们会着眼于围绕这些技巧的复杂性以及为何您应该避免它们而谈。 “并发编程” 章节展示最新的 Java 版本(尤其是 Java 8)所提供的改进技巧，这些技巧使得并发的使用，如果本来不容易使用，也会更容易些。 + + + ## 线程 +并发将程序划分成分离的，独立运行的任务。每个任务都由一个 *执行线程* 来驱动，我们通常将其简称为 *线程* 。而一个 *线程* 就是操作系统进程中单一顺序的控制流。因此，单个进程可以有多个并发执行的任务，但是你的程序使得每个任务都好像有自己的处理器一样。这线程模型为编程带来了便利，它简化了在单一程序中处理变戏法般的多任务过程。操作系统则从处理器上分配时间到您程序的所有线程中。 + +Java 并发的核心机制是 **Thread** 类，在该语言最初版本中， **Thread （线程）** 是由程序员直接创建和管理的。随着语言的发展以及人们发现了更好的一些方法，中间层机制 - 特别是 **Executor** 框架 - 被添加进来，以消除自己管理线程时候的心理负担（及错误）。 最终，甚至发展出比 **Executor** 更好的机制，如 [并发编程](./24-Concurrent-Programming.md) 一章所示。 + +**Thread（线程）** 是将任务关联到处理器的软件概念。虽然创建和使用 **Thread** 类看起来与任何其他类都很相似，但实际上它们是非常不同的。当你创建一个 **Thread** 时，JVM 将分配一大块内存到专为线程保留的特殊区域上，用于提供运行任务时所需的一切，包括： + +* 程序计数器，指明要执行的下一个 JVM 字节码指令。 +* 用于支持 Java 代码执行的栈，包含有关此线程已到达当时执行位置所调用方法的信息。它也包含每个正在执行的方法的所有局部变量(包括原语和堆对象的引用)。每个线程的栈通常在 64K 到 1M 之间 [^1] 。 +* 第二个则用于 native code（本机方法代码）执行的栈 +* *thread-local variables* （线程本地变量）的存储区域 +* 用于控制线程的状态管理变量 + +包括 `main()` 在内的所有代码都会在某个线程内运行。 每当调用一个方法时，当前程序计数器被推到该线程的栈上，然后栈指针向下移动以足够来创建一个栈帧，其栈帧里存储该方法的所有局部变量，参数和返回值。所有基本类型变量都直接在栈上，虽然方法中创建（或方法中使用）对象的任何引用都位于栈帧中，但对象本身存于堆中。这仅且只有一个堆，被程序中所有线程所共享。 + +除此以外，线程必须绑定到操作系统，这样它就可以在某个时候连接到处理器。这是作为线程构建过程的一部分为您管理的。Java 使用底层操作系统中的机制来管理线程的执行。 + +### 最佳线程数 + +如果你查看第 24 章 [并发编程](./24-Concurrent-Programming.md) 中使用 *CachedThreadPool* 的用例，你会发现 **ExecutorService** 为每个我们提交的任务分配一个线程。然而，并行流（**parallel Stream**）在 [**CountingStream.java** ](https://github.com/BruceEckel/OnJava8-Examples/blob/master/concurrent/CountingStream.java +) 中只分配了 8 个线程（id 中 1-7 为工作线程，8 为 **`main()`** 方法的主线程，它巧妙地将其用作额外的并行流）。如果你尝试提高 **range()** 方法中的上限值，你会看到没有创建额外的线程。这是为什么？ + +我们可以查出当前机器上处理器的数量： + +```Java +// lowlevel/NumberOfProcessors.java + +public class NumberOfProcessors { + public static void main(String[] args) { + System.out.println( + Runtime.getRuntime().availableProcessors()); + } +} +/* Output: +8 +*/ +``` + +在我的机器上（使用英特尔酷睿i7），我有四个内核，每个内核呈现两个*超线程*（指一种硬件技巧，能在单个处理器上产生非常快速的上下文切换，，在某些情况下可以使内核看起来像运行两个硬件线程）。虽然这是 “最近” 计算机上的常见配置(在撰写本文时)，但你可能会看到不同的结果，包括 `CountingStream.java` 中同等数量的默认线程。 + +你的操作系统可能有办法来查出关于处理器的更多信息，例如，在Windows 10上，按下 “开始” 键，输入 “任务管理器” 和 Enter 键。点击 “详细信息” 。选择 “性能” 标签,您将会看到各种各样的关于您的硬件信息,包括“内核” 和 “逻辑处理器” 。 + +事实证明，“通用”线程的最佳数量就算是可用处理器的数量(对于特定的问题可能不是这样)。这原因来自在Java线程之间切换上下文的代价：存储被挂起线程的当前状态，并检索另一个线程的当前状态，以便从它进入挂起的位置继续执行。对于 8 个处理器和 8 个（计算密集型）Java线程，JVM 在运行这8个任务时从不需要切换上下文。对于比处理器数量少的任务，分配更多线程没有帮助。 + +定义了 “逻辑处理器” 数量的 Intel 超线程，但并没有增加计算能力 - 该特性在硬件级别维护额外的线程上下文，从而加快了上下文切换，这有助于提高用户界面的响应能力。对于计算密集型任务，请考虑将线程数量与物理内核(而不是超线程)的数量匹配。尽管Java认为每个超线程都是一个处理器，但这似乎是由于 Intel 对超线程的过度营销造成的错误。尽管如此，为了简化编程，我只允许 JVM 决定默认的线程数。 你将需要试验你的产品应用。 这并不意味着将线程数与处理器数相匹配就适用于所有问题; 相反，它主要用于计算密集型解决方案。 + +### 我可以创建多少个线程？ + +Thread（线程）对象的最大部分是用于执行方法的 Java 堆栈。查看 Thread （线程）对象的大小因操作系统而异。该程序通过创建 Thread 对象来测试它，直到 JVM 内存不足为止： + +```java +// lowlevel/ThreadSize.java +// {ExcludeFromGradle} Takes a long time or hangs +import java.util.concurrent.*; +import onjava.Nap; + +public class ThreadSize { + static class Dummy extends Thread { + @Override + public void run() { new Nap(1); } + } + public static void main(String[] args) { + ExecutorService exec = + Executors.newCachedThreadPool(); + int count = 0; + try { + while(true) { + exec.execute(new Dummy()); + count++; + } + } catch(Error e) { + System.out.println( + e.getClass().getSimpleName() + ": " + count); + System.exit(0); + } finally { + exec.shutdown(); + } + } +} +``` + +只要你不断递交任务，`CachedThreadPool` 就会继续创建线程。将 `Dummy` 对象递交到 `execute()` 方法以开始任务，如果线程池无可用线程，则分配一个新线程。执行的暂停方法 `pause()` 运行时间必须足够长，使任务不会开始即完成(从而为新任务释放现有线程)。只要任务不断进入而没有完成，`CachedThreadPool` 最终就会耗尽内存。 + +我并不总是能够在我尝试的每台机器上造成内存不足的错误。在一台机器上，我看到这样的结果: + +```shell +> java ThreadSize +OutOfMemoryError: 2816 +``` + +我们可以使用 `-Xss` 标记减少每个线程栈分配的内存大小。允许的最小线程栈大小是 64k: + +```shell +>java -Xss64K ThreadSize +OutOfMemoryError: 4952 +``` + +如果我们将线程栈大小增加到 2M ，我们就可以分配更少的线程。 + +```shell +>java -Xss2M ThreadSize +OutOfMemoryError: 722 +``` + +Windows 操作系统默认栈大小是 320K，我们可以通过验证它给出的数字与我们完全不设置栈大小时的数字是大致相同: + +```shell +>java -Xss320K ThreadSize +OutOfMemoryError: 2816 +``` + +你还可以使用 `-Xmx` 标志增加 JVM 的最大内存分配: + +```shell +>java -Xss64K -Xmx5M ThreadSize +OutOfMemoryError: 5703 +``` + +请注意的是操作系统还可能对允许的线程数施加限制。 + +因此，“我可以拥有多少线程”这一问题的答案是“几千个”。但是，如果你发现自己分配了数千个线程，那么您可能需要重新考虑您的做法; 恰当的问题是“我需要多少线程？” + +### The WorkStealingPool + +这是一个 `ExecutorService` ，它使用所有可用的(由JVM报告) 处理器自动创建线程池。 + +```java +// lowlevel/WorkStealingPool.java +import java.util.stream.*; +import java.util.concurrent.*; + +class ShowThread implements Runnable { + @Override + public void run() { + System.out.println( + Thread.currentThread().getName()); + } +} + +public class WorkStealingPool { + public static void main(String[] args) + throws InterruptedException { + System.out.println( + Runtime.getRuntime().availableProcessors()); + ExecutorService exec = + Executors.newWorkStealingPool(); + IntStream.range(0, 10) + .mapToObj(n -> new ShowThread()) + .forEach(exec::execute); + exec.awaitTermination(1, TimeUnit.SECONDS); + } +} +/* Output: +8 +ForkJoinPool-1-worker-2 +ForkJoinPool-1-worker-1 +ForkJoinPool-1-worker-2 +ForkJoinPool-1-worker-3 +ForkJoinPool-1-worker-2 +ForkJoinPool-1-worker-1 +ForkJoinPool-1-worker-3 +ForkJoinPool-1-worker-1 +ForkJoinPool-1-worker-4 +ForkJoinPool-1-worker-2 +*/ +``` + +工作窃取算法允许已经耗尽输入队列中的工作项的线程从其他队列“窃取”工作项。目标是在处理器之间分配工作项，从而最大限度地利用所有可用的处理器来完成计算密集型任务。这项算法也用于 Java 的fork/join 框架。 + ## 异常捕获 - + ## 资源共享 @@ -35,8 +211,29 @@ ## 本章小结 +本附录主要是为了让您在遇到底层并发代码时能对此有一定的了解，尽管本文还远没对这个主题进行全面的讨论。为此，你需要先从阅读由 Brian Goetz, Tim Peierls, Joshua Bloch, Joseph Bowbeer, David Holmes, and Doug Lea (Addison-Wesley 出版社, 2006)所著作的 *Java Concurrency in Practice* （国内译名：Java并发编程实战）开始了解。理想情况下，这本书会完全吓跑你在 Java 中尝试去编写底层并发代码。如果没有，那么你几乎肯定患上了达克效应(DunningKruger Effect)，这是一种认知偏差，“你知道的越少，对自己的能力就越有信心”。请记住，当前的语言设计人员仍然在清理早期语言设计人员过于自信造成的混乱(例如，查看 Thread 类中有多少方法被弃用，而 volatile 直到 Java 5 才正确工作)。 + +以下是并发编程的步骤: + +1. 不要使用它。想一些其他方法来使你写的程序变的更快。 +2. 如果你必须使用它，请使用在 [并发编程](./24-Concurrent-Programming.md) - parallel Streams and CompletableFutures 中展示的现代高级工具。 +3. 不要在任务间共享变量，必须在任务之间传递的任何信息都应该使用 Java.util.concurrent 库中的并发数据结构。 +4. 如果必须在任务之间共享变量，请使用 java.util.concurrent.atomic 里面其中一种类型，或在任何直接或间接访问这些变量的方法上应用 synchronized。 当你不这样做时，很容易被愚弄，以为你已经把所有东西都包括在内。 说真的，尝试使用步骤 3。 +5. 如果步骤 4 产生的结果太慢，你可以尝试使用volatile 或其他技术来调整代码，但是如果你正在阅读本书并认为你已经准备好尝试这些方法，那么你就超出了你的深度。 返回步骤＃1。 + +通常可以只使用 java.util.concurrent 库组件来编写并发程序，完全避免来自应用 volatile 和 synchronized 的挑战。注意，我可以通过 [并发编程](./24-Concurrent-Programming.md) 中的示例来做到这一点。 + +[^1]: 在某些平台上，特别是 Windows，默认值可能非常难以查明。您可以使用 -Xss 标志调整堆栈大小。 + +[^2]: 出自 Brian Goetz, Java Concurrency in Practice 一书的作者 , 该书由 Brian Goetz, Tim Peierls, Joshua Bloch, Joseph Bowbeer, David Holmes, and Doug Lea 联合著作 (Addison-Wesley 出版社, 2006)。↩ + +[^3]: 请注意，在64位处理器上可能不会发生这种情况，从而消除了这个问题。 + +[^4]: 这个测试的一个推论是，“如果有人暗示线程是直接的，请确保这个人没有对您的项目做出重要的决策。如果那个人已经做出，那么你就有麻烦了。” + +[^5]: 这版本是我参与的；这可能在以后的标准中得到了修正 -
+
From 1eaab3f359400921c0390aaf71c819b4601b4db3 Mon Sep 17 00:00:00 2001 From: AlfredAlan <854723360@mail.com> Date: Mon, 15 Jul 2019 01:56:33 +0800 Subject: [PATCH 12/25] =?UTF-8?q?feat:=E7=AC=AC=E4=B8=80=E8=8A=82=20?= =?UTF-8?q?=E7=BA=BF=E7=A8=8B=E9=83=A8=E5=88=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/Appendix-Low-Level-Concurrency.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/book/Appendix-Low-Level-Concurrency.md b/docs/book/Appendix-Low-Level-Concurrency.md index 47dadd8..27b51cc 100644 --- a/docs/book/Appendix-Low-Level-Concurrency.md +++ b/docs/book/Appendix-Low-Level-Concurrency.md @@ -12,7 +12,6 @@ - ## 线程 并发将程序划分成分离的，独立运行的任务。每个任务都由一个 *执行线程* 来驱动，我们通常将其简称为 *线程* 。而一个 *线程* 就是操作系统进程中单一顺序的控制流。因此，单个进程可以有多个并发执行的任务，但是你的程序使得每个任务都好像有自己的处理器一样。这线程模型为编程带来了便利，它简化了在单一程序中处理变戏法般的多任务过程。操作系统则从处理器上分配时间到您程序的所有线程中。 @@ -184,11 +183,9 @@ ForkJoinPool-1-worker-2 工作窃取算法允许已经耗尽输入队列中的工作项的线程从其他队列“窃取”工作项。目标是在处理器之间分配工作项，从而最大限度地利用所有可用的处理器来完成计算密集型任务。这项算法也用于 Java 的fork/join 框架。 - ## 异常捕获 - ## 资源共享 @@ -235,5 +232,4 @@ ForkJoinPool-1-worker-2 -
From f9a5f1c8e86432cdefe8babc9968d03a208966f9 Mon Sep 17 00:00:00 2001 From: 1326670425 <1326670425@qq.com> Date: Mon, 15 Jul 2019 11:41:30 +0800 Subject: [PATCH 13/25] =?UTF-8?q?=E6=A0=A1=E8=AE=A2=E7=AC=AC=E5=8D=81?= =?UTF-8?q?=E4=BA=8C=E7=AB=A0=20=E9=9B=86=E5=90=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/12-Collections.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/docs/book/12-Collections.md b/docs/book/12-Collections.md index 0674f47..970f9fb 100644 --- a/docs/book/12-Collections.md +++ b/docs/book/12-Collections.md @@ -137,7 +137,7 @@ Braeburn@4e25154f 因此，可以将 **Apple** 的子类型添加到被指定为保存 **Apple** 对象的集合中。 -程序的输出是从 **Object** 默认的 **toString()** 方法产生的，该方法打印类名，后边跟着对象的散列码的无符号十六进制表示（这个散列码是通过 **hashCode()** 方法产生的）。将在[附录：理解equals和hashcode方法]()中了解有关散列码的内容。 +程序的输出是从 **Object** 默认的 **toString()** 方法产生的，该方法打印类名，后边跟着对象的散列码的无符号十六进制表示（这个散列码是通过 **hashCode()** 方法产生的）。将在[附录：理解equals和hashCode方法]()中了解有关散列码的内容。 ## 基本概念 @@ -1789,13 +1789,18 @@ Serializable] 尽管存在这些问题，但Java集合仍是在日常工作中使用的基本工具，它可以使程序更简洁、更强大、更有效。你可能需要一段时间才能熟悉集合类库的某些方面，但我想你很快就会找到自己的路子，来获得和使用这个类库中的类。 -[^1]: 许多语言，例如Perl，Python和Ruby，都有 -集合的本地支持。 +[^1]: 许多语言，例如Perl，Python和Ruby，都有集合的本地支持。 + [^2]: 这里是操作符重载的用武之地，C++和C#的集合类都使用操作符重载生成了更简洁的语法。 + [^3]: 在[泛型]()章节的末尾，有个关于这个问题是否很严重的讨论。但是，[泛型]()章节还将展示Java泛型远不止是类型安全的集合这么简单。 + [^4]: **remove()** 是一个所谓的“可选”方法（还有一些其它的这种方法），这意味着并非所有的 **Iterator** 实现都必须实现该方法。这个问题将在[附录：集合主题]()中介绍。但是，标准Java库集合实现了 **remove()** ，因此在[附录：集合主题]()章节之前，都不必担心这个问题。 + [^5]: 这实际上依赖于具体实现。优先级队列算法通常会按插入顺序排序（维护一个*堆*），但它们也可以在删除时选择最重要的元素。 如果对象的优先级在它在队列中等待时可以修改，那么算法的选择就显得很重要了。 + [^6]: 有些人提倡这样一种自动创建机制，即对一个类中所有可能的方法组合都自动创建一个接口，有时候对于单个的类都是如此。 我相信接口的意义不应该仅限于方法组合的机械地复制，因此我在创建接口之前，总是要先看到增加接口带来的价值。 + [^7]: 这在Java SE5之前是不可用的，因为该方法被认为与操作系统的耦合度过紧，因此违反“一次编写，处处运行”的原则。现在提供它这一事实表明，Java的设计者们更加务实了。 From 093606db174cdd6a1dcb794d3ec099cce799340a Mon Sep 17 00:00:00 2001 From: 1326670425 <1326670425@qq.com> Date: Mon, 15 Jul 2019 11:41:56 +0800 Subject: [PATCH 14/25] =?UTF-8?q?=E9=99=84=E5=BD=95=EF=BC=9AC++=E5=92=8CJa?= =?UTF-8?q?va=E7=9A=84=E4=BC=98=E8=89=AF=E4=BC=A0=E7=BB=9F=20=E7=BF=BB?= =?UTF-8?q?=E8=AF=91=E5=AE=8C=E6=88=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...Positive-Legacy-of-C-plus-plus-and-Java.md | 25 ++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/docs/book/Appendix-The-Positive-Legacy-of-C-plus-plus-and-Java.md b/docs/book/Appendix-The-Positive-Legacy-of-C-plus-plus-and-Java.md index fb26815..449e4a1 100644 --- a/docs/book/Appendix-The-Positive-Legacy-of-C-plus-plus-and-Java.md +++ b/docs/book/Appendix-The-Positive-Legacy-of-C-plus-plus-and-Java.md @@ -3,6 +3,29 @@ # 附录:C++和Java的优良传统 +> 在各种讨论声中，有一些人认为C++是一种设计糟糕的语言。 我认为理解C++和Java语言的选择有助于了解更大的视角。 + +也就是说，我几乎不再使用C++了。当我使用它的时候，要么是用来检查遗留代码，要么是编写性能关键（performance-critical）部分，程序通常尽可能小，以便用其他语言编写的其他程序来调用。 + +因为我在最初的8年里一直在C++标准委员会工作，所以我见证了那些被做出的决定。它们都经过了极其谨慎的考虑，远远超过了许多在Java中做出的决定。 + +然而，正如人们正确地指出的那样，由此产生的语言使用起来既复杂又痛苦，而且只要我一段时间不使用它，我就会忘记那些古怪的规则。在我写书的时候，我是从第一原理（first principles）处了解这些规则的，而不是记住了它们。 + +为了理解C++语言为何既令人不愉快且复杂，同时又是精心设计的，必须要牢记C++中所有内容的主要设计决策：与C. Bjarne Stroustrup（该语言的创造者，即“C++之父”）的兼容性决定。这样的设计似乎是为了可以让大量的C程序员透明地转移到对象（代指C++）上：允许他们在C++下编译他们的C代码。这是一个巨大的限制，一直是C++最大的优势......而且也是它的祸根。这就是使得C++成功的原因，也是使它复杂的原因。 + +它也欺骗了那些不太了解C++的Java设计师。例如，他们认为运算符重载对于程序员来说很难正确使用。这在C++中基本上是正确的，因为C++既有栈分配又有堆分配，你必须重载运算符来处理所有情况而且不要造成内存泄漏。这确实很困难。然而，Java有单一的内存分配机制和一个垃圾收集器，这使得运算符重载变得微不足道，正如C＃中那样（但在早于Java的Python中已经可以看到）。但多年来，来自Java团队的一贯态度是“运算符重载太复杂了”。这里还有许多决策，所做的事明显不应该是他们做的。正是由于这些原因，让我有了蔑视Gosling（即“Java之父”）和Java团队决策的名声。（Java 7和8由于某种原因包含了更好的决策。但是向后兼容性这个约束总是会阻碍真正的改进。语言永远不会是它本来的样子。） + +还有很多其他的例子。“为了提高效率，必须包含基本类型”；坚持“万物皆对象”是正确的；当对性能有要求的时候，提供一个陷阱门（trap door）来做低级别的活动（lower-level activities）（这里也可以使用hotspot技术透明地提高性能，正如他们最终做的那样）；不能直接使用浮点处理器去计算超越函数，它用软件来完成。我已经尽可能多地提出了这样的问题，但我得到的却一直是类似“这是Java方式”这样的回复。 + +当我提出关于泛型的设计有多糟糕的时候，我得到了相同的回复，以及“我们必须向后兼容那样以前用Java做出的决策”（即使它们是糟糕的决策）。最近越来越多的人已经获得了足够的泛型经验，可以发现泛型真的很难用。事实上，C++模板更强大、更一致（现在更容易使用，因为编译器的错误消息是可以容忍的）。人们一直在认真对待物化（reification），这可能是有用的东西，但是在那种被严格约束所削弱的设计中并没有多大影响。 + +这样的例子还有很多很多。这是否意味着Java失败了？绝对不。Java将程序员的主流带入了垃圾收集、虚拟机和一致的错误处理模型的世界。由于它的所有缺陷，它将我们提升到了一个水平，现在我们已经准备好使用更高级别的语言了。 + +有一点，C++是领先的语言，人们认为它总是如此。许多人对Java有同样的看法，但由于JVM，Java使得取代自己变得更加容易。现在有可能会有人创建一种新语言，并使其在短时间内像Java一样高效运行。以前，为新语言开发一个正确有效的编译器需要花费大部分开发时间。 + +这种情况已经发生了，包括像Scala这样的高级静态语言，以及动态语言，新的且可移植的，如Groovy，Clojure，JRuby和Jython。这是未来，并且过渡很顺畅，因为可以很轻易地将这些新语言与现有Java代码结合使用，并且必要时可以重写那些在Java中的瓶颈。 + +在撰写本文时，Java是世界上的头号编程语言。然而，Java最终将会减弱，就像C++一样，沦只在特殊情况下使用（或者只是用来支持传统的代码，因为它不能像C++那样和硬件连接）。但是无意中的好处，也是Java真正意外的光彩之处在于它为自己的替代品创造了一条非常畅通的道路，即使Java本身已经达到了无法再发展的程度。未来所有的语言都应该从中学习：要么创建一个可以重构的文化（像Python和Ruby做的那样），要么就让竞争者茁壮成长。 +
- From e2efb8e7b3a67d7ddff7bfeeee17948dd8310e09 Mon Sep 17 00:00:00 2001 From: 1326670425 <1326670425@qq.com> Date: Mon, 15 Jul 2019 11:42:04 +0800 Subject: [PATCH 15/25] Update README.md --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 0e7fc04..03dadda 100644 --- a/README.md +++ b/README.md @@ -58,6 +58,7 @@ - [x] [附录:数据压缩](docs/book/Appendix-Data-Compression.md) - [ ] [附录:对象序列化](docs/book/Appendix-Object-Serialization.md) - [ ] [附录:静态语言类型检查](docs/book/Appendix-Benefits-and-Costs-of-Static-Type-Checking.md) +- [x] [附录:C++和Java的优良传统](docs/book/Appendix-The-Positive-Legacy-of-C-plus-plus-and-Java.md) - [ ] [附录:成为一名程序员](docs/book/Appendix-Becoming-a-Programmer.md) From c961a9452cb986e88f5468edaca57db07531d32f Mon Sep 17 00:00:00 2001 From: xiangflight Date: Mon, 15 Jul 2019 19:29:22 +0800 Subject: [PATCH 16/25] =?UTF-8?q?[revision=2011](=E6=88=AA=E8=87=B3=20?= =?UTF-8?q?=E5=86=85=E9=83=A8=E7=B1=BB=E6=96=B9=E6=B3=95=E5=92=8C=E4=BD=9C?= =?UTF-8?q?=E7=94=A8=E5=9F=9F)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/11-Inner-Classes.md | 61 ++++++++++++++++++++++------------- 1 file changed, 39 insertions(+), 22 deletions(-) diff --git a/docs/book/11-Inner-Classes.md b/docs/book/11-Inner-Classes.md index c31b371..ec89bb8 100644 --- a/docs/book/11-Inner-Classes.md +++ b/docs/book/11-Inner-Classes.md @@ -4,9 +4,9 @@ # 第十一章 内部类 -> 一个类的定义在另一个类的定义内部，这就是内部类。 +> 一个定义在另一个类中的类，叫作内部类。 -内部类是一种非常有用的特性，因为它允许你把一些逻辑相关的类组织在一起，并控制位于内部的类的可视性。然而必须要了解，内部类与组合是完全不同的概念，这一点很重要。在最初，内部类看起来就像是一种代码隐藏机制：将类置于其他类的内部。但是，你将会了解到，内部类远不止如此，它了解外围类，并能与之通信，而且你用内部类写出的代码更加优雅而清晰，尽管并不总是这样。 +内部类是一种非常有用的特性，因为它允许你把一些逻辑相关的类组织在一起，并控制位于内部的类的可见性。然而必须要了解，内部类与组合是完全不同的概念，这一点很重要。在最初，内部类看起来就像是一种代码隐藏机制：将类置于其他类的内部。但是，你将会了解到，内部类远不止如此，它了解外围类，并能与之通信，而且你用内部类写出的代码更加优雅而清晰，尽管并不总是这样（而且 Java 8 的 Lambda 表达式和方法引用减少了编写内部类的需求）。 最初，内部类可能看起来有些奇怪，而且要花些时间才能在设计中轻松地使用它们。对内部类的需求并非总是很明显的，但是在描述完内部类的基本语法与语义之后，"Why inner classes?"就应该使得内部类的益处明确显现了。 @@ -24,13 +24,17 @@ public class Parcel1 { class Contents { private int i = 11; + public int value() { return i; } } + class Destination { private String label; + Destination(String whereTo) { label = whereTo; } + String readLabel() { return label; } } // Using inner classes looks just like @@ -40,6 +44,7 @@ public class Parcel1 { Destination d = new Destination(dest); System.out.println(d.readLabel()); } + public static void main(String[] args) { Parcel1 p = new Parcel1(); p.ship("Tasmania"); @@ -53,9 +58,9 @@ public class Parcel1 { Tasmania ``` -当我们在 ship() 方法里面使用内部类的时候，与使用普通类没什么不同。在这里，实际的区别只是内部类的名字是嵌套在 Parcel1 里面的。 +当我们在 `ship()` 方法里面使用内部类的时候，与使用普通类没什么不同。在这里，明显的区别只是内部类的名字是嵌套在 **Parcel1** 里面的。 -更典型的情况是，外部类将有一个方法，该方法返回一个指向内部类的引用，就像在 to() 和 contents() 方法中看到的那样： +更典型的情况是，外部类将有一个方法，该方法返回一个指向内部类的引用，就像在 `to()` 和 `contents()` 方法中看到的那样： ```java // innerclasses/Parcel2.java @@ -63,31 +68,39 @@ Tasmania public class Parcel2 { class Contents { private int i = 11; + public int value() { return i; } } + class Destination { private String label; + Destination(String whereTo) { label = whereTo; } + String readLabel() { return label; } } + public Destination to(String s) { return new Destination(s); } + public Contents contents() { return new Contents(); } + public void ship(String dest) { Contents c = contents(); Destination d = to(dest); System.out.println(d.readLabel()); } + public static void main(String[] args) { Parcel2 p = new Parcel2(); p.ship("Tasmania"); Parcel2 q = new Parcel2(); -// Defining references to inner classes: + // Defining references to inner classes: Parcel2.Contents c = q.contents(); Parcel2.Destination d = q.to("Borneo"); } @@ -100,7 +113,7 @@ public class Parcel2 { Tasmania ``` -如果想从外部类的非静态方法之外的任意位置创建某个内部类的对象，那么必须像在 main() 方法中那样，具体地指明这个对象的类型：OuterClassName.InnerClassName。 +如果想从外部类的非静态方法之外的任意位置创建某个内部类的对象，那么必须像在 `main()` 方法中那样，具体地指明这个对象的类型：*OuterClassName.InnerClassName*。(译者注：在外部类的静态方法中也可以直接指明类型 *InnerClassName*，在其他类中需要指明 *OuterClassName.InnerClassName*。) @@ -157,30 +170,33 @@ public class Sequence { 0 1 2 3 4 5 6 7 8 9 ``` -Sequence 类只是一个固定大小的 Object 的数组，以类的形式包装了起来。可以调用 add）在序列末增加新的 Object（只要还有空间），要获取 Sequence 中的每一个对象，可以使用 Selector 接口。这是“迭代器”设计模式的一个例子，在本书稍后的部分将更多地学习它。Selector 允许你检查序列是否到末尾了（end()），访问当前对象（current()），以及移到序列中的下一个对象（next()），因为 Selector 是一个接口，所以别的类可以按它们自己的方式来实现这个接口，并且另的方法能以此接口为参数，来生成更加通用的代码。 +**Sequence** 类只是一个固定大小的 **Object** 的数组，以类的形式包装了起来。可以调用 `add()` 在序列末尾增加新的 **Object**（只要还有空间），要获取 **Sequence** 中的每一个对象，可以使用 **Selector** 接口。这是“迭代器”设计模式的一个例子，在本书稍后的部分将更多地学习它。**Selector** 允许你检查序列是否到末尾了（`end()`），访问当前对象（`current()`），以及移到序列中的下一个对象（`next()`）。因为 **Selector** 是一个接口，所以别的类可以按它们自己的方式来实现这个接口，并且其他方法能以此接口为参数，来生成更加通用的代码。 -这里，SequenceSelector 是提供 Selector 功能的 private 类。可以看到，在 main() 中创建了一个 Sequence，并向其中添加了一些 String 对象。然后通过调用 selector() 获取一个 Selector，并用它在 Sequence 中移动和选择每一个元素。 -最初看到 SequenceSelector，可能会觉得它只不过是另一个内部类罢了。但请仔细观察它，注意方法 end()，current() 和 next() 都用到了 items，这是一个引用，它并不是 SequenceSelector 的一部分，而是外围类中的一个 private 字段。然而内部类可以访问其外围类的方法和字段，就像自己拥有它们似的，这带来了很大的方便，就如前面的例子所示。 +这里，**SequenceSelector** 是提供 **Selector** 功能的 **private** 类。可以看到，在 `main()` 中创建了一个 **Sequence**，并向其中添加了一些 **String** 对象。然后通过调用 `selector()` 获取一个 **Selector**，并用它在 **Sequence** 中移动和选择每一个元素。 +最初看到 **SequenceSelector**，可能会觉得它只不过是另一个内部类罢了。但请仔细观察它，注意方法 `end()`，`current()` 和 `next()` 都用到了 **items**，这是一个引用，它并不是 **SequenceSelector** 的一部分，而是外围类中的一个 **private** 字段。然而内部类可以访问其外围类的方法和字段，就像自己拥有它们似的，这带来了很大的方便，就如前面的例子所示。 -所以内部类自动拥有对其外围类所有成员的访问权。这是如何做到的呢？当某个外围类的对象创建了一个内部类对象时，此内部类对象必定会秘密地捕获一个指向那个外围类对象的引用。然后，在你访问此外围类的成员时，就是用那个引用来选择外围类的成员。幸运的是，编译器会帮你处理所有的细节，但你现在可以看到：内部类的对象只能在与其外围类的对象相关联的情况下才能被创建（就像你应该看到的，在内部类是非 static 类时）。构建内部类对象时，需要一个指向其外围类对象的引用，如果编译器访问不到这个引用就会报错。不过绝大多数时候这都无需程序员操心。 +所以内部类自动拥有对其外围类所有成员的访问权。这是如何做到的呢？当某个外围类的对象创建了一个内部类对象时，此内部类对象必定会秘密地捕获一个指向那个外围类对象的引用。然后，在你访问此外围类的成员时，就是用那个引用来选择外围类的成员。幸运的是，编译器会帮你处理所有的细节，但你现在可以看到：内部类的对象只能在与其外围类的对象相关联的情况下才能被创建（就像你应该看到的，内部类是非 **static** 类时）。构建内部类对象时，需要一个指向其外围类对象的引用，如果编译器访问不到这个引用就会报错。不过绝大多数时候这都无需程序员操心。 ## 使用 .this 和 .new -如果你需要生成对外部类对象的引用，可以使用外部类的名字后面紧跟圆点和 this。这样产生的引用自动地具有正确的类型，这一点在编译期就被知晓并受到检查，因此没有任何运行时开销。下面的示例展示了如何使用.this： +如果你需要生成对外部类对象的引用，可以使用外部类的名字后面紧跟圆点和 **this**。这样产生的引用自动地具有正确的类型，这一点在编译期就被知晓并受到检查，因此没有任何运行时开销。下面的示例展示了如何使用 **.this**： ```java // innerclasses/DotThis.java // Accessing the outer-class object public class DotThis { void f() { System.out.println("DotThis.f()"); } + public class Inner { public DotThis outer() { return DotThis.this; // A plain "this" would be Inner's "this" } } + public Inner inner() { return new Inner(); } + public static void main(String[] args) { DotThis dt = new DotThis(); DotThis.Inner dti = dt.inner(); @@ -195,7 +211,7 @@ public class DotThis { DotThis.f() ``` -有时你可能想要告知某些其他对象，去创建其某个内部类的对象。要实现此目的，你必须在 mew 表达式中提供对其他外部类对象的引用，这是需要使用.new 语法，就像下面这样： +有时你可能想要告知某些其他对象，去创建其某个内部类的对象。要实现此目的，你必须在 **new** 表达式中提供对其他外部类对象的引用，这是需要使用 **.new** 语法，就像下面这样： ```java // innerclasses/DotNew.java @@ -209,9 +225,9 @@ public class DotNew { } ``` -要想直接创建内部类的对象，你不能按照你想象的方式，去引用外部类的名字 DotNew，而是必须使用外部类的对象来创建该内部类对象，就像在上面的程序中所看到的那样。这也解决了内部类名字作用域的问题，因此你不必声明（实际上你不能声明）dn.new DotNew.Innero。 +要想直接创建内部类的对象，你不能按照你想象的方式，去引用外部类的名字 **DotNew**，而是必须使用外部类的对象来创建该内部类对象，就像在上面的程序中所看到的那样。这也解决了内部类名字作用域的问题，因此你不必声明（实际上你不能声明）dn.new DotNew.Innero。 -下面你可以看到将.new 应用于 Parcel 的示例： +下面你可以看到将 **.new** 应用于 Parcel 的示例： ```java // innerclasses/Parcel3.java @@ -228,8 +244,8 @@ public class Parcel3 { } public static void main(String[] args) { Parcel3 p = new Parcel3(); -// Must use instance of outer class -// to create an instance of the inner class: + // Must use instance of outer class + // to create an instance of the inner class: Parcel3.Contents c = p.new Contents(); Parcel3.Destination d = p.new Destination("Tasmania"); @@ -240,6 +256,7 @@ public class Parcel3 { 在拥有外部类对象之前是不可能创建内部类对象的。这是因为内部类对象会暗暗地连接到建它的外部类对象上。但是，如果你创建的是嵌套类（静态内部类），那么它就不需要对外部类对象的引用。 + ## 内部类与向上转型 当将内部类向上转型为其基类，尤其是转型为一个接口的时候，内部类就有了用武之地。（从实现了某个接口的对象，得到对此接口的引用，与向上转型为这个对象的基类，实质上效果是一样的。）这是因为此内部类-某个接口的实现-能够完全不可见，并且不可用。所得到的只是指向基类或接口的引用，所以能够很方便地隐藏实现细节。 @@ -260,7 +277,7 @@ public interface Contents { } ``` -现在 Contents 和 Destination 表示客户端程序员可用的接口。记住，接口的所有成员自动被设置为 public 的。 +现在 **Contents** 和 **Destination** 表示客户端程序员可用的接口。记住，接口的所有成员自动被设置为 **public**。 当取得了一个指向基类或接口的引用时，甚至可能无法找出它确切的类型，看下面的例子： @@ -292,17 +309,17 @@ public class TestParcel { Parcel4 p = new Parcel4(); Contents c = p.contents(); Destination d = p.destination("Tasmania"); -// Illegal -- can't access private class: -//- Parcel4.PContents pc = p.new PContents(); + // Illegal -- can't access private class: + //- Parcel4.PContents pc = p.new PContents(); } } ``` -在 Parcel4 中，内部类 PContents 是 private，所以除了 Parcel4，没有人能访问它。普通（非内部）类的访问权限不能被设为 private 或者 protected；他们只能设置为 public 或 package 访问权限。 +在 **Parcel4** 中，内部类 **PContents** 是 **private**，所以除了 **Parcel4**，没有人能访问它。普通（非内部）类的访问权限不能被设为 **private** 或者 **protected**；他们只能设置为 **public** 或 **package** 访问权限。 -PDestination 是 protected，所以只有 Parcel4 及其子类、还有与 Parcel4 同一个包中的类（因为 protected 也给予了包访问权）能访问 PDestination，其他类都不能访问 PDestination，这意味着，如果客户端程序员想了解或访问这些成员，那是要受到限制的。实际上，甚至不能向下转型成 private 内部类（或 protected 内部类，除非是继承自它的子类），因为不能访问其名字，就像在 TestParcel 类中看到的那样。 +**PDestination** 是 **protected**，所以只有 **Parcel4** 及其子类、还有与 **Parcel4** 同一个包中的类（因为 **protected** 也给予了包访问权）能访问 **PDestination**，其他类都不能访问 **PDestination**，这意味着，如果客户端程序员想了解或访问这些成员，那是要受到限制的。实际上，甚至不能向下转型成 **private** 内部类（或 **protected** 内部类，除非是继承自它的子类），因为不能访问其名字，就像在 **TestParcel** 类中看到的那样。 -private 内部类给类的设计者提供了一种途径，通过这种方式可以完全阻止任何依赖于类型的编码，并且完全隐藏了实现的细节。此外，从客户端程序员的角度来看，由于不能访问任何新增加的、原本不属于公共接口的方法，所以扩展接口是没值的。这也给 Java 编译器 +**private** 内部类给类的设计者提供了一种途径，通过这种方式可以完全阻止任何依赖于类型的编码，并且完全隐藏了实现的细节。此外，从客户端程序员的角度来看，由于不能访问任何新增加的、原本不属于公共接口的方法，所以扩展接口是没有价值的。这也给 Java 编译器提供了生成高效代码的机会。 From 5c8981e2830f6f7afe71949544cc3a9fcf9ea3ca Mon Sep 17 00:00:00 2001 From: 1326670425 <1326670425@qq.com> Date: Tue, 16 Jul 2019 10:23:52 +0800 Subject: [PATCH 17/25] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=20=E7=AC=AC=E5=8D=81?= =?UTF-8?q?=E4=BA=8C=E7=AB=A0=20=E9=9B=86=E5=90=88=E9=85=8D=E5=9B=BE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/images/simple-collection-taxonomy.png | Bin 0 -> 168908 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/images/simple-collection-taxonomy.png diff --git a/docs/images/simple-collection-taxonomy.png b/docs/images/simple-collection-taxonomy.png new file mode 100644 index 0000000000000000000000000000000000000000..8b7b6cdd69c02e9d5a8322e68f43732dc07c9a0a GIT binary patch literal 168908 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¯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 z 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 Date: Tue, 16 Jul 2019 10:24:07 +0800 Subject: [PATCH 18/25] =?UTF-8?q?=E9=99=84=E5=BD=95=EF=BC=9A=E8=A1=A5?= =?UTF-8?q?=E5=85=85=20=E7=BF=BB=E8=AF=91=E5=AE=8C=E6=88=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/Appendix-Supplements.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/book/Appendix-Supplements.md b/docs/book/Appendix-Supplements.md index e5cc791..af505e6 100644 --- a/docs/book/Appendix-Supplements.md +++ b/docs/book/Appendix-Supplements.md @@ -3,18 +3,24 @@ # 附录:补充 +> 本书有许多补充内容，包括MindView网站提供的项目和服务。 + +本附录介绍了这些补充内容，你可以自行决定它们是否对你有所帮助。 ## 可下载的补充 +可以从 [https://github.com/BruceEckel/OnJava8-examples](https://github.com/BruceEckel/OnJava8-examples) 免费下载本书的代码。这里包括Gradle构建文件和其它一些必要的支持文件，以便成功构建和执行本书中所有的示例代码。 ## 通过Thinking-in-C来巩固Java基础 +在 [www.OnJava8.com](www.OnJava8.com) 上，可以免费下载*Thinking in C*的演示文稿。 此演示文稿由Chuck Allison创建，由MindView有限责任公司开发。这是一个电子演示文稿，介绍了Java语法所基于的C语法，运算符和函数。 -## 动手实践 +## Hand-On Java 电子演示文稿 +*Hand-On Java 电子演示文稿*（Hands-On Java eSeminar）是基于*Thinking in Java*第2版。对应于该书中的每一章，它附带有一个音频讲解和相应的幻灯片。我创建了这个电子演示文稿，并讲述了这些材料。这个资料是HTML5格式的，所以它应该可以在大多数现代浏览器上运行。该演示文稿将在[www.OnJava8.com](www.OnJava8.com)上发售，你可以在该网站上找到该产品的试用版演示。
\ No newline at end of file From cfbd6084589cc455fcd57f95fdd48f985cf37a04 Mon Sep 17 00:00:00 2001 From: 1326670425 <1326670425@qq.com> Date: Tue, 16 Jul 2019 10:28:14 +0800 Subject: [PATCH 19/25] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 03dadda..eb59c5e 100644 --- a/README.md +++ b/README.md @@ -45,7 +45,7 @@ - [x] [第二十三章 注解](docs/book/23-Annotations.md) - [ ] [第二十四章 并发编程](docs/book/24-Concurrent-Programming.md) - [ ] [第二十五章 设计模式](docs/book/25-Patterns.md) -- [ ] [附录:补充](docs/book/Appendix-Supplements.md) +- [x] [附录:补充](docs/book/Appendix-Supplements.md) - [ ] [附录:编程指南](docs/book/Appendix-Programming-Guidelines.md) - [ ] [附录:文档注释](docs/book/Appendix-Javadoc.md) - [ ] [附录:对象传递和返回](docs/book/Appendix-Passing-and-Returning-Objects.md) From 312dc55f0457ce87dc5b746f17cf9d61dc16e5b8 Mon Sep 17 00:00:00 2001 From: zhili Date: Tue, 16 Jul 2019 13:17:17 +0800 Subject: [PATCH 20/25] Update 01-What-is-an-Object.md remove character /u10 --- docs/book/01-What-is-an-Object.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/book/01-What-is-an-Object.md b/docs/book/01-What-is-an-Object.md index b7d5511..61a5a55 100644 --- a/docs/book/01-What-is-an-Object.md +++ b/docs/book/01-What-is-an-Object.md @@ -202,7 +202,7 @@ void doSomething(Shape shape) { ```java doSomething(circle); ``` -当预期接收 **Shape** 的方法被传入了 **Circle**，会发生什么。由于 **Circle** 也是一种 **Shape**，所 +当预期接收 **Shape** 的方法被传入了 **Circle**，会发生什么。由于 **Circle** 也是一种 **Shape**，所 以 `doSomething(circle)` 能正确地执行。也就是说，`doSomething()` 能接收任意发送给 **Shape** 的消息。这是完全安全和合乎逻辑的事情。 这种把子类当成其基类来处理的过程叫做“向上转型”（**upcasting**）。在面向对象的编程里，经常利用这种方法来给程序解耦。再看下面的 `doSomething()` 代码示例： From 6800ecebfb3b59a2e924afd48e64c3fa4bfef439 Mon Sep 17 00:00:00 2001 From: notUlnix <52882401+notUlnix@users.noreply.github.com> Date: Tue, 16 Jul 2019 13:25:11 +0800 Subject: [PATCH 21/25] update the translation of "derived class" --- docs/book/11-Inner-Classes.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/book/11-Inner-Classes.md b/docs/book/11-Inner-Classes.md index ec89bb8..37cf2f0 100644 --- a/docs/book/11-Inner-Classes.md +++ b/docs/book/11-Inner-Classes.md @@ -472,7 +472,7 @@ public class Parcel8 { - \[1\] 将合适的参数传递给基类的构造器。 - \[2\] 在匿名内部类末尾的分号，并不是用来标记此内部类结束的。实际上，它标记的是表达式的结束，只不过这个表达式正巧包含了匿名内部类罢了。因此，这与别的地方使用的分号是一致的。 -尽管 Wrapping 只是一个具有具体实现的普通类，但它还是被共导出类当作公共“接口”来使用。 +尽管 Wrapping 只是一个具有具体实现的普通类，但它还是被派生类当作公共“接口”来使用。 ```java // innerclasses/Wrapping.java @@ -917,7 +917,7 @@ public abstract class Event { 当希望运行 Event 并随后调用 start() 时，那么构造器就会捕获（从对象创建的时刻开始的）时间，此时间是这样得来的：start() 获取当前时间，然后加上一个延迟时间，这样生成触发事件的时间。start() 是一个独立的方法，而没有包含在构造器内，因为这样就可以在事件运行以后重新启动计时器，也就是能够重复使用 Event 对象。例如，如果想要重复一个事件，只需简单地在 action() 中调用 start() 方法。 -ready() 告诉你何时可以运行 action() 方法了。当然，可以在导出类中覆盖 ready() 方法，使得 Event 能够基于时间以外的其他因素而触发。 +ready() 告诉你何时可以运行 action() 方法了。当然，可以在派生类中覆盖 ready() 方法，使得 Event 能够基于时间以外的其他因素而触发。 下面的文件包含了一个用来管理并触发事件的实际控制框架。Event 对象被保存在 List\ 类型（读作“Event 的列表”）的容器对象中，容器会在 [集合 ]() 中详细介绍。目前读者只需要知道 add() 方法用来将一个 Object 添加到 List 的尾端，size() 方法用来得到 List 中元素的个数，foreach 语法用来连续获联 List 中的 Event，remove() 方法用来从 List 中移除指定的 Event。 @@ -1180,7 +1180,7 @@ Terminating ## 继承内部类 -因为内部类的构造器必须连接到指向其外围类对象的引用，所以在继承内部类的时候，事情会变得有点复杂。问题在干，那个指向外围类对象的“秘密的”引用必须被初始化，而在导出类中不再存在可连接的默认对象。要解决这个问题，必须使用特殊的语法来明确说清它们之间的关联： +因为内部类的构造器必须连接到指向其外围类对象的引用，所以在继承内部类的时候，事情会变得有点复杂。问题在干，那个指向外围类对象的“秘密的”引用必须被初始化，而在派生类中不再存在可连接的默认对象。要解决这个问题，必须使用特殊的语法来明确说清它们之间的关联： ```java // innerclasses/InheritInner.java @@ -1410,4 +1410,4 @@ LocalInnerClass.class -
\ No newline at end of file +
From 7790b0aa62bbeae5c1387328e8479191b855fefa Mon Sep 17 00:00:00 2001 From: notUlnix <52882401+notUlnix@users.noreply.github.com> Date: Tue, 16 Jul 2019 15:42:13 +0800 Subject: [PATCH 22/25] Translation Commit Part translation of Appendix-Understanding-equals-and-hashCode.md --- ...endix-Understanding-equals-and-hashCode.md | 388 +++++++++++++++++- 1 file changed, 386 insertions(+), 2 deletions(-) diff --git a/docs/book/Appendix-Understanding-equals-and-hashCode.md b/docs/book/Appendix-Understanding-equals-and-hashCode.md index 1dafbdc..e2bd8c3 100644 --- a/docs/book/Appendix-Understanding-equals-and-hashCode.md +++ b/docs/book/Appendix-Understanding-equals-and-hashCode.md @@ -1,11 +1,395 @@ [TOC] + + # 附录:理解equals和hashCode方法 +假设有一个容器使用hash函数，当你创建一个放到这个容器时，你必须定义 **hashCode()** 函数和 **equals()** 函数。这两个函数一起被用于hash容器中的查询操作。 -## equals典范 +## equals规范 +当你创建一个类的时候，它自动继承自 **Objcet** 类。如果你不覆写 **equals()** ，你将会获得 **Objcet** 对象的 **equals()** 函数。默认情况下，这个函数会比较对象的地址。所以只有你在比较同一个对象的时候，你才会获得**true**。默认的情况是"区分度最高的"。 + +```java +// equalshashcode/DefaultComparison.java +class DefaultComparison { + private int i, j, k; + DefaultComparison(int i, int j, int k) { + this.i = i; + this.j = j; + this.k = k; + } + + public static void main(String[] args) { + DefaultComparison + a = new DefaultComparison(1, 2, 3), + b = new DefaultComparison(1, 2, 3); + System.out.println(a == a); + System.out.println(a == b); + } +} +/* +Output: +true +false +*/ + +``` +通常你会希望放宽这个限制。一般来说如果两个对象有相同的类型和相同的字段，你会认为这两个对象相等，但也会有一些你不想加入 **equals()** 函数中来比较的字段。这是类型设计的一部分。 + +一个合适的 **equals()**函数必须满足以下五点条件： +1. 反身性：对于任何 **x**， **x.equals(x)** 应该返回 **true**。 +2. 对称性：对于任何 **x** 和 **y**， **x.equals(y)** 应该返回 **true**当且仅当 **y.equals(x)** 返回 **true** 。 +3. 传递性：对于任何**x**,**y**,还有**z**，如果 **x.equals(y)** 返回 **true** 并且 **y.equals(z)** 返回 **true**，那么 **x.equals(z)** 应该返回 **true**。 +4. 一致性：对于任何 **x**和**y**，在对象没有被改变的情况下，多次调用 **x.equals(y)** 应该总是返回 **true** 或者**false**。 +5. 对于任何非**null**的**x**，**x.equals(null)**应该返回**false**。 + +下面是满足这些条件的测试，并且判断对象是否和自己相等（我们这里称呼其为**右值**）： +1. 如果**右值**是**null**，那么不相等。 +2. 如果**右值**是**this**，那么两个对象相等。 +3. 如果**右值**不是同一个类型或者子类，那么两个对象不相等。 +4. 如果所有上面的检查通过了，那么你必须决定 **右值** 中的哪些字段是重要的，然后比较这些字段。 +Java 7 引入了 **Objects** 类型来帮助这个流程，这样我们能够写出更好的 **equals()** 函数。 + +下面的例子比较了不同类型的 **Equality**类。为了避免重复的代码，我们使用*工厂函数设计模*式来实现样例。 **EqualityFactory**接口提供**make()**函数来生成一个**Equaity**对象，这样不同的**EqualityFactory**能够生成**Equality**不同的子类。 + +```java +// equalshashcode/EqualityFactory.java +import java.util.*; +interface EqualityFactory { + Equality make(int i, String s, double d); +} +``` +现在我们来定义 **Equality**，它包含三个字段（所有的字段我们认为在比较中都很重要）和一个 **equals()** 函数用来满足上述的四种检查。构造函数展示了它的类名来保证我们在执行我们想要的测试： + +```java +// equalshashcode/Equality.java +import java.util.*; +public class Equality { + protected int i; + protected String s; + protected double d;public Equality(int i, String s, double d) { + this.i = i; + this.s = s; + this.d = d; + System.out.println("made 'Equality'"); + } + + @Override + public boolean equals(Object rval) { + if(rval == null) + return false; + if(rval == this) + return true; + if(!(rval instanceof Equality)) + return false; + Equality other = (Equality)rval; + if(!Objects.equals(i, other.i)) + return false; + if(!Objects.equals(s, other.s)) + return false; + if(!Objects.equals(d, other.d))return false; + return true; + } + + public void test(String descr, String expected, Object rval) { + System.out.format("-- Testing %s --%n" + "%s instanceof Equality: %s%n" + + "Expected %s, got %s%n", + descr, descr, rval instanceof Equality, + expected, equals(rval)); + } + + public static void testAll(EqualityFactory eqf) { + Equality + e = eqf.make(1, "Monty", 3.14), + eq = eqf.make(1, "Monty", 3.14), + neq = eqf.make(99, "Bob", 1.618); + e.test("null", "false", null); + e.test("same object", "true", e); + e.test("different type", + "false", Integer.valueOf(99));e.test("same values", "true", eq); + e.test("different values", "false", neq); + } + + public static void main(String[] args) { + testAll( (i, s, d) -> new Equality(i, s, d)); + } + +} +/* +Output: +made 'Equality' +made 'Equality' +made 'Equality' +-- Testing null -- +null instanceof Equality: false +Expected false, got false +-- Testing same object -- +same object instanceof Equality: true +Expected true, got true +-- Testing different type -- +different type instanceof Equality: false +Expected false, got false-- Testing same values -- +same values instanceof Equality: true +Expected true, got true +-- Testing different values -- +different values instanceof Equality: true +Expected false, got false +*/ +``` + + **testAll()** 执行了我们期望的所有不同类型对象的比较。它使用工厂创建了**Equality**对象。 + +在 **main()** 里，请注意对 **testAll()** 的调用很简单。因为**EqualityFactory**有着单一的函数，它能够和lambda表达式一起使用来表示**make()**函数。 + +上述的 **equals()** 函数非常繁琐，并且我们能够将其简化成规范的形式，请注意： +1. **instanceof**检查减少了**null**检查的需要。 +2. 和**this**的比较是多余的。一个正确书写的 **equals()** 函数能正确地和自己比较。 + + +因为 **&&** 是一个短路比较，它会在第一次遇到失败的时候退出并返回**false**。所以，通过使用 **&&** 将检查链接起来，我们可以写出更精简的 **equals()** 函数： + +```java +// equalshashcode/SuccinctEquality.java +import java.util.*; +public class SuccinctEquality extends Equality { + public SuccinctEquality(int i, String s, double d) { + super(i, s, d); + System.out.println("made 'SuccinctEquality'"); + } + + @Override + public boolean equals(Object rval) { + return rval instanceof SuccinctEquality && + Objects.equals(i, ((SuccinctEquality)rval).i) && + Objects.equals(s, ((SuccinctEquality)rval).s) && + Objects.equals(d, ((SuccinctEquality)rval).d); + } + public static void main(String[] args) { + Equality.testAll( (i, s, d) -> + new SuccinctEquality(i, s, d)); + } + +} +/* Output: +made 'Equality' +made 'SuccinctEquality' +made 'Equality' +made 'SuccinctEquality' +made 'Equality' +made 'SuccinctEquality' +-- Testing null -- +null instanceof Equality: false +Expected false, got false +-- Testing same object -- +same object instanceof Equality: true +Expected true, got true +-- Testing different type -- +different type instanceof Equality: false +Expected false, got false +-- Testing same values -- +same values instanceof Equality: true +Expected true, got true +-- Testing different values --different values instanceof Equality: true +Expected false, got false +*/ +``` +对于每个 **SuccinctEquality**，基类构造函数在派生类构造函数前被调用，输出显示我们依然获得了正确的结果，你可以发现短路返回已经发生了，不然的话，**null**测试和“不同类型”的测试会在 **equals()** 函数下面的比较中强制转化的时候抛出异常。 + **Objects.equals()** 会在你组合其他类型的时候发挥很大的作用。 + +```java +// equalshashcode/ComposedEquality.java +import java.util.*; +class Part { + String ss; + double dd; + + Part(String ss, double dd) { + this.ss = ss; + this.dd = dd; + } + + @Override + public boolean equals(Object rval) { + return rval instanceof Part && + Objects.equals(ss, ((Part)rval).ss) && + Objects.equals(dd, ((Part)rval).dd); + } + +} + +public class ComposedEquality extends SuccinctEquality { + Part part; + public ComposedEquality(int i, String s, double d) { + super(i, s, d); + part = new Part(s, d); + System.out.println("made 'ComposedEquality'"); + } + @Override + public boolean equals(Object rval) { + return rval instanceof ComposedEquality && + super.equals(rval) && + Objects.equals(part, + ((ComposedEquality)rval).part); + + } + + public static void main(String[] args) { + Equality.testAll( (i, s, d) -> + new ComposedEquality(i, s, d)); + } +} +/* +Output: +made 'Equality' +made 'SuccinctEquality' +made 'ComposedEquality' +made 'Equality' +made 'SuccinctEquality' +made 'ComposedEquality' +made 'Equality' +made 'SuccinctEquality' +made 'ComposedEquality' +-- Testing null --null instanceof Equality: false +Expected false, got false +-- Testing same object -- +same object instanceof Equality: true +Expected true, got true +-- Testing different type -- +different type instanceof Equality: false +Expected false, got false +-- Testing same values -- +same values instanceof Equality: true +Expected true, got true +-- Testing different values -- +different values instanceof Equality: true +Expected false, got false +*/ +``` +注意super.equals()这个调用，没有必要重新发明它（因为你不总是有权限访问基类所有的必要字段） + + +### 不同子类的相等性 +继承意味着两个不同子类的对象当其向上转型的时候可以是相等的。假设你有一个Animal对象的集合。这个集合天然接受**Animal**的子类。在这个例子中是**Dog**和**Pig**。每个**Animal**有一个**name**和**size**，还有唯一的内部**id**数字。 + +我们通过**Objects**类，以规范的形式定义 **equals()**函数和**hashCode()**。但是我们只能在基类**Animal**中定义他们。并且我们在这两个函数中没有包含**id**字段。从**equals()**函数的角度看待，这意味着我们只关心它是否是**Animal**，而不关心是否是**Animal**的某个子类。 + +```java +// equalshashcode/SubtypeEquality.java +import java.util.*; +enum Size { SMALL, MEDIUM, LARGE } +class Animal { + private static int counter = 0; + private final int id = counter++; + private final String name; + private final Size size; + Animal(String name, Size size) { + this.name = name; + this.size = size; + } + @Override + public boolean equals(Object rval) { + return rval instanceof Animal && + // Objects.equals(id, ((Animal)rval).id) && // [1] + Objects.equals(name, ((Animal)rval).name) && + Objects.equals(size, ((Animal)rval).size); + } + + @Override + public int hashCode() { + return Objects.hash(name, size); + // return Objects.hash(name, size, id); // [2] + } + + @Override + public String toString() { + return String.format("%s[%d]: %s %s %x", + getClass().getSimpleName(), id, + name, size, hashCode()); + } +} + +class Dog extends Animal { + Dog(String name, Size size) { + super(name, size); + } +} + +class Pig extends Animal { + Pig(String name, Size size) { + super(name, size); + } +} + +public class SubtypeEquality { + public static void main(String[] args) { + Set pets = new HashSet<>(); + pets.add(new Dog("Ralph", Size.MEDIUM)); + pets.add(new Pig("Ralph", Size.MEDIUM)); + pets.forEach(System.out::println); + } +} +/* +Output: +Dog[0]: Ralph MEDIUM a752aeee +*/ +``` +如果我们只考虑类型的话，某些情况下它的确说得通——只从基类的角度看待问题，这是李氏替换原则的基石。这个代码完美符合替换理论因为派生类没有添加任何额外不再基类中的额外函数。派生类只是在表现上不同，而不是在接口上。（当然这不是常态） + +但是当我们提供了两个有着相同数据的不同的对象类型，然后将他们放置在 **HashSet** 中。只有他们中的一个能存活。这强调了 **equals()** 不是完美的数学理论，而只是机械般的理论。 + **hashCode()** 和 **equals()** 必须能够允许类型在hash数据结构中正常工作。例子中 **Dog** 和 **Pig** 会被映射到同 **HashSet** 的同一个桶中。这个时候，**HashSet** 回退到 **equals()** 来区分对象，但是 **equals()** 也认为两个对象是相同的。**HashSet**因为已经有一个相同的对象了，所以没有添加 **Pig**。 +我们依然能够通过使得其他字段对象不同来让例子能够正常工作。在这里每个 **Animal** 已经有了一个独一无二的 **id** ，所以你能够取消 **equals()** 函数中的 **[1]** 行注释，或者取消 **hashCode()** 函数中的 **[2]** 行注释。按照规范，你应该同时完成这两个操作，如此能够将所有“不变的”字段包含在两个操作中（“不变”所以 **equals()** 和 **hashCode()** 在哈希数据结构中的排序和取值时，不会生成不同的值。我将“不变的”放在引号中因为你必须计算出是否已经发生变化）。 + +> **旁注**： 在**hashCode()**中，如果你只能够使用一个字段，使用**Objcets.hashCode()**。如果你使用多个字段，那么使用 **Objects.hash()**。 + +我们也可以通过标准方式，将 **equals()** 定义在子类中（不包含 **id** ）解决这个问题： + +```java +// equalshashcode/SubtypeEquality2.java +import java.util.*; +class Dog2 extends Animal { + Dog2(String name, Size size) { + super(name, size); + } + + @Override + public boolean equals(Object rval) { + return rval instanceof Dog2 &&super.equals(rval); + } +} + +class Pig2 extends Animal { + Pig2(String name, Size size) { + super(name, size); + } + + @Override + public boolean equals(Object rval) { + return rval instanceof Pig2 && + super.equals(rval); + } +} + +public class SubtypeEquality2 { + public static void main(String[] args) { + Set pets = new HashSet<>(); + pets.add(new Dog2("Ralph", Size.MEDIUM)); + pets.add(new Pig2("Ralph", Size.MEDIUM)); + pets.forEach(System.out::println); + } +} +/* +Output: +Dog2[0]: Ralph MEDIUM a752aeee +Pig2[1]: Ralph MEDIUM a752aeee +*/ +``` +注意 **hashCode()** 是独一无二的，但是因为对象不再 **equals()** ，所以两个函数都出现在**HashSet**中。另外，**super.equals()** 意味着我们不需要访问基类的**private**字段。 + + +一种说法是Java从**equals()** 和**hashCode()** 的定义中分离了可替代性。我们仍然能够将**Dog**和**Pig**放置在 **Set** 中，无论 **equals()** 和 **hashCode()** 是如何定义的，但是对象不会在哈希数据结构中正常工作，除非这些函数能够被合理定义。不幸的是，**equals()** 不总是和 **hashCode()** 一起使用，这在你尝试为了某个特殊类型避免定义它的时候会让问题复杂化。并且这也是为什么遵循规范是有价值的。然而这会变得更加复杂，因为你不总是需要定义其中一个函数。 + @@ -16,4 +400,4 @@ ## 调整HashMap -
\ No newline at end of file +
From 28552b35ff9ebe71903a94e322df097f079defaa Mon Sep 17 00:00:00 2001 From: xiangflight Date: Tue, 16 Jul 2019 22:08:09 +0800 Subject: [PATCH 23/25] =?UTF-8?q?[revision=2011](=E6=88=AA=E8=87=B3=20?= =?UTF-8?q?=E4=B8=BA=E4=BB=80=E4=B9=88=E9=9C=80=E8=A6=81=E5=86=85=E9=83=A8?= =?UTF-8?q?=E7=B1=BB)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/11-Inner-Classes.md | 61 +++++++++++++++++++++-------------- 1 file changed, 37 insertions(+), 24 deletions(-) diff --git a/docs/book/11-Inner-Classes.md b/docs/book/11-Inner-Classes.md index 37cf2f0..b6e8ec9 100644 --- a/docs/book/11-Inner-Classes.md +++ b/docs/book/11-Inner-Classes.md @@ -337,9 +337,9 @@ public class TestParcel { 1. 一个定义在方法中的类。 2. 一个定义在作用域内的类，此作用域在方法的内部。 3. 一个实现了接口的匿名类。 -4. 一个匿名类，它扩展了有非默认构造器的类。 +4. 一个匿名类，它扩展了没有默认构造器的类。 5. 一个匿名类，它执行字段初始化。 -6. 一个匿名类，它通过实例初始化实现构造（匿名类不可能有构造器）。 +6. 一个匿名类，它通过实例初始化实现构造（匿名内部类不可能有构造器）。 第一个例子展示了在方法的作用域内（而不是在其他类的作用域内）创建一个完整的类。这被称作局部内部类： @@ -350,14 +350,17 @@ public class Parcel5 { public Destination destination(String s) { final class PDestination implements Destination { private String label; + private PDestination(String whereTo) { label = whereTo; } + @Override public String readLabel() { return label; } } return new PDestination(s); } + public static void main(String[] args) { Parcel5 p = new Parcel5(); Destination d = p.destination("Tasmania"); @@ -365,9 +368,9 @@ public class Parcel5 { } ``` -PDestination 类是 destination() 方法的一部分，而不是 Parcel5 的一部分。所以，在 destination() 之外不能访问 PDestination，注意出现在 return 语句中的向上转型-返回的是 Destination 的引用，它是 PDestination 的基类。当然，在 destination() 中定义了内部类 PDestination，并不意味着一旦 dest() 方法执行完毕，PDestination 就不可用了。 +**PDestination** 类是 `destination()` 方法的一部分，而不是 **Parcel5** 的一部分。所以，在 `destination()` 之外不能访问 **PDestination**，注意出现在 **return** 语句中的向上转型-返回的是 **Destination** 的引用，它是 **PDestination** 的基类。当然，在 `destination()` 中定义了内部类 **PDestination**，并不意味着一旦 `dest()` 方法执行完毕，**PDestination** 就不可用了。 -你可以在同一个子目录下的任意类中对某个内部类使用类标识符 PDestination，这并不会有命名冲突。 +你可以在同一个子目录下的任意类中对某个内部类使用类标识符 **PDestination**，这并不会有命名冲突。 下面的例子展示了如何在任意的作用域内嵌入一个内部类： @@ -398,7 +401,7 @@ public class Parcel6 { } ``` -TrackingSlip 类被嵌入在 if 语句的作用域内，这并不是说该类的创建是有条件的，它其实与别的类一起编译过了。然而，在定义 Trackingslip 的作用域之外，它是不可用的，除此之外，它与普通的类一样。 +**TrackingSlip** 类被嵌入在 **if** 语句的作用域内，这并不是说该类的创建是有条件的，它其实与别的类一起编译过了。然而，在定义 **Trackingslip** 的作用域之外，它是不可用的，除此之外，它与普通的类一样。 @@ -413,10 +416,12 @@ public class Parcel7 { public Contents contents() { return new Contents() { // Insert class definition private int i = 11; + @Override public int value() { return i; } }; // Semicolon required } + public static void main(String[] args) { Parcel7 p = new Parcel7(); Contents c = p.contents(); @@ -424,9 +429,9 @@ public class Parcel7 { } ``` -contents() 方法将返回值的生成与表示这个返回值的类的定义结合在一起！另外，这个类是匿名的，它没有名字。更糟的是，看起来似乎是你正要创建一个 Contents 对象。但是然后（在到达语句结束的分号之前）你却说：“等一等，我想在这里插入一个类的定义。 +`contents()` 方法将返回值的生成与表示这个返回值的类的定义结合在一起！另外，这个类是匿名的，它没有名字。更糟的是，看起来似乎是你正要创建一个 **Contents** 对象。但是然后（在到达语句结束的分号之前）你却说：“等一等，我想在这里插入一个类的定义。 -这种奇怪的语法指的是：“创建一个继承自 Contents 的匿名类的对象。”通过 new 表达式返回的引用被自动向上转型为对 Contents 的引用。上述匿名内部类的语法是下述形式的简化形式： +这种奇怪的语法指的是：“创建一个继承自 **Contents** 的匿名类的对象。”通过 **new** 表达式返回的引用被自动向上转型为对 **Contents** 的引用。上述匿名内部类的语法是下述形式的简化形式： ```java // innerclasses/Parcel7b.java @@ -437,9 +442,11 @@ public class Parcel7b { @Override public int value() { return i; } } + public Contents contents() { return new MyContents(); } + public static void main(String[] args) { Parcel7b p = new Parcel7b(); Contents c = p.contents(); @@ -447,14 +454,14 @@ public class Parcel7b { } ``` -在这个匿名内部类中，使用了默认的构造器来生成 Contents。下面的代码展示的是，如果你的基类需要一个有参数的构造器，应该怎么办： +在这个匿名内部类中，使用了默认的构造器来生成 **Contents**。下面的代码展示的是，如果你的基类需要一个有参数的构造器，应该怎么办： ```java // innerclasses/Parcel8.java // Calling the base-class constructor public class Parcel8 { public Wrapping wrapping(int x) { -// Base constructor call: + // Base constructor call: return new Wrapping(x) { // [1] @Override public int value() { @@ -472,7 +479,11 @@ public class Parcel8 { - \[1\] 将合适的参数传递给基类的构造器。 - \[2\] 在匿名内部类末尾的分号，并不是用来标记此内部类结束的。实际上，它标记的是表达式的结束，只不过这个表达式正巧包含了匿名内部类罢了。因此，这与别的地方使用的分号是一致的。 +<<<<<<< Updated upstream 尽管 Wrapping 只是一个具有具体实现的普通类，但它还是被派生类当作公共“接口”来使用。 +======= +尽管 **Wrapping** 只是一个具有具体实现的普通类，但它还是被导出类当作公共“接口”来使用。 +>>>>>>> Stashed changes ```java // innerclasses/Wrapping.java @@ -483,7 +494,7 @@ public class Wrapping { } ``` -为了多样性，Wrapping 拥有一个要求传递一个参数的构造器。 +为了多样性，**Wrapping** 拥有一个要求传递一个参数的构造器。 在匿名类中定义字段时，还能够对其执行初始化操作： @@ -491,7 +502,7 @@ public class Wrapping { // innerclasses/Parcel9.java public class Parcel9 { // Argument must be final or "effectively final" -// to use within the anonymous inner class: + // to use within the anonymous inner class: public Destination destination(final String dest) { return new Destination() { private String label = dest; @@ -506,9 +517,9 @@ public class Parcel9 { } ``` -如果定义一个匿名内部类，并且希望它使用一个在其外部定义的对象，那么编译器会要求其参数引用是 final 的，就像你在 destination() 的参数中看到的那样。如果你忘记了，将会得到一个编译时错误消息。 +如果定义一个匿名内部类，并且希望它使用一个在其外部定义的对象，那么编译器会要求其参数引用是 **final** 的（也就是说，它在初始化后不会改变，所以可以被当作 **final**），就像你在 `destination()` 的参数中看到的那样。这里省略掉 **final** 也没问题，但是通常最好加上 **final** 作为一种暗示。 -如果只是简单地给一个字段赋值，那么此例中的方法是很好的。但是，如果想做一些类似勾造器的行为，该怎么办呢？在匿名类中不可能有命名构造器（因为它根本没名字！），但通过实例初始化，就能够达到为匿名内部类创建一个构造器的效果，就像这样： +如果只是简单地给一个字段赋值，那么此例中的方法是很好的。但是，如果想做一些类似构造器的行为，该怎么办呢？在匿名类中不可能有命名构造器（因为它根本没名字！），但通过实例初始化，就能够达到为匿名内部类创建一个构造器的效果，就像这样： ```java // innerclasses/AnonymousConstructor.java @@ -545,9 +556,9 @@ Inside instance initializer In anonymous f() ``` -在此例中，不要求变量一定是 final 的。因为被传递给匿名类的基类的构造器，它并不会在匿名类内部被直接使用。 +在此例中，不要求变量一定是 **final** 的。因为被传递给匿名类的基类的构造器，它并不会在匿名类内部被直接使用。 -下例是带实例初始化的"parcel"形式。注意 destination() 的参数必须是 final 的，因为它们是在匿名类内部使用的。 +下例是带实例初始化的"parcel"形式。注意 `destination()` 的参数必须是 **final** 的，因为它们是在匿名类内部使用的（译者注：即使不加 **final**, Java 8 的编译器也会为我们自动加上 **final**，以保证数据的一致性）。 ```java // innerclasses/Parcel10.java @@ -582,7 +593,7 @@ public class Parcel10 { Over budget! ``` -在实例初始化操作的内部，可以看到有一段代码，它们不能作为字段初始化动作的一部分来执行（就是 if 语句）。所以对于匿名类而言，实例初始化的实际效果就是构造器。当然它受到了限制-你不能重载实例初始化方法，所以你仅有一个这样的构造器。 +在实例初始化操作的内部，可以看到有一段代码，它们不能作为字段初始化动作的一部分来执行（就是 **if** 语句）。所以对于匿名类而言，实例初始化的实际效果就是构造器。当然它受到了限制-你不能重载实例初始化方法，所以你仅有一个这样的构造器。 匿名内部类与正规的继承相比有些受限，因为匿名内部类既可以扩展类，也可以实现接口，但是不能两者兼备。而且如果是实现接口，也只能实现一个接口。 @@ -590,12 +601,12 @@ Over budget! ## 嵌套类 -如果不需要内部类对象与其外围类对象之间有联系，那么可以将内部类声明为 static，这通常称为嵌套类。想要理解 static 应用于内部类时的含义，就必须记住，普通的内部类对象隐式地保存了一个引用，指向创建它的外围类对象。然而，当内部类是 static 的时，就不是这样了。嵌套类意味着： +如果不需要内部类对象与其外围类对象之间有联系，那么可以将内部类声明为 **static**，这通常称为嵌套类。想要理解 **static** 应用于内部类时的含义，就必须记住，普通的内部类对象隐式地保存了一个引用，指向创建它的外围类对象。然而，当内部类是 **static** 的时，就不是这样了。嵌套类意味着： 1. 要创建嵌套类的对象，并不需要其外围类的对象。 2. 不能从嵌套类的对象中访问非静态的外围类对象。 -嵌套类与普通的内部类还有一个区别。普通内部类的字段与方法，只能放在类的外部层次上，所以普通的内部类不能有 static 数据和 static 字段，也不能包含嵌套类。但是嵌套类类可以包含所有这些东西： +嵌套类与普通的内部类还有一个区别。普通内部类的字段与方法，只能放在类的外部层次上，所以普通的内部类不能有 **static** 数据和 **static** 字段，也不能包含嵌套类。但是嵌套类可以包含所有这些东西： ```java // innerclasses/Parcel11.java @@ -635,13 +646,13 @@ public class Parcel11 { } ``` -在 main() 中，没有任何 Parcell1 的对象是必需的；而是使用选取 static 成员的普通语法来调用方法-这些方法返回对 Contents 和 Destination 的引用。 +在 `main()` 中，没有任何 **Parcel11** 的对象是必需的；而是使用选取 **static** 成员的普通语法来调用方法-这些方法返回对 **Contents** 和 **Destination** 的引用。 -就像你在本章前面看到的那样，在一个普通的（非 static）内部类中，通过一个特殊的 this 引用可以链接到其外围类对象。嵌套类就没有这个特殊的 this 引用，这使得它类似于一个 static 方法。 +就像你在本章前面看到的那样，在一个普通的（非 **static**）内部类中，通过一个特殊的 **this** 引用可以链接到其外围类对象。嵌套类就没有这个特殊的 **this** 引用，这使得它类似于一个 **static** 方法。 ### 接口内部的类 -嵌套类可以作为接口的一部分。你放到接口中的任何类都自动地是 public 和 static 的。因为类是 static 的，只是将嵌套类置于接口的命名空间内，这并不违反接口的规则。你甚至可以在内部类中实现其外围接口，就像下面这样： +嵌套类可以作为接口的一部分。你放到接口中的任何类都自动地是 **public** 和 **static** 的。因为类是 **static** 的，只是将嵌套类置于接口的命名空间内，这并不违反接口的规则。你甚至可以在内部类中实现其外围接口，就像下面这样： ```java // innerclasses/ClassInInterface.java @@ -666,9 +677,9 @@ public interface ClassInInterface { Howdy! ``` -如果你想要创建某些公共代码，使得它们可以被某个接口的所有不同实现所共用，那么使用接口内部的铁套类会显得很方便。 +如果你想要创建某些公共代码，使得它们可以被某个接口的所有不同实现所共用，那么使用接口内部的嵌套类会显得很方便。 -我曾在本书中建议过，在每个类中都写一个 main() 方法，用来测试这个类。这样做有一个缺点，那就是必须带着那些已编译过的额外代码。如果这对你是个麻烦，那就可以使用嵌套类来放置测试代码。 +我曾在本书中建议过，在每个类中都写一个 `main()` 方法，用来测试这个类。这样做有一个缺点，那就是必须带着那些已编译过的额外代码。如果这对你是个麻烦，那就可以使用嵌套类来放置测试代码。 ```java // innerclasses/TestBed.java @@ -691,6 +702,8 @@ public class TestBed { f() ``` +这生成了一个独立的类 **TestBed$Tester**（要运行这个程序，执行 **java TestBed$Tester**，在 Unix/Linux 系统中需要转义 **$**）。你可以使用这个类测试，但是不必在发布的产品中包含它，可以在打包产品前删除 **TestBed$Tester.class**。 + ### 从多层嵌套类中访问外部类的成员 一个内部类被嵌套多少层并不重要——它能透明地访问所有它所嵌入的外围类的所有成员，如下所示： @@ -721,7 +734,7 @@ public class MultiNestingAccess { } ``` -可以看到在 MNA.A.B 中，调用方法 g() 和 f() 不需要任何条件（即使它们被定义为 private）。这个例子同时展示了如何从不同的类里创建多层嵌套的内部类对象的基本语法。".new"语法能产生正确的作用域，所以不必在调用构造器时限定类名。 +可以看到在 **MNA.A.B** 中，调用方法 `g()` 和 `f()` 不需要任何条件（即使它们被定义为 **private**）。这个例子同时展示了如何从不同的类里创建多层嵌套的内部类对象的基本语法。"**.new**"语法能产生正确的作用域，所以不必在调用构造器时限定类名。 From aa95791ee7797b9fc7a71f6ed70fe1cd8e59e429 Mon Sep 17 00:00:00 2001 From: AlfredAlan <854723360@mail.com> Date: Wed, 17 Jul 2019 01:07:51 +0800 Subject: [PATCH 24/25] =?UTF-8?q?=E9=99=84=E5=BD=95=EF=BC=9A=E5=B9=B6?= =?UTF-8?q?=E5=8F=91=E5=BA=95=E5=B1=82=E5=8E=9F=E7=90=86=20=E7=BF=BB?= =?UTF-8?q?=E8=AF=91=E8=87=B3=E6=8D=95=E8=8E=B7=E5=BC=82=E5=B8=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/book/Appendix-Low-Level-Concurrency.md | 218 +++++++++++++++++++- 1 file changed, 208 insertions(+), 10 deletions(-) diff --git a/docs/book/Appendix-Low-Level-Concurrency.md b/docs/book/Appendix-Low-Level-Concurrency.md index 27b51cc..e09e7be 100644 --- a/docs/book/Appendix-Low-Level-Concurrency.md +++ b/docs/book/Appendix-Low-Level-Concurrency.md @@ -5,14 +5,14 @@ > 尽管不建议您自己编写底层 Java 并发代码，但是这样通常有助于了解它是如何工作的。 -[并发编程](./24-Concurrent-Programming.md) 章节中介绍了一些用于高级并发的概念，包括为 Java 并发编程而最新提出的,更安全的概念（ parallel Streams 和 CompletableFutures ）。本附录则介绍在 Java 中底层并发概念，因此在阅读本篇时，您能有所了解掌握这些代码。您还会将进一步了解并发的普遍问题。 +[并发编程](./24-Concurrent-Programming.md) 章节中介绍了一些用于高级并发的概念，包括为 Java 并发编程而最新提出的，更安全的概念（ parallel Streams 和 CompletableFutures ）。本附录则介绍在 Java 中底层并发概念，因此在阅读本篇时，您能有所了解掌握这些代码。您还会将进一步了解并发的普遍问题。 -在 Java 的早期版本中, 底层并发概念是并发编程的重要组成部分。我们会着眼于围绕这些技巧的复杂性以及为何您应该避免它们而谈。 “并发编程” 章节展示最新的 Java 版本(尤其是 Java 8)所提供的改进技巧，这些技巧使得并发的使用，如果本来不容易使用，也会更容易些。 +在 Java 的早期版本中, 底层并发概念是并发编程的重要组成部分。我们会着眼于围绕这些技巧的复杂性以及为何您应该避免它们而谈。 “并发编程” 章节展示最新的 Java 版本(尤其是 Java 8)所提供的改进技巧，这些技巧使得并发的使用，如果本来不容易使用，也会变得更容易些。 -## 线程 +## 什么是线程？ 并发将程序划分成分离的，独立运行的任务。每个任务都由一个 *执行线程* 来驱动，我们通常将其简称为 *线程* 。而一个 *线程* 就是操作系统进程中单一顺序的控制流。因此，单个进程可以有多个并发执行的任务，但是你的程序使得每个任务都好像有自己的处理器一样。这线程模型为编程带来了便利，它简化了在单一程序中处理变戏法般的多任务过程。操作系统则从处理器上分配时间到您程序的所有线程中。 @@ -26,14 +26,14 @@ Java 并发的核心机制是 **Thread** 类，在该语言最初版本中， ** * *thread-local variables* （线程本地变量）的存储区域 * 用于控制线程的状态管理变量 -包括 `main()` 在内的所有代码都会在某个线程内运行。 每当调用一个方法时，当前程序计数器被推到该线程的栈上，然后栈指针向下移动以足够来创建一个栈帧，其栈帧里存储该方法的所有局部变量，参数和返回值。所有基本类型变量都直接在栈上，虽然方法中创建（或方法中使用）对象的任何引用都位于栈帧中，但对象本身存于堆中。这仅且只有一个堆，被程序中所有线程所共享。 +包括 **main()** 在内的所有代码都会在某个线程内运行。 每当调用一个方法时，当前程序计数器被推到该线程的栈上，然后栈指针向下移动以足够来创建一个栈帧，其栈帧里存储该方法的所有局部变量，参数和返回值。所有基本类型变量都直接在栈上，虽然方法中创建（或方法中使用）对象的任何引用都位于栈帧中，但对象本身存于堆中。这仅且只有一个堆，被程序中所有线程所共享。 除此以外，线程必须绑定到操作系统，这样它就可以在某个时候连接到处理器。这是作为线程构建过程的一部分为您管理的。Java 使用底层操作系统中的机制来管理线程的执行。 ### 最佳线程数 如果你查看第 24 章 [并发编程](./24-Concurrent-Programming.md) 中使用 *CachedThreadPool* 的用例，你会发现 **ExecutorService** 为每个我们提交的任务分配一个线程。然而，并行流（**parallel Stream**）在 [**CountingStream.java** ](https://github.com/BruceEckel/OnJava8-Examples/blob/master/concurrent/CountingStream.java -) 中只分配了 8 个线程（id 中 1-7 为工作线程，8 为 **`main()`** 方法的主线程，它巧妙地将其用作额外的并行流）。如果你尝试提高 **range()** 方法中的上限值，你会看到没有创建额外的线程。这是为什么？ +) 中只分配了 8 个线程（id 中 1-7 为工作线程，8 为 **main()** 方法的主线程，它巧妙地将其用作额外的并行流）。如果你尝试提高 **range()** 方法中的上限值，你会看到没有创建额外的线程。这是为什么？ 我们可以查出当前机器上处理器的数量： @@ -51,7 +51,7 @@ public class NumberOfProcessors { */ ``` -在我的机器上（使用英特尔酷睿i7），我有四个内核，每个内核呈现两个*超线程*（指一种硬件技巧，能在单个处理器上产生非常快速的上下文切换，，在某些情况下可以使内核看起来像运行两个硬件线程）。虽然这是 “最近” 计算机上的常见配置(在撰写本文时)，但你可能会看到不同的结果，包括 `CountingStream.java` 中同等数量的默认线程。 +在我的机器上（使用英特尔酷睿i7），我有四个内核，每个内核呈现两个*超线程*（指一种硬件技巧，能在单个处理器上产生非常快速的上下文切换，在某些情况下可以使内核看起来像运行两个硬件线程）。虽然这是 “最近” 计算机上的常见配置(在撰写本文时)，但你可能会看到不同的结果，包括 **CountingStream.java ** 中同等数量的默认线程。 你的操作系统可能有办法来查出关于处理器的更多信息，例如，在Windows 10上，按下 “开始” 键，输入 “任务管理器” 和 Enter 键。点击 “详细信息” 。选择 “性能” 标签,您将会看到各种各样的关于您的硬件信息,包括“内核” 和 “逻辑处理器” 。 @@ -94,7 +94,7 @@ public class ThreadSize { } ``` -只要你不断递交任务，`CachedThreadPool` 就会继续创建线程。将 `Dummy` 对象递交到 `execute()` 方法以开始任务，如果线程池无可用线程，则分配一个新线程。执行的暂停方法 `pause()` 运行时间必须足够长，使任务不会开始即完成(从而为新任务释放现有线程)。只要任务不断进入而没有完成，`CachedThreadPool` 最终就会耗尽内存。 +只要你不断递交任务，**CachedThreadPool** 就会继续创建线程。将 **Dummy** 对象递交到 **execute()** 方法以开始任务，如果线程池无可用线程，则分配一个新线程。执行的暂停方法 **pause()** 运行时间必须足够长，使任务不会开始即完成(从而为新任务释放现有线程)。只要任务不断进入而没有完成，**CachedThreadPool** 最终就会耗尽内存。 我并不总是能够在我尝试的每台机器上造成内存不足的错误。在一台机器上，我看到这样的结果: @@ -103,7 +103,7 @@ public class ThreadSize { OutOfMemoryError: 2816 ``` -我们可以使用 `-Xss` 标记减少每个线程栈分配的内存大小。允许的最小线程栈大小是 64k: +我们可以使用 **-Xss** 标记减少每个线程栈分配的内存大小。允许的最小线程栈大小是 64k: ```shell >java -Xss64K ThreadSize @@ -124,7 +124,7 @@ Windows 操作系统默认栈大小是 320K，我们可以通过验证它给出 OutOfMemoryError: 2816 ``` -你还可以使用 `-Xmx` 标志增加 JVM 的最大内存分配: +你还可以使用 **-Xmx** 标志增加 JVM 的最大内存分配: ```shell >java -Xss64K -Xmx5M ThreadSize @@ -137,7 +137,7 @@ OutOfMemoryError: 5703 ### The WorkStealingPool -这是一个 `ExecutorService` ，它使用所有可用的(由JVM报告) 处理器自动创建线程池。 +这是一个 **ExecutorService** ，它使用所有可用的(由JVM报告) 处理器自动创建线程池。 ```java // lowlevel/WorkStealingPool.java @@ -185,9 +185,207 @@ ForkJoinPool-1-worker-2 ## 异常捕获 +这可能会让你感到惊讶： + +```java +// lowlevel/SwallowedException.java +import java.util.concurrent.*; + +public class SwallowedException { + public static void main(String[] args) + throws InterruptedException { + ExecutorService exec = + Executors.newSingleThreadExecutor(); + exec.submit(() -> { + throw new RuntimeException(); + }); + exec.shutdown(); + } +} +``` + +这个程序什么也不输出（然而，如果你用 **execute** 方法替换 **submit()** 方法，你就将会看到异常抛出。这说明在线程中抛出异常是很棘手的，需要特别注意的事情。 + +你无法捕获到从线程逃逸的异常。一旦异常越过了任务的 **run()** 方法，它就会传递至控制台，除非您采取特殊步骤来捕获此类错误异常。 + +下面是一个抛出异常的代码，该异常会传递到它的 **run()** 方法之外，而 **main()** 方法会显示运行它时会发生什么： + +```java +// lowlevel/ExceptionThread.java +// {ThrowsException} +import java.util.concurrent.*; + +public class ExceptionThread implements Runnable { + @Override + public void run() { + throw new RuntimeException(); + } + public static void main(String[] args) { + ExecutorService es = + Executors.newCachedThreadPool(); + es.execute(new ExceptionThread()); + es.shutdown(); + } +} +/* Output: +___[ Error Output ]___ +Exception in thread "pool-1-thread-1" +java.lang.RuntimeException + at ExceptionThread.run(ExceptionThread.java:8) + at java.util.concurrent.ThreadPoolExecutor.runW +orker(ThreadPoolExecutor.java:1142) + at java.util.concurrent.ThreadPoolExecutor$Work +er.run(ThreadPoolExecutor.java:617) + at java.lang.Thread.run(Thread.java:745) +*/ +``` + +输出是(经过调整一些限定符以适应阅读)： + +``` +Exception in thread "pool-1-thread-1" RuntimeException + at ExceptionThread.run(ExceptionThread.java:9) + at ThreadPoolExecutor.runWorker(...) + at ThreadPoolExecutor$Worker.run(...) + at java.lang.Thread.run(Thread.java:745) +``` + +即使在 **main()** 方法体内包裹 **try-catch** 代码块来捕获异常也不成功： + +```java +// lowlevel/NaiveExceptionHandling.java +// {ThrowsException} +import java.util.concurrent.*; + +public class NaiveExceptionHandling { + public static void main(String[] args) { + ExecutorService es = + Executors.newCachedThreadPool(); + try { + es.execute(new ExceptionThread()); + } catch(RuntimeException ue) { + // This statement will NOT execute! + System.out.println("Exception was handled!"); + } finally { + es.shutdown(); + } + } +} +/* Output: +___[ Error Output ]___ +Exception in thread "pool-1-thread-1" +java.lang.RuntimeException + at ExceptionThread.run(ExceptionThread.java:8) + at java.util.concurrent.ThreadPoolExecutor.runW +orker(ThreadPoolExecutor.java:1142) + at java.util.concurrent.ThreadPoolExecutor$Work +er.run(ThreadPoolExecutor.java:617) + at java.lang.Thread.run(Thread.java:745) +*/ +``` + +这会产生与前一个示例相同的结果:未捕获异常。 + +为解决这个问题，需要改变 **Executor** （执行器）生成线程的方式。 **Thread.UncaughtExceptionHandler** 是一个添加给每个 **Thread** 对象，用于进行异常处理的接口。 + +当该线程即将死于未捕获的异常时，将自动调用 **Thread.UncaughtExceptionHandler.uncaughtException()** + 方法。为了调用该方法，我们创建一个新的 `ThreadFactory` 类型来让 **Thread.UncaughtExceptionHandler** 对象附加到每个它所新创建的 **Thread**（线程）对象上。我们赋值该工厂对象给 **Executors** 对象的 方法，让它的方法来生成新的 **ExecutorService** 对象： + +```java +// lowlevel/CaptureUncaughtException.java +import java.util.concurrent.*; + +class ExceptionThread2 implements Runnable { + @Override + public void run() { + Thread t = Thread.currentThread(); + System.out.println("run() by " + t.getName()); + System.out.println( + "eh = " + t.getUncaughtExceptionHandler()); + throw new RuntimeException(); + } +} + +class MyUncaughtExceptionHandler implements +Thread.UncaughtExceptionHandler { + @Override + public void uncaughtException(Thread t, Throwable e) { + System.out.println("caught " + e); + } +} + +class HandlerThreadFactory implements ThreadFactory { + @Override + public Thread newThread(Runnable r) { + System.out.println(this + " creating new Thread"); + Thread t = new Thread(r); + System.out.println("created " + t); + t.setUncaughtExceptionHandler( + new MyUncaughtExceptionHandler()); + System.out.println( + "eh = " + t.getUncaughtExceptionHandler()); + return t; + } +} + +public class CaptureUncaughtException { + public static void main(String[] args) { + ExecutorService exec = + Executors.newCachedThreadPool( + new HandlerThreadFactory()); + exec.execute(new ExceptionThread2()); + exec.shutdown(); + } +} +/* Output: +HandlerThreadFactory@4e25154f creating new Thread +created Thread[Thread-0,5,main] +eh = MyUncaughtExceptionHandler@70dea4e +run() by Thread-0 +eh = MyUncaughtExceptionHandler@70dea4e +caught java.lang.RuntimeException +*/ +``` + +额外会跟踪验证工厂对象创建的线程是否获得新 **UncaughtExceptionHandler** 。现在未捕获的异常由 **uncaughtException** 方法捕获。 + +上面的示例根据具体情况来设置处理对象。如果你明白你想要在任何地方使用相同的异常处理对象，一个更简单的方法是设置默认的未捕获异常处理对象，它定义在 **Thread** 类中作为一个 **static**（静态） 字段： + +```java +// lowlevel/SettingDefaultHandler.java +import java.util.concurrent.*; + +public class SettingDefaultHandler { + public static void main(String[] args) { + Thread.setDefaultUncaughtExceptionHandler( + new MyUncaughtExceptionHandler()); + ExecutorService es = + Executors.newCachedThreadPool(); + es.execute(new ExceptionThread()); + es.shutdown(); + } +} +/* Output: +caught java.lang.RuntimeException +*/ +``` + +只有在每个线程没有设置异常处理对象时候，默认处理对象才会被调用。系统会检查每个线程的版本，如果没有找到，则检查是否线程组中有专门的 **uncaughtException()** 方法；如果都没有，就会调用 **defaultUncaughtExceptionHandler** 方法。 + +可以将此方法与 **CompletableFuture**s 的改进方法进行比较。 + ## 资源共享 +你可以将单线程程序看作一个孤独的实体，在你的问题空间中移动并一次只做一件事。因为只有一个实体，你永远不会想到两个实体试图同时使用相同资源的问题：问题犹如两个人试图同时停放在同一个空间，同时走过一扇门，甚至同时说话。 + +通过并发，事情不再孤单，但现在两个或更多任务可能会相互干扰。如果您不阻止这种冲突，您将有两个任务同时尝试访问同一个银行帐户，打印到同一个打印机，调整相同的阀门，等等。 + +### 资源竞争 + +### 解决资源竞争 + +### 同步多个生产者 ## volatile关键字 From 89a3da5a57ae08c5be6e89318e4cc4afca456180 Mon Sep 17 00:00:00 2001 From: Joe <736777445@qq.com> Date: Wed, 17 Jul 2019 13:15:13 +0800 Subject: [PATCH 25/25] Update README.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 第十八章 字符串更新完成 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index eb59c5e..4c34e04 100644 --- a/README.md +++ b/README.md @@ -37,7 +37,7 @@ - [x] [第十五章 异常](docs/book/15-Exceptions.md) - [ ] [第十六章 代码校验](docs/book/16-Validating-Your-Code.md) - [ ] [第十七章 文件](docs/book/17-Files.md) -- [ ] [第十八章 字符串](docs/book/18-Strings.md) +- [x] [第十八章 字符串](docs/book/18-Strings.md) - [ ] [第十九章 类型信息](docs/book/19-Type-Information.md) - [ ] [第二十章 泛型](docs/book/20-Generics.md) - [ ] [第二十一章 数组](docs/book/21-Arrays.md)