From d6857ddc4cd120f4bdb05db956ab0bb2ab5aee63 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=B0=89=E5=8B=87=E5=BC=BA2?= Date: Mon, 16 Sep 2019 20:17:17 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BD=BF=E7=94=A8=E4=BE=9D=E8=B5=96=E6=B3=A8?= =?UTF-8?q?=E5=85=A5=E5=8F=96=E4=BB=A3=E7=A1=AC=E8=BF=9E=E6=8E=A5=E8=B5=84?= =?UTF-8?q?=E6=BA=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../04.使用私有构造方法执行非实例化.md | 33 +++++++++++ .../05.使用依赖注入取代硬连接资源.md | 38 +++++++++++++ .../main/java/com/jueee/item04/Item04Example01.java | 13 +++++ .../main/java/com/jueee/item05/Item05Example01.java | 56 +++++++++++++++++++ 4 files changed, 140 insertions(+) create mode 100644 ch02创建和销毁对象/04.使用私有构造方法执行非实例化.md create mode 100644 ch02创建和销毁对象/05.使用依赖注入取代硬连接资源.md create mode 100644 ch02创建和销毁对象/CreatingAndDestroyingObjects/src/main/java/com/jueee/item04/Item04Example01.java create mode 100644 ch02创建和销毁对象/CreatingAndDestroyingObjects/src/main/java/com/jueee/item05/Item05Example01.java diff --git a/ch02创建和销毁对象/04.使用私有构造方法执行非实例化.md b/ch02创建和销毁对象/04.使用私有构造方法执行非实例化.md new file mode 100644 index 0000000..6cc9599 --- /dev/null +++ b/ch02创建和销毁对象/04.使用私有构造方法执行非实例化.md @@ -0,0 +1,33 @@ +## 使用私有构造方法执行非实例化 + +### 示例 + +- [Item04Example01.java](CreatingAndDestroyingObjects/src/main/java/com/jueee/item04/Item04Example01.java):禁止默认构造函数以实现非实例化 + +### 说明 + +偶尔你会想写一个类,它只是一组静态方法和静态属性。 + +这样的类获得了不好的名声,因为有些人滥用这些类而避免以面向对象方式思考,但是它们确实有着特殊的用途。 + +它们可以用来按照`java.lang.Math`或`java.util.Arrays`的方式,在基本类型的数值或数组上组织相关的方法。 它们也可以用于将静态方法(包括工厂(条目 1))分组,用于实现某个接口的对象,其方式为`java.util.Collections`。 + +最后,这样的类可以用于在final类上对方法进行分组,因为不能将它们放在子类中。 + +这样的实用类( utility classes)不是设计用来被实例化的:一个实例是没有意义的。然而,在没有显式构造方法的情况下,编译器提供了一个公共的、无参的默认构造方法。对于用户来说,该构造方法与其他构造方法没有什么区别。在已发布的 API中经常看到无意识的被实例的类。 + +**试图通过创建抽象类来强制执行非实例化是行不通的。**该类可以被子类化,子类可以被实例化。此外,它误导用户认为该类是为继承而设计的(条目 19)。不过,有一个简单的方法来确保非实例化。只有当类不包含显式构造方法时,才会生成一个默认构造方法,**因此可以通过包含一个私有构造方法来实现类的非实例化**: + +```java +// 不可实例化的程序类 +class UtilityClass { + // 禁止默认构造函数以实现非实例化 + private UtilityClass() { + throw new AssertionError(); + } +} +``` + +因为显式构造方法是私有的,所以在类之外是不可访问的。`AssertionError`异常不是严格要求的,但是它提供了一种保证,以防在类中意外地调用构造方法。它保证类在任何情况下都不会被实例化。这个习惯用法有点违反直觉,好像构造方法就是设计成不能调用的一样。因此,如前面所示,添加注释是种明智的做法。 + +这种习惯有一个副作用,阻止了类的子类化。所有的构造方法都必须显式或隐式地调用父类构造方法,而子类则没有可访问的父类构造方法来调用。 \ No newline at end of file diff --git a/ch02创建和销毁对象/05.使用依赖注入取代硬连接资源.md b/ch02创建和销毁对象/05.使用依赖注入取代硬连接资源.md new file mode 100644 index 0000000..d87b59c --- /dev/null +++ b/ch02创建和销毁对象/05.使用依赖注入取代硬连接资源.md @@ -0,0 +1,38 @@ +## 使用依赖注入取代硬连接资源 + +### 示例 + +- [Item05Example01.java](CreatingAndDestroyingObjects/src/main/java/com/jueee/item05/Item05Example01.java): + +### 说明 + +许多类依赖于一个或多个底层资源。 + +例如,拼写检查器依赖于字典。 + +满足这一需求的简单模式是在创建新实例时将资源传递到构造方法中。 + +这是依赖项注入(dependency injection)的一种形式:字典是拼写检查器的一个依赖项,当它创建时被注入到拼写检查器中。 + +```java +// 依赖注入提供了灵活性和可测试性 +public class SpellChecker { + private final Lexicon dictionary; + + public SpellChecker(Lexicon dictionary) { + this.dictionary = Objects.requireNonNull(dictionary); + } + + public boolean isValid(String word) { ... } + public List suggestions(String typo) { ... } +} +``` + +虽然我们的拼写检查器的例子只有一个资源(字典),但是依赖项注入可以使用任意数量的资源和任意依赖图。 它保持了不变性(条目 17),因此多个客户端可以共享依赖对象(假设客户需要相同的底层资源)。 依赖注入同样适用于构造方法,静态工厂(条目 1)和 builder模式(条目 2)。 + +该模式的一个有用的变体是将资源工厂传递给构造方法。 工厂是可以重复调用以创建类型实例的对象。 这种工厂体现了工厂方法模式(Factory Method pattern )。 Java 8中引入的`Supplier `接口非常适合代表工厂。 在输入上采用`Supplier`的方法通常应该使用有界的通配符类型( bounded wildcard type)(条目 31)约束工厂的类型参数,以允许客户端传入工厂,创建指定类型的任何子类型。 例如,下面是一个使用客户端提供的工厂生成tile的方法: +`Mosaic create(Supplier tileFactory) { ... }` + +尽管依赖注入极大地提高了灵活性和可测试性,但它可能使大型项目变得混乱,这些项目通常包含数千个依赖项。使用依赖注入框架(如Dagger、Guice或Spring)可以消除这些混乱。 + +总之,不要使用单例或静态的实用类来实现一个类,该类依赖于一个或多个底层资源,这些资源的行为会影响类的行为,并且不让类直接创建这些资源。相反,将资源或工厂传递给构造方法(或静态工厂或builder模式)。这种称为依赖注入的实践将极大地增强类的灵活性、可重用性和可测试性。 \ No newline at end of file diff --git a/ch02创建和销毁对象/CreatingAndDestroyingObjects/src/main/java/com/jueee/item04/Item04Example01.java b/ch02创建和销毁对象/CreatingAndDestroyingObjects/src/main/java/com/jueee/item04/Item04Example01.java new file mode 100644 index 0000000..80fe4ee --- /dev/null +++ b/ch02创建和销毁对象/CreatingAndDestroyingObjects/src/main/java/com/jueee/item04/Item04Example01.java @@ -0,0 +1,13 @@ +package com.jueee.item04; + +public class Item04Example01 { + +} + +// 不可实例化的程序类 +class UtilityClass { + // 禁止默认构造函数以实现非实例化 + private UtilityClass() { + throw new AssertionError(); + } +} \ No newline at end of file diff --git a/ch02创建和销毁对象/CreatingAndDestroyingObjects/src/main/java/com/jueee/item05/Item05Example01.java b/ch02创建和销毁对象/CreatingAndDestroyingObjects/src/main/java/com/jueee/item05/Item05Example01.java new file mode 100644 index 0000000..aa8fcf7 --- /dev/null +++ b/ch02创建和销毁对象/CreatingAndDestroyingObjects/src/main/java/com/jueee/item05/Item05Example01.java @@ -0,0 +1,56 @@ +package com.jueee.item05; + +import java.util.List; +import java.util.Objects; + +public class Item05Example01 { + +} + +class Lexicon{} + +class SpellChecker01 { + private final Lexicon dictionary = new Lexicon(); + + private SpellChecker01() {} // 不可实例化的 + + public static boolean isValid(String word) { + return false; + } + + public static List suggestions(String typo) { + return null; + } +} + +class SpellChecker02 { + private final Lexicon dictionary = new Lexicon(); + + private SpellChecker02() {} + + public static SpellChecker02 INSTANCE = new SpellChecker02(); + + public boolean isValid(String word) { + return false; + } + + public List suggestions(String typo) { + return null; + } +} + +class SpellChecker03 { + private final Lexicon dictionary; + + public SpellChecker03(Lexicon dictionary) { + this.dictionary = Objects.requireNonNull(dictionary); + } + + public boolean isValid(String word) { + return false; + } + + public List suggestions(String typo) { + return null; + } +} \ No newline at end of file