Java 嵌套接口

学习目标

理解 嵌套接口 的定义与声明方式
掌握嵌套接口在类中与 接口中 的访问修饰规则差异
能够正确使用完全限定名实现和引用嵌套接口
了解嵌套接口在代码组织、封装性和回调机制中的实际用途

什么是嵌套接口

在 Java 中，嵌套接口是指在一个类或另一个接口内部声明的接口。它属于成员接口，其作用域受外部容器限制。

嵌套接口天然具有 static 属性（无论是否显式声明），因此不依赖于外部类的实例。

嵌套接口的两种形式

在类中定义嵌套接口

当接口被声明在类内部时，它可以使用任意访问修饰符：public、protected、包级私有（默认）或 private。

示例：类中的嵌套接口

class Outer {
    // 嵌套接口（默认为 public static）
    interface Inner {
        void display();
    }
}

// 实现嵌套接口：必须使用完全限定名 Outer.Inner
class MainApp implements Outer.Inner {
    public void display() {
        System.out.println("来自类中嵌套接口的消息！");
    }

    public static void main(String[] args) {
        // 使用接口类型引用
        Outer.Inner obj = new MainApp();
        obj.display();
    }
}

输出：

来自类中嵌套接口的消息！

注意：即使未写 static，嵌套接口仍是静态的，因此可通过 Outer.Inner 直接访问，无需创建 Outer 的实例。

在接口中定义嵌套接口

当接口被声明在另一个接口内部时，它自动是 public 和 static 的，即使没有显式写出。

示例：接口中的嵌套接口

interface OuterInterface {
    void show();

    // 嵌套接口（隐式 public static）
    interface InnerInterface {
        void msg();
    }
}

// 实现嵌套接口
class Test implements OuterInterface.InnerInterface {
    public void msg() {
        System.out.println("来自接口中嵌套接口的消息！");
    }

    public static void main(String[] args) {
        OuterInterface.InnerInterface obj = new Test();
        obj.msg();
    }
}

输出：

来自接口中嵌套接口的消息！

重要：你不能在接口中定义 protected 或 private 的成员接口——这会导致编译错误。

关键规则

声明位置	允许的访问修饰符	隐式属性
顶级接口（不在类或接口内）	`public` 或默认（包级私有）	无
类内部的嵌套接口	`public`、`protected`、默认、`private`	隐式 `static`
接口内部的嵌套接口	仅 `public`（即使不写）	隐式 `public static`

❌ 错误示例：以下代码无法编译

interface Parent {
    protected interface Test {  // 编译错误！
        void show();
    }
}

原因：接口中的成员（包括嵌套接口）只能是 public，不能使用 protected 或 private。

典型用途

代码组织与逻辑分组
将功能相关的接口放在一起，提升代码可读性与模块化程度。例如：

class Database {
    interface Connection {
        void connect();
    }
    interface QueryExecutor {
        ResultSet execute(String sql);
    }
}

控制访问范围
若某个接口仅在特定类内部使用，将其设为 private 嵌套接口可防止外部滥用，增强封装性。

实现回调机制
常用于事件监听或异步处理场景：

class NetworkClient {
    interface OnResponseListener {
        void onSuccess(String data);
        void onError(Exception e);
    }

    public void fetchData(OnResponseListener listener) {
        // 模拟网络请求后回调
        listener.onSuccess("数据返回");
    }
}

定义局部契约
多个内部类或外部类可实现同一嵌套接口，确保行为一致性，同时保持接口作用域清晰。

重点总结

嵌套接口总是 静态的，不依赖外部类实例。
在类中声明的嵌套接口可使用任意访问修饰符；在 接口中 声明的嵌套接口只能是 public。
实现嵌套接口时，必须使用 完全限定名（如 OuterClass.NestedInterface）。
嵌套接口有助于提升代码结构、封装性和设计灵活性，尤其适用于回调、工具类或领域模型内部契约。

思考题

为什么嵌套接口必须是 static 的？如果允许非静态嵌套接口，会带来什么问题？
假设你正在设计一个图形库，其中 Shape 是一个类，而 Drawable 和 Resizable 是仅在该库内部使用的接口。你会如何组织这些接口？请写出代码结构。
能否在一个 private 嵌套接口被外部类实现？为什么？如果不能，如何让外部代码间接使用它？