为实现DataAdapter接口的类添加少参方法的最佳实践

现有代码背景 #

原接口定义：

public interface DataAdapter {
    int solve(int a, int b, int c);
}

已有实现类示例：

public class DataAdapterImplA implements DataAdapter {
    @Override
    public int solve(int a, int b, int c) {
        // 业务逻辑实现
        return ...;
    }
}

public class DataAdapterImplB implements DataAdapter {
    @Override
    public int solve(int a, int b, int c) {
        // 业务逻辑实现
        return ...;
    }
}

待新增的实现类需求：仅需实现两参的solve(int a, int b)方法。

两种方案对比 #

方案1：重写三参solve方法并忽略第三个参数 #

直接让DataAdapterImplF实现三参方法，内部忽略c参数：

public class DataAdapterImplF implements DataAdapter {
    @Override
    public int solve(int a, int b, int c) {
        // 忽略c参数，调用内部两参逻辑
        return solve(a, b);
    }

    public int solve(int a, int b) {
        // 实际业务逻辑
        return ...;
    }
}

优点：无需修改原有接口，完全兼容所有已有实现类，改动成本极低。
缺点：接口契约中的三参方法被“无效化”，外部调用者传入c参数不会产生任何作用，可能引发误解；类中额外多出一个非接口约定的方法，略显冗余。

方案2：在接口中添加两参默认方法 #

修改DataAdapter接口，新增两参默认方法，默认实现可调用三参方法（传入合理默认值），再让DataAdapterImplF重写该两参方法：

public interface DataAdapter {
    int solve(int a, int b, int c);

    default int solve(int a, int b) {
        // 默认实现，传入预设默认值给c
        return solve(a, b, 0);
    }
}

DataAdapterImplF的实现：

public class DataAdapterImplF implements DataAdapter {
    @Override
    public int solve(int a, int b) {
        // 实际业务逻辑
        return ...;
    }

    @Override
    public int solve(int a, int b, int c) {
        // 可选：抛出异常明确拒绝三参调用，或忽略c调用两参方法
        throw new UnsupportedOperationException("不支持三参数调用");
        // 或 return solve(a, b);
    }
}

优点：接口契约更清晰，明确提供两参调用的标准方式；新实现类可专注于自身需要的两参逻辑。
缺点：修改原有接口后，若其他实现类未重写两参默认方法，外部调用两参方法会触发默认逻辑，需确认是否符合预期；DataAdapterImplF仍需处理三参方法，额外增加代码量。

更优整洁方案：拆分接口（遵循接口隔离原则） #

把原有单一接口拆分为两个职责明确的细粒度接口：

// 基础两参接口
public interface TwoParamDataAdapter {
    int solve(int a, int b);
}

// 继承基础接口，扩展三参方法
public interface ThreeParamDataAdapter extends TwoParamDataAdapter {
    int solve(int a, int b, int c);
}

修改原有实现类：

// 原三参实现类切换为实现扩展接口
public class DataAdapterImplA implements ThreeParamDataAdapter {
    @Override
    public int solve(int a, int b) {
        // 可根据需求实现，或调用三参方法传入默认值
        return solve(a, b, 0);
    }

    @Override
    public int solve(int a, int b, int c) {
        // 原有业务逻辑
        return ...;
    }
}

public class DataAdapterImplB implements ThreeParamDataAdapter {
    @Override
    public int solve(int a, int b) {
        return solve(a, b, 1); // 自定义默认值
    }

    @Override
    public int solve(int a, int b, int c) {
        // 原有业务逻辑
        return ...;
    }
}

新增的DataAdapterImplF只需实现两参接口：

public class DataAdapterImplF implements TwoParamDataAdapter {
    @Override
    public int solve(int a, int b) {
        // 实际业务逻辑
        return ...;
    }
}

优点：

• 接口职责单一，避免“胖接口”带来的契约模糊问题，符合设计原则；
• 原有实现类可平滑过渡，仅需修改接口实现声明，不影响业务逻辑；
• 新实现类无需处理无关的三参方法，代码简洁清爽；
• 调用者可根据需求选择对应接口，避免误用。
  缺点：需修改原有实现类的接口声明，若实现类数量较多，改动量略高于方案1，但从长期维护角度看，收益远大于成本。

方案选择建议 #

• 若为临时需求、追求快速实现且无兼容性风险，优先选方案1；
• 若希望接口契约更清晰，且后续可能有更多类需要两参方法，选方案2；
• 若追求代码长期可维护性与设计合理性，优先选拆分接口的方案，从根源解决接口职责不清晰的问题。

内容的提问来源于stack exchange，提问作者ASHOK KUMAR