From 26189627d6cc87b2a6d3ab05cb8c2f7c71d0df70 Mon Sep 17 00:00:00 2001 From: maskleo Date: Sun, 22 Apr 2018 09:23:06 +0800 Subject: [PATCH 1/2] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E7=AC=AC=E5=9B=9B?= =?UTF-8?q?=E7=AB=A0=E7=9B=AE=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 95b2b312..5b5a10da 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,17 @@ * [第三章(集合类)](ch03/00_Comparison_and_Bounds.md) * [3.1 可比较的](ch03/01_Comparable.md) * [3.2 集合的最大值](ch03/02_Maximum_of_a_Collection.md) - + * [3.3 水果相关示例](ch03/03_A_Fruity_Example.md) + * [3.4 比较](ch03/04_Comparator.md) + * [3.5 枚举类型](ch03/05_Enumerated_Types.md) + * [3.6 多重界限](ch03/06_Multiple_Bounds.md) + * [3.7 桥梁](ch03/07_Bridges.md) + * [3.8 协变覆盖](ch03/08_Covariant_Overriding.md) + * [第四章(声明)](ch04/00_Declarations.md) + * [4.1 构造函数](ch04/01_Constructors.md) + * [4.2 静态成员](ch04/02_Static_Members.md) + * [4.3 嵌套类](ch04/03_Nested_Classes.md) + * [4.4 擦除的工作原理](ch04/04_How_Erasure_Works.md)     ## PR 提交 PR 前请先确认排版,示例: [中文文案排版](https://github.com/maskleo-doc/chinese-copywriting-guidelines) From a444ad481f208df853ee4c896fb2ad2744130b6a Mon Sep 17 00:00:00 2001 From: maskleo Date: Sun, 22 Apr 2018 09:27:13 +0800 Subject: [PATCH 2/2] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E7=AC=AC=E4=BA=94?= =?UTF-8?q?=E7=AB=A0=E9=93=BE=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 6 ++++++ ch05/01_Legacy_Library_with_Legacy_Client.md | 2 +- ch05/02_Generic_Library_with_Generic_Client.md | 2 +- ch05/03_Generic_Library_with_Legacy_Client.md | 2 +- ch05/04_Legacy_Library_with_Generic_Client.md | 2 +- ch05/05_Conclusions.md | 2 +- 6 files changed, 11 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 5b5a10da..6c8591bf 100644 --- a/README.md +++ b/README.md @@ -41,6 +41,12 @@ * [4.2 静态成员](ch04/02_Static_Members.md) * [4.3 嵌套类](ch04/03_Nested_Classes.md) * [4.4 擦除的工作原理](ch04/04_How_Erasure_Works.md) + * [第五章(进化，而不是革命)](ch05/00_Evolution_Not_Revolution.md) + * [5.1 旧版客户端的旧版库](ch05/01_Legacy_Library_with_Legacy_Client.md) + * [5.2 具有通用客户端的通用库](ch05/02_Generic_Library_with_Generic_Client.md) + * [5.3 具有传统客户端的通用库](ch05/03_Generic_Library_with_Legacy_Client.md) + * [5.4 具有通用客户端的旧版库](ch05/04_Legacy_Library_with_Generic_Client.md) + * [5.5 结论](ch05/05_Conclusions.md)     ## PR 提交 PR 前请先确认排版,示例: [中文文案排版](https://github.com/maskleo-doc/chinese-copywriting-guidelines) diff --git a/ch05/01_Legacy_Library_with_Legacy_Client.md b/ch05/01_Legacy_Library_with_Legacy_Client.md index b9ddb955..53f2d2d1 100644 --- a/ch05/01_Legacy_Library_with_Legacy_Client.md +++ b/ch05/01_Legacy_Library_with_Legacy_Client.md @@ -1,7 +1,7 @@ 《《《 [返回首页](../README.md)
《《《 [上一节](00_Evolution_Not_Revolution.md) -## 旧版客户端的旧版库 +### 旧版客户端的旧版库 我们从一个简单的栈库和一个关联的客户端开始，如例 `5-1` 所示。这是为 `Java 1.4` 及其版本的集合框架编写的遗留代码。像集合框架一样，我们将库构造为接口 `Stack`（类似于 `List`），实现类 `ArrayStack`（类似于 `ArrayList`）和实用类 `Stacks`（类似于 `Collections`）。接口堆栈提供了三种方法：`empty`， diff --git a/ch05/02_Generic_Library_with_Generic_Client.md b/ch05/02_Generic_Library_with_Generic_Client.md index 236fc201..982d55fe 100644 --- a/ch05/02_Generic_Library_with_Generic_Client.md +++ b/ch05/02_Generic_Library_with_Generic_Client.md @@ -1,7 +1,7 @@ 《《《 [返回首页](../README.md)
《《《 [上一节](01_Legacy_Library_with_Legacy_Client.md) -## 具有通用客户端的通用库 +### 具有通用客户端的通用库 接下来，我们更新库和客户端以使用泛型，如例 `5-2` 中所示。 这是用于 `Java 5` 及其集合版框架的通用代码。 接口现在接受一个类型参数，变成 `Stack`（类似于 `List`），实现类也变为 `ArrayStack`（类似于 `ArrayList`），但没有添加类型参数 实用工具类 `Stacks`（类似于 diff --git a/ch05/03_Generic_Library_with_Legacy_Client.md b/ch05/03_Generic_Library_with_Legacy_Client.md index 280cf6c3..301419cf 100644 --- a/ch05/03_Generic_Library_with_Legacy_Client.md +++ b/ch05/03_Generic_Library_with_Legacy_Client.md @@ -1,7 +1,7 @@ 《《《 [返回首页](../README.md)
《《《 [上一节](02_Generic_Library_with_Generic_Client.md) -## 具有传统客户端的通用库 +### 具有传统客户端的通用库 现在让我们考虑一下这种情况，即在客户端保留其旧版本时，库更新为泛型。这可能是因为没有足够的时间一次转换所有内容，或者因为类库和客户由不同的组织控制。 这对应于向后兼容性的最重要情况，其中 `Java 5` 的通用集合框架必须仍然可以与针对 `Java 1.4` 中的集合框架编写的传统客户端一起工作。 diff --git a/ch05/04_Legacy_Library_with_Generic_Client.md b/ch05/04_Legacy_Library_with_Generic_Client.md index d224cdbb..4c5018e0 100644 --- a/ch05/04_Legacy_Library_with_Generic_Client.md +++ b/ch05/04_Legacy_Library_with_Generic_Client.md @@ -1,7 +1,7 @@ 《《《 [返回首页](../README.md)
《《《 [上一节](03_Generic_Library_with_Legacy_Client.md) -## 具有通用客户端的旧版库 +### 具有通用客户端的旧版库 在客户端之前更新库通常是有意义的，但可能会出现您希望以其他方式进行更新的情况。 例如，您可能负责维护客户而不是类库; 或者类库可能很大，因此您可能需要逐 步更新，而不是一次全部更新; 或者你可能有类库的类文件，但没有源文件。 diff --git a/ch05/05_Conclusions.md b/ch05/05_Conclusions.md index 2adf4893..66fe8c82 100644 --- a/ch05/05_Conclusions.md +++ b/ch05/05_Conclusions.md @@ -1,7 +1,7 @@ 《《《 [返回首页](../README.md)
《《《 [上一节](04_Legacy_Library_with_Generic_Client.md) -## 结论 +### 结论 回顾一下，我们已经看到了库和客户端的通用版本和旧版本。这些生成等效的类文件，这大大简化了进化。您可以使用具有旧版客户端的通用库，或者使用通用客户端的旧版 库。在后一种情况下，您可以使用通用方法签名更新旧式库，无论是对源代码进行的最小更改，还是通过使用存根文件。