使类和成员的可访问性最小化

ch04类和接口/15.使类和成员的可访问性最小化.md

@@ -0,0 +1,34 @@
+## 使类和成员的可访问性最小化
+
+将设计良好的组件与设计不佳的组件区分开来的最重要的因素是，隐藏内部数据和其他实现细节的程度。
+
+一个设计良好的组件隐藏了它的所有实现细节，干净地将它的 API 与它的实现分离开来。然后，组件只通过它们的 API 进行通信，并且对彼此的内部工作一无所知。这一概念，被称为**信息隐藏或封装**，是软件设计的基本原则。
+
+信息隐藏很重要有很多原因，其中大部分来源于它将组成系统的组件分离开来，允许它们被独立地开发，测试，优化，使用，理解和修改。这加速了系统开发，因为组件可以并行开发。它减轻了维护的负担，因为可以更快速地理解组件，调试或更换组件，而不用担心损害其他组件。虽然信息隐藏本身并不会导致良好的性能，但它可以有效地进行性能调整：一旦系统完成并且分析确定了哪些组件导致了性能问题（条目 67），则可以优化这些组件，而不会影响别人的正确的组件。信息隐藏增加了软件重用，因为松耦合的组件通常在除开发它们之外的其他环境中证明是有用的。最后，隐藏信息降低了构建大型系统的风险，因为即使系统不能运行，各个独立的组件也可能是可用的。
+
+Java 提供了许多机制来帮助信息隐藏。 访问控制机制（access control mechanism）指定了类，接口和成员的可访问性。 实体的可访问性取决于其声明的位置，以及声明中存在哪些访问修饰符（private，protected 和 public）。 正确使用这些修饰符对信息隐藏至关重要。
+
+经验法则很简单：**让每个类或成员尽可能地不可访问。** 换句话说，使用尽可能低的访问级别。
+
+对于成员（字段、方法、嵌套类和嵌套接口），有四种可能的访问级别，在这里，按照可访问性从小到大列出：
+
+- private —— 该成员只能在声明它的顶级类内访问。
+- package-private —— 成员可以从被声明的包中的任何类中访问。从技术上讲，如果没有指定访问修饰符（接口成员除外，它默认是公共的），这是默认访问级别。
+- protected —— 成员可以从被声明的类的子类中访问，以及它声明的包中的任何类。
+- public —— 该成员可以从任何地方被访问。
+
+**公共类的实例字段很少情况下采用 public 修饰（详见第 16 条）。** 如果一个实例字段是非 final 的，或者是对可变对象的引用，那么通过将其公开，你就放弃了限制可以存储在字段中的值的能力。这意味着你放弃了执行涉及该字段的不变量的能力。另外，当字段被修改时，就放弃了采取任何操作的能力，**因此带有公共可变字段的类通常不是线程安全的** 。即使一个字段是 final 的，并且引用了一个不可变的对象，通过将其公开，你放弃了切换到一个新的内部数据表示的灵活性，而该字段并不存在。
+
+请注意，非零长度的数组总是可变的，**所以类具有公共静态 final 数组字段，或返回这样一个字段的访问器是错误的。** 
+
+-	[Item15Example01.java](ClassesAndInterfaces/src/main/java/com/jueee/item15/Item15Example01.java)：客户端将能够修改数组的内容，这是安全漏洞的常见来源。
+-	[Item15Example02.java](ClassesAndInterfaces/src/main/java/com/jueee/item15/Item15Example02.java)：使公共数组私有并添加一个公共的不可变列表。
+-	[Item15Example03.java](ClassesAndInterfaces/src/main/java/com/jueee/item15/Item15Example03.java)：将数组设置为 private，并添加一个返回私有数组拷贝的公共方法。
+
+在 Java 9 中，作为模块系统（module system）的一部分引入了两个额外的隐式访问级别。模块包含一组包，就像一个包包含一组类一样。模块可以通过模块声明中的导出（export）声明显式地导出某些包 (这是 module-info.java 的源文件中包含的约定)。模块中的未导出包的公共和受保护成员在模块之外是不可访问的；在模块中，可访问性不受导出（export）声明的影响。使用模块系统允许你在模块之间共享类，而不让它们对整个系统可见。在未导出的包中，公共和受保护的公共类的成员会产生两个隐式访问级别，这是普通公共和受保护级别的内部类似的情况。这种共享的需求是相对少见的，并且可以通过重新安排包中的类来消除。
+
+与四个主要访问级别不同，这两个基于模块的级别主要是建议（advisory）。 如果将模块的 JAR 文件放在应用程序的类路径而不是其模块路径中，那么模块中的包将恢复为非模块化行为：包的公共类的所有公共类和受保护成员都具有其普通的可访问性，不管包是否由模块导出[Reinhold，1.2]。 新引入的访问级别严格执行的地方是 JDK 本身：Java 类库中未导出的包在模块之外真正无法访问。
+
+对于典型的 Java 程序员来说，不仅程序模块所提供的访问保护存在局限性，而且在本质上是很大程度上建议性的；为了利用它，你必须把你的包组合成模块，在模块声明中明确所有的依赖关系，重新安排你的源码树层级，并采取特殊的行动来适应你的模块内任何对非模块化包的访问。 现在说模块是否会在 JDK 之外得到广泛的使用还为时尚早。 与此同时，除非你有迫切的需要，否则似乎最好避免它们。
+
+总而言之，应该尽可能地减少程序元素的可访问性（在合理范围内）。 在仔细设计一个最小化的公共 API 之后，你应该防止任何散乱的类，接口或成员成为 API 的一部分。 除了作为常量的公共静态 `final` 字段之外，公共类不应该有公共字段。 确保 `public static final` 字段引用的对象是不可变的。

ch04类和接口/ClassesAndInterfaces/.gitignore

@@ -0,0 +1,32 @@
+HELP.md
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**
+!**/src/test/**
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+
+### VS Code ###
+.vscode/
+/chromedriver.exe

ch04类和接口/ClassesAndInterfaces/pom.xml

@@ -0,0 +1,25 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+
+  <groupId>com.github.jueee</groupId>
+  <artifactId>ClassesAndInterfaces</artifactId>
+  <version>0.0.1-SNAPSHOT</version>
+  <packaging>jar</packaging>
+
+  <name>ClassesAndInterfaces</name>
+  <url>http://maven.apache.org</url>
+
+  <properties>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+  </properties>
+
+  <dependencies>
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>3.8.1</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+</project>

ch04类和接口/ClassesAndInterfaces/src/main/java/com/jueee/item15/Item15Example01.java

@@ -0,0 +1,11 @@
+package com.jueee.item15;
+
+public class Item15Example01 {
+    
+    // Potential security hole!
+    public static final String[] VALUES = { "" };
+
+    public static void main(String[] args) {
+
+    }
+}

ch04类和接口/ClassesAndInterfaces/src/main/java/com/jueee/item15/Item15Example02.java

@@ -0,0 +1,15 @@
+package com.jueee.item15;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+public class Item15Example02 {
+    
+    private static final String[] PRIVATE_VALUES = { "" };
+    public static final List<String> VALUES = Collections.unmodifiableList(Arrays.asList(PRIVATE_VALUES));
+
+    public static void main(String[] args) {
+
+    }
+}

ch04类和接口/ClassesAndInterfaces/src/main/java/com/jueee/item15/Item15Example03.java

@@ -0,0 +1,14 @@
+package com.jueee.item15;
+
+public class Item15Example03 {
+    
+    private static final String[] PRIVATE_VALUES = { "" };
+
+    public static final String[] values() {
+        return PRIVATE_VALUES.clone();
+    }
+
+    public static void main(String[] args) {
+
+    }
+}