HOWTO · Java

Java 中的内部类和静态嵌套类

在计算机编程中,类是一个蓝图,它允许我们创建单独的类对象来访问来自数据成员或成员函数的数据。在 Java 编程中,类是用关键字 class 定义的。我们也可以说类是具有自定义修改的用户定义数据类型。

本页内容

嵌套类声明在另一个类内部。Java 支持 static 嵌套类和非 static 嵌套类(内部类)。如果某个类型在概念上属于其外围类,但不需要外围对象,就可以使用 static 嵌套类。static 关键字描述的是这种关系;它不会让嵌套类型变成顶层类,也不会形成安全边界。

Java 中的静态嵌套类

static 嵌套类是在另一个类内部使用 static 关键字声明的成员类型。可以用外围类型限定它的名称,例如 Envelope.Label;无需先创建 Envelope 对象,就能实例化它。当辅助类型或值类型与某个类紧密相关、单独作为顶层类型又缺乏意义时,这种组织方式很有用。

嵌套类型仍有自己的实例。将嵌套类标记为 static 不会让它的字段或方法变成 static。和顶层类一样,你可以为嵌套类定义自己的构造函数、实例状态和方法。

静态嵌套类与外围类的关系

static 嵌套类不会隐式持有外围类实例的引用。它可以直接访问外围类的 static 成员,包括私有的 static 成员。由于它不关联任何外围对象,因此不能直接使用外围实例字段或方法。若需要这些数据,可以将外围对象传给构造函数或方法,再通过该引用访问相应成员。

反向访问关系也很有用:外围类中的代码可以使用嵌套类,包括其私有成员,但仍须遵守 Java 的常规访问规则。私有可见性决定哪些代码可以引用某个成员;不应将它描述为安全功能。

声明并实例化静态嵌套类

在外围类的类体中使用 static class Label 声明该类型。在外围类之外,可以通过 Envelope.Label 引用它。下面的完整示例将嵌套值类型与使用它的类放在一起,并直接从 main 创建该类型的实例:

运行此示例:示例代码和其中显示的标签保持英文。

本节中的代码以及显示的标签或输出仍为英文。

public class Main {
    static class Label {
        private final String text;

        Label(String text) {
            this.text = text;
        }

        String display() {
            return "Label: " + text;
        }
    }

    public static void main(String[] args) {
        Label label = new Label("priority");
        System.out.println(label.display());
    }
}
Label: priority

由于 main 是 static 方法,因此无需创建 Main 实例就能创建 Label。另一个类可以使用限定名称 Main.Label,并调用具有适当可见性的构造函数。如果嵌套类需要某个特定外围对象的信息,应将该依赖显式传入。

静态嵌套类与内部类的区别

内部类是非 static 成员类。每个内部类对象都与其外围类的一个实例相关联,因此内部类代码可以直接引用该外围实例的成员。在外围类之外创建内部类时,先创建外围对象,再使用 outer.new Inner() 这种形式;内部类型的名称是 Outer.Inner。

static 嵌套类没有这种关联,因此创建它时不需要外围对象:在外围类之外使用 new Outer.Nested(),或在作用域内使用简短名称。根据 API 的设计,两种类型都可以声明为私有或公开,并且都可以访问外围类的私有成员。两者的区别在于是否存在隐式的外围实例关系,而不在于安全级别。

何时使用静态嵌套类

当嵌套类型在逻辑上属于外围类,但其实例无需依赖隐式外围对象即可完成工作时,可以选择 static 嵌套类。常见用途包括小型值类型、构建器,或只对某个外围 API 有意义的辅助类型。static 嵌套类仍可显式接收依赖,这样调用方就能清楚地看到这些要求。

如果每个实例都必须与创建它的特定外围对象协作,例如需要读取或更新该对象的实例状态,可以选择内部类。如果某个类型用途广泛且独立,顶层类可能更容易复用和查找。根据代码实际需要的关系来选择,并采用足以支持预期用途的最小可见性。