1. 概述
作为软件开发人员，我们需要不断地寻找使用给定技术或框架的最佳实践。当然，你给出的观点并不一定是别人认为正确的。
在本教程中，我们介绍@Service注解放置在接口、抽象类或具体类上的不同效果。
2. @Service标注接口
有些人喜欢将@Service放在接口上，因为他们希望：
- 明确表明接口只能用于Service级别目的。
- 定义新的Service实现并在启动期间将它们自动检测为Spring bean。
@Service
public interface AuthenticationService {
boolean authenticate(String username, String password);
}
正如我们所注意到的，AuthenticationService现在变得更具自我描述性。@Service注解的存在可以更明确的提示开发人员仅将其用于业务层，而不用于数据访问层或任何其他层。
通常，这很好，但有一个缺点。通过将@Service放在接口上，我们创建了一个额外的依赖项并将我们的接口与外部库耦合。
接下来，为了测试Service bean的自动检测，让我们创建AuthenticationService的实现类：
public class InMemoryAuthenticationService implements AuthenticationService {
@Override
public boolean authenticate(String username, String password) {
return false;
}
}
我们应该注意，我们的实现类InMemoryAuthenticationService上没有@Service注解。我们只在接口AuthenticationService上添加了@Service。
因此，我们可以在Spring Boot主类中启动Spring应用程序上下文：
@SpringBootApplication
public class AuthApplication {
@Autowired
private AuthenticationService authService;
public static void main(String[] args) {
SpringApplication.run(AuthApplication.class, args);
}
}
当我们运行应用程序时，我们得到异常，并且Spring上下文无法启动：
Field inMemoryAuthService in cn.tuyucheng.taketoday.annotations.service.AuthApplication required a bean of type
'cn.tuyucheng.taketoday.annotations.service.interfaces.AuthenticationService' that could not be found.
因此，将@Service放在接口上不足以自动检测Spring组件。
3. @Service标注抽象类
在抽象类上使用@Service注解并不常见。
让我们对其进行测试，看看它是否达到了让Spring自动检测实现类的目标。
我们定义一个抽象类并添加@Service注解：
@Service
public abstract class AbstractAuthenticationService {
public boolean authenticate(String username, String password) {
return false;
}
}
接下来，我们继承AbstractAuthenticationService类创建一个具体的实现，不使用@Service标注：
public class LdapAuthenticationService extends AbstractAuthenticationService {
@Override
public boolean authenticate(String username, String password) {
return true;
}
}
然后在AuthApplication中注入AbstractAuthenticationService：
@SpringBootApplication
public class AuthApplication {
@Autowired
private AbstractAuthenticationService ldapAuthService;
public static void main(String[] args) {
SpringApplication.run(AuthApplication.class, args);
}
}
我们应该注意到，我们并没有尝试在这里直接注入抽象类，这是不可能的。相反，我们注入具体类LdapAuthenticationService的实例，仅取决于抽象类型。正如里氏替换原则所建议的那样，这是一个很好的做法。
因此，我们再次运行AuthApplication：
Field ldapAuthService in cn.tuyucheng.taketoday.annotations.service.AuthApplication required a bean of type
'cn.tuyucheng.taketoday.annotations.service.abstracts.AbstractAuthenticationService' that could not be found.
正如我们所见，Spring上下文没有成功启动，它以相同的NoSuchBeanDefinitionException异常结束。
当然，在抽象类上使用@Service注解在Spring中没有任何作用。
4. @Service标注具体类
与我们在上面看到的相反，标注实现类而不是抽象类或接口是一种很常见的做法。
这样，我们的目标主要是告诉Spring这个类可以被当作Spring组件类扫描。
因此，Spring将从类路径中自动检测这些类，并自动将它们定义为托管bean。
@Service
public class InMemoryAuthenticationService implements AuthenticationService {
@Override
public boolean authenticate(String username, String password) {
//...
}
}
@Service
public class LdapAuthenticationService extends AbstractAuthenticationService {
@Override
public boolean authenticate(String username, String password) {
//...
}
}
我们应该注意，AbstractAuthenticationService在这里并没有实现AuthenticationService。因此，我们可以独立测试它们：
@SpringBootApplication
public class AuthApplication {
@Autowired
private AuthenticationService inMemoryAuthService;
@Autowired
private AbstractAuthenticationService ldapAuthService;
public static void main(String[] args) {
SpringApplication.run(AuthApplication.class, args);
}
}
当再次运行AuthApplication主类时，不会抛出异常，Spring上下文启动成功。这两个Service都自动注册为bean。
5. 结论
最终，我们看到唯一可行的方法是将@Service放在我们的实现类上，使它们能够被自动检测。Spring的组件扫描不会扫描任何类作为Spring Bean，除非它们被Spring注解标注，即使它们是从另一个@Service注解的接口或抽象类派生的。
此外，Spring的文档还指出，在实现类上使用@Service可以让组件扫描自动检测到它们。
6. 总结
具体来说，将@Service注解放在接口或抽象类上没有任何效果，并且只有具体类在使用@Service注解时才会被自动组件扫描。
与往常一样，本教程的完整源代码可在GitHub上获得。
Post Directory
