Java API接口如何扩展

在 Java 中，**API 接口的“扩展”**通常可以从 接口本身、实现方式、架构设计 三个层面来理解。下面我按常见场景给你一个比较系统的说明，并配合示例。

一、接口本身的扩展（最常见）

1️⃣ 接口继承接口（推荐 ✅）

Java 接口支持 多继承，这是一个最标准的扩展方式。

public interface BaseApi {
    void create();
    void delete();
}

public interface UserApi extends BaseApi {
    void updateUser();
    void getUser();
}

✅ 特点：

• UserApi 拥有 BaseApi 的所有方法
• 不破坏原有接口
• 符合开闭原则（对扩展开放，对修改关闭）

2️⃣ 使用 default 方法扩展（Java 8+）

如果你不能修改已有实现类，可以用 default 方法扩展接口。

public interface OrderApi {

    void createOrder();

    default void cancelOrder() {
        System.out.println("默认取消订单逻辑");
    }
}

✅ 使用场景：

• 给老接口增加新方法
• 不强制所有实现类修改

⚠️ 注意：

• default 方法不适合复杂业务逻辑
• 避免接口“膨胀”

二、实现层面的扩展（实现类扩展）

3️⃣ 实现类继承 + 接口实现

public interface PayApi {
    void pay();
}

public class AbstractPayApi implements PayApi {
    protected void beforePay() {
        System.out.println("支付前校验");
    }
}

public class WeChatPayApi extends AbstractPayApi {
    @Override
    public void pay() {
        beforePay();
        System.out.println("微信支付");
    }
}

✅ 好处：

• 公共逻辑抽取
• 避免重复代码

三、API 架构层面的扩展（更“工程化”）

4️⃣ 使用「门面模式 / Facade」扩展 API

对外暴露一个统一 API，内部组合多个接口。

public interface OrderFacadeApi {
    void createOrder();
    void payOrder();
}

public class OrderFacadeApiImpl implements OrderFacadeApi {

    private OrderApi orderApi;
    private PayApi payApi;

    public void createOrder() {
        orderApi.createOrder();
    }

    public void payOrder() {
        payApi.pay();
    }
}

✅ 适合：

• 微服务
• 对外 SDK
• 防止 API 过度暴露

5️⃣ 使用「策略模式」扩展 API 行为

public interface DiscountApi {
    double calculate(double price);
}

public class VipDiscount implements DiscountApi {
    public double calculate(double price) {
        return price * 0.8;
    }
}

✅ 优点：

• 行为可插拔
• 易扩展新策略

四、API 版本的扩展（非常常见）

6️⃣ URL / 版本号扩展（REST API）

/v1/users
/v2/users

或：

public interface UserApiV1 {
    User getUser();
}

public interface UserApiV2 {
    UserDto getUser();
}

✅ 常用于：

• 公共 API
• 对外系统对接

五、Spring 项目中的接口扩展（实战）

7️⃣ Controller 层接口扩展

public interface UserControllerApi {
    UserDTO getUser(Long id);
}

@RestController
public class UserController implements UserControllerApi {

    public UserDTO getUser(Long id) {
        return ...
    }
}

✅ 好处：

• 接口与实现分离
• 方便 Mock / 单元测试
• 方便生成 API 文档（Swagger）

六、扩展 API 的 4 个核心原则（非常重要）

✅ 优先使用 接口继承
✅ 避免修改已有接口（开闭原则）
✅ default 方法只用于“小扩展”
✅ 公共逻辑下沉到抽象类或工具类

七、快速选择指南

如果你有 具体场景（比如：Spring Boot、微服务、SDK、对外接口、老系统改造），可以直接告诉我，我可以给你 更贴近实战的设计方案。