如何解决跨包循环依赖并创建其他包的类实例

问题背景 #

Package A中实现了PortletClickHandler类（实现Package B的CustomClickHandler接口），且A导入了B的HomePage类；但B不能导入A，否则会触发循环依赖报错：

Adding dependency on module 'A' will introduce circular dependency between modules 'B' and 'C'. Add dependency anyway?

导致无法在B中直接创建PortletClickHandler实例。

可行解决办法 #

1. 依赖注入（最直接的方案）

目前Package A中已经通过new HomePage(new PortletClickHandler())把Handler实例传递给了HomePage，那B的HomePage只需要持有CustomClickHandler接口的引用即可，完全不需要知道具体实现类：

// Package B的HomePage类
public class HomePage {
    private CustomClickHandler clickHandler;

    // 构造函数接收接口实例
    public HomePage(CustomClickHandler clickHandler) {
        this.clickHandler = clickHandler;
    }

    // 业务逻辑中直接调用接口方法
    public void updatePortlet(int portletId) {
        clickHandler.setPortletId(portletId);
    }
}

这样B只依赖自身定义的CustomClickHandler接口，完全不需要依赖Package A，彻底避免循环依赖。

2. 把公共接口移到独立模块

如果后续有更多模块需要用到CustomClickHandler，可以把这个接口抽离到一个独立的公共模块（比如Package C）：

• Package C：仅存放CustomClickHandler接口
• Package A：依赖Package B（HomePage）和Package C（接口），实现PortletClickHandler
• Package B：依赖Package C（接口），使用接口类型而非具体实现

这种方式从模块依赖结构上打破了A和B的直接循环，是大型项目中常用的解耦方式。

3. 工厂/服务定位器模式（适合特殊场景）

如果必须在B中主动获取Handler实例，可以用全局服务定位器让A注册实例，B通过接口获取：

// 公共模块的服务定位器类
public class HandlerLocator {
    private static CustomClickHandler handlerInstance;

    public static void registerHandler(CustomClickHandler handler) {
        handlerInstance = handler;
    }

    public static CustomClickHandler getHandler() {
        return handlerInstance;
    }
}

// Package A中注册实例
PortletClickHandler handler = new PortletClickHandler();
HandlerLocator.registerHandler(handler);
Content = new HomePage(handler);

// Package B中获取实例使用
CustomClickHandler handler = HandlerLocator.getHandler();
if (handler != null) {
    handler.setPortletId(1001);
}

注意要处理实例为空的情况，同时保证线程安全（如果是多线程环境）。

内容的提问来源于stack exchange，提问作者Christopher Chua