如何设计Java库以支持自定义实现，同时提供默认实现？

需求明确：库内置接口E的默认实现A，消费应用可提供自定义实现B（同样实现E），优先使用B，无自定义实现时使用默认的A。结合你使用Spring的场景，提供以下几种实用方案：

方案一：使用@ConditionalOnMissingBean（推荐） #

这是Spring生态中实现“默认Bean+按需覆盖”最常用的方式，核心逻辑是仅当容器中不存在E类型的Bean时，才创建默认实现A。

库端代码修改 #

class A implements E {
    // 默认实现逻辑
}

@Configuration
class D {

    // 仅当容器中无E类型Bean时，注册默认实现A
    @Bean
    @ConditionalOnMissingBean(E.class)
    public E defaultEHandler() {
        return new A();
    }

    @Autowired
    private E e;

    public void config(HttpConfig conf) {
        conf.setHandler(e);
    }
}

消费应用端实现 #

只需将自定义实现B注册为Spring Bean即可，无需额外配置：

@Component // 或通过@Bean在配置类中定义
class B implements E {
    // 自定义实现逻辑
}

原理：@ConditionalOnMissingBean会在Spring初始化时检查容器中是否已存在E类型的Bean。消费应用注册B后，库端的默认A Bean不会被创建，@Autowired自然注入自定义的B。

方案二：使用@Primary注解 #

如果需要消费应用主动标记“优先使用该实现”，可以用@Primary注解。

库端代码 #

class A implements E {
    // 默认实现逻辑
}

@Configuration
class D {

    @Bean
    public E defaultEHandler() {
        return new A();
    }

    @Autowired
    private E e;

    public void config(HttpConfig conf) {
        conf.setHandler(e);
    }
}

消费应用端实现 #

给自定义实现B加上@Primary注解，Spring会优先注入标记了该注解的Bean：

@Component
@Primary
class B implements E {
    // 自定义实现逻辑
}

原理：当容器中有多个同类型Bean时，@Primary会指定优先注入的实例，适合消费应用明确要覆盖默认实现的场景。

方案三：使用@Qualifier限定符（细粒度控制） #

如果需要更精准地指定Bean名称来覆盖，可以结合@Qualifier使用。

库端代码 #

class A implements E {
    // 默认实现逻辑
}

@Configuration
class D {

    @Bean("eHandler")
    public E defaultEHandler() {
        return new A();
    }

    @Autowired
    @Qualifier("eHandler")
    private E e;

    public void config(HttpConfig conf) {
        conf.setHandler(e);
    }
}

消费应用端实现 #

注册同名的Bean即可覆盖默认实现：

@Bean("eHandler")
public E customEHandler() {
    return new B();
}

注意：这种方式依赖Bean的加载顺序，Spring Boot中消费应用的配置通常会优先于第三方库加载，因此可以成功覆盖，但可靠性不如方案一。

内容的提问来源于stack exchange，提问作者Sumeet Kumar Yadav