如何在Java SDK中弃用内部接口并保持完全向后兼容？

好问题！你遇到的核心问题是让旧接口继承新接口导致强制用户实现新增方法，直接破坏了向后兼容性。这里有两种完美的解决思路，既能完成从Dog到通用Pet的API泛化，又能保证现有用户代码完全无需修改即可正常运行：

方案一：内部委托适配（最推荐，完全隔离新旧API） #

这种方案的核心是让旧的AdoptDog类内部委托给新的AdoptPet实现逻辑，同时保持旧的OnDogAdoption接口完全不变——用户的调用代码不需要做任何改动。

步骤1：定义新的通用Pet API #

这是你希望用户未来迁移使用的API：

public class AdoptPet {
    public interface OnPetAdoption {
        void onPetAdoption(String petName);
    }

    public void adoptPet(final String petName, OnPetAdoption callbackObj) {
        // 这里保留你的异步任务逻辑
        // ...
        callbackObj.onPetAdoption(petName);
    }
}

步骤2：改造旧的AdoptDog类（标记为Deprecated） #

让旧类内部使用新的AdoptPet处理业务逻辑，同时把旧的回调接口适配成新接口：

@Deprecated
public class AdoptDog {
    @Deprecated
    public interface OnDogAdoption {
        void onDogAdoption(String dogName);
    }

    // 内部复用新API的实现
    private final AdoptPet adoptPetDelegate = new AdoptPet();

    @Deprecated
    public void adoptDog(final String dogName, OnDogAdoption callbackObj) {
        // 将旧的OnDogAdoption适配为新的OnPetAdoption
        adoptPetDelegate.adoptPet(dogName, petName -> {
            callbackObj.onDogAdoption(petName);
        });
    }
}

效果验证 #

用户原来的调用代码完全不需要修改，编译和运行都和之前一致：

AdoptDog adoptDog = new AdoptDog();
adoptDog.adoptDog("Snowball", new OnDogAdoption() {
    @Override
    public void onDogAdoption(String dogName) {
        System.out.println("Welcome " + dogName);
    }
});

方案二：默认方法兼容（适合需要旧回调适配新API的场景） #

如果你希望旧的OnDogAdoption实例也能直接在新的AdoptPet API中使用（比如帮助用户逐步迁移），可以利用Java 8+的默认方法来避免用户强制实现新接口的方法：

改造旧的OnDogAdoption接口 #

让旧接口继承新接口，并通过默认方法把新接口的方法适配到旧方法上：

@Deprecated
public interface OnDogAdoption extends AdoptPet.OnPetAdoption {
    void onDogAdoption(String dogName);

    // 默认方法自动适配，用户无需手动实现
    @Override
    default void onPetAdoption(String petName) {
        onDogAdoption(petName);
    }
}

改造AdoptDog类 #

此时AdoptDog可以直接继承AdoptPet，调用父类方法即可：

@Deprecated
public class AdoptDog extends AdoptPet {
    @Deprecated
    public void adoptDog(final String dogName, OnDogAdoption callbackObj) {
        super.adoptPet(dogName, callbackObj);
    }
}

效果验证 #

用户的旧代码依然不需要修改，同时旧的OnDogAdoption实例也可以直接传给AdoptPet的adoptPet方法使用，方便用户逐步迁移到新API。

为什么你的原始方案有问题？ #

你之前让OnDogAdoption继承AdoptPet.OnPetAdoption，但没有提供默认实现，这就导致所有实现了OnDogAdoption的类必须强制实现新增的onPetAdoption方法——这直接违反了"现有代码无需修改"的兼容要求。上面两种方案都避免了这个问题，要么完全隔离新旧接口，要么通过默认方法自动适配。

内容的提问来源于stack exchange，提问作者Michael Osofsky