最近在项目中遇到两种情况,准备写个博客记录一下。
情况说明: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 {
@Override
public String say() {
System.out.println("我是BBB");
return "我是BBB";
}
}
@Service
public class CccServiceImpl implements AaaService {
@Override
public String say() {
System.out.println("我是CCC");
return "我是CCC";
}
}
以上代码AAA就有了两个Service实现类,尽管我没有遵循一些明明规则,但是BBB与CCC确实是AAA的实现类,且它们三个都是Service层的组件,接下来我在Controller中注入这两个组件。
@RestController
@RequestMapping("/test")
public class TestController {
@Autowired
private AaaService bbbServiceImpl;
@Autowired
private 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 {
@Autowired
private AaaService aaaService;
}
上面这段代码运行起来之后就会报我们上面说到的报错,该如何解决呢??只需要在@Autowired
上面加上一个注解就可以,写法如下:
@RestController
public class TestController {
@Qualifier("bbbServiceImpl")
@Autowired
private 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 {
@Resource
AaaService 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种解决方案]