当前位置：首页 > news >正文

[SpringBoot]接口的多实现:选择性注入SpringBoot接口的实现类

news 2025/12/21 13:31:17

最近在项目中遇到两种情况，准备写个博客记录一下。

情况说明：Service层一个接口是否可以存在多个具体实现，此时应该如何调用Service（的具体实现）？

其实之前的项目中也遇到过这种情况，只不过我采用的方式是新建了一个Service接口，然后拆分两个实现类，让两个实现类分别实现两个不同的接口，然后在Controller中分别注入两个Service。最近项目中又遇到了这种情况，于是简单研究了一下，一个Service确实是可以有多个实现的，以下介绍4种区分实现类的方式。

^{以下代码本人均已测试，并对一些情况做了补充（欢迎继续补充）。}

文章目录

实现
- 方式1：直接使用实现类类名来区分
- 方式2：`@Qualifier`注解
- 方式3：设置主实现类
- 方式4：使用`@Resource`注解
总结
致谢

实现

方式1：直接使用实现类类名来区分

我在以下代码中直接创建一个接口AaaService，然后让BbbServiceImpl和CccServiceImpl分别来实现AaaService，且BbbServiceImpl和CccServiceImpl注册为Service。

public interface AaaService {String say();
}

@Service
public class BbbServiceImpl implements AaaService {@Overridepublic String say() {System.out.println("我是BBB");return "我是BBB";}
}

@Service
public class CccServiceImpl implements AaaService {@Overridepublic String say() {System.out.println("我是CCC");return "我是CCC";}
}

以上代码AAA就有了两个Service实现类，尽管我没有遵循一些明明规则，但是BBB与CCC确实是AAA的实现类，且它们三个都是Service层的组件，接下来我在Controller中注入这两个组件。

@RestController
@RequestMapping("/test")
public class TestController {@Autowiredprivate AaaService bbbServiceImpl;@Autowiredprivate AaaService cccServiceImpl;@GetMapping("/b")public String BBB(){return bbbServiceImpl.say();}@GetMapping("/c")public String CCC(){return cccServiceImpl.say();}}

这时候我们启动项目，通过浏览器分别访问/test/b与/test/c地址，情况如下：

/test/b：我是BBB（且后端控制台也输出：我是BBB）
/test/c：我是CCC（且后端控制台也输出：我是CCC）

因此，我们确实在Controller层同时注入了一个Service的两个实现类。

方式2：`@Qualifier`注解

通常情况下，如果注入的B与C的变量名没有遵循与实现类同名（小驼峰）的命名方式的话，项目会启动失败，并且报错如下：

Action:Consider marking one of the beans as @Primary, updating the consumer to accept multiple beans, or using @Qualifier to identify the bean that should be consumed

表现如下：

在这里插入图片描述

这是在提示我们使用@Qualifier注解来区分两个实现类（使用方式一也是可以的）。在一些情况下，我们虽然一个Service有多个实现类，但是我们依旧想用最传统的方式，也就是接口名小驼峰的方式来作为它的实现类来使用，但是很明显，像是下面这段代码在该情况下是不能生效的，因为我们并没有一个叫AaaService的实现类。

@RestController
public class TestController {@Autowiredprivate AaaService aaaService;
}

上面这段代码运行起来之后就会报我们上面说到的报错，该如何解决呢？？只需要在@Autowired上面加上一个注解就可以，写法如下：

@RestController
public class TestController {@Qualifier("bbbServiceImpl")@Autowiredprivate AaaService aaaService;
}

^{注意，注解中写的内容必须是该Service接口的某个实现类的小驼峰名称。}

这样一来，我们就在该Controller中注入了BbbServiceImpl，只不过它的名称是aaaService，在后续使用中，我们调用的也是BbbServiceImpl种的方法。

方式3：设置主实现类

通过以上两种方式，我们已经可以实现自由的选择我们具体要注入的是哪一个实现类，但是如果业务中有这样的一个场景：我默认下只使用A实现类，BC实现类是我在特殊情况下才去使用的。在这种情况下，我希望能有一种“默认”机制的出现，该如何实现呢？请看以下代码:

public interface AaaService  {// ...  
}@Service
@Primary // 注意这一个注解
public interface BbbServiceImpl implements AaaService {// Aaa的实现 ...
}@Service
public interface CccServiceImpl implements AaaService {// Aaa的实现 ...
}

在以上代码中，由于B实现上面有一个@Primary注解，因此该实现类会被当做是A接口的主要实现类，这时候我若是未指明具体使用的是哪一个实现类（就不会报错啦），就会默认用的是B实现类。

这时候又出现了一个小问题，如果这时候我想用C，该怎么办呢？换种方式问一下：命名这个东西是随便写的，如果我们恰巧如方式1中所说的，我变量名命名成了cccServiceImpl，它注入的是B还是C呢？答案揭晓：是B。在此种情况下，用命名来区分实现类的方式已经失效了，要是想使用其他的实现类，只能使用方式二中的@Qualifier注解来区分。

方式4：使用`@Resource`注解

正如方式3中所说，我们设置了@Primary之后，已经无法通过@Autowired注解去控制注入哪个实现类了，但是有没有一种方法还是可以用名称去选择呢？当然可以，那就是@Resource注解。

因为Resource注解默认使用名称进行依赖注入，所以情况3中的代码不变，我们对Controller做如下修改：

@RestController
public class TestController {@ResourceAaaService cccServiceImpl;@GetMapping("/test")public String test() {return cccServiceImpl.say();}}

在以上代码中，虽然我们已经对AaaService设置了默认实现类BbbServiceImpl，但是使用@Resource注解注入了名称为cccServiceImpl的实现，这时候访问/test，得到的字符串依旧是"我是CCC"。

总结

结论：一个Service可以有多个实现，且我们可以手动选择具体使用的哪个实现
使用@Autowired且没有做过多操作（如设置默认实现）的情况下，我们可以使用注入的变量名称（一定是小驼峰）的方式选择变量名，也可以在@Autowired上面添加@Qualifier("实现类的小驼峰")的方式来选择具体实现类。
我们可以在接口实现类上写上@Primary注解来认证该实现类为主实现类，在该情况下，如果不特意指定是哪个实现类，则一律认为是默认实现类。
当指定了默认实现类之后，使用@Autowired+小驼峰名称的注入方式，已经无法指定特定实现类，只能使用``@Qualifier(“实现类的小驼峰”)@+@Autowired或@Resource + 小驼峰命名`的方式进行区分。

致谢

感谢 [CSDN | springboot中一个service接口多个实现类，如何注入]

感谢 [稀土掘金 | spring接口多实现类，选择性注入的4种解决方案]