java-service-layer

Java Service 层开发规范

快速开始

生成 Service 层代码的基本步骤：

1. 定义 Service 接口（使用 assets/ServiceInterfaceTemplate.java）
2. 实现 Service 接口（使用 assets/ServiceImplTemplate.java）
3. 配置事务管理（见 references/transaction-management.md）
4. 封装业务逻辑（见 references/business-logic-patterns.md）

接口与实现分离

规范要求

• 定义 Service 接口（Interface）
• 实现类使用 @Service 注解
• 接口命名：XxxService
• 实现类命名：XxxServiceImpl

代码模板

参考 assets/ServiceInterfaceTemplate.java 和 assets/ServiceImplTemplate.java 模板文件。

依赖注入最佳实践

1. 优先使用构造函数注入

@Service
@RequiredArgsConstructor  // Lombok 自动生成构造函数
public class UserServiceImpl implements UserService {
    private final UserRepository userRepository;  // final 字段，不可变
    private final EmailService emailService;
    
    // 依赖明确且可测试，无需 Spring 上下文即可实例化
}

优势：

• ✅ 依赖明确且不可变（final 字段）
• ✅ 可测试性强，无需 Spring 上下文即可实例化
• ✅ IDE 友好，依赖关系清晰
• ✅ 线程安全

2. 处理可选依赖

@Service
@RequiredArgsConstructor
public class NotificationService {
    private final EmailProvider emailProvider;
    private SmsProvider smsProvider;  // 可选依赖
    
    public NotificationService(EmailProvider emailProvider) {
        this.emailProvider = Objects.requireNonNull(emailProvider);
    }
    
    @Autowired(required = false)
    public void setSmsProvider(SmsProvider smsProvider) {
        this.smsProvider = smsProvider;
    }
    
    public void notify(User user, String message) {
        emailProvider.send(user.getEmail(), message);
        if (smsProvider != null) {
            smsProvider.send(user.getPhone(), message);
        }
    }
}

3. 使用 @Qualifier 解决 Bean 歧义

@Service
@RequiredArgsConstructor
public class PaymentService {
    @Qualifier("stripePaymentGateway")
    private final PaymentGateway paymentGateway;
    
    public PaymentResult processPayment(PaymentRequest request) {
        return paymentGateway.charge(request);
    }
}

4. 避免字段注入

// ❌ 不推荐：字段注入
@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;  // 难以测试，依赖不明确
}

// ✅ 推荐：构造函数注入
@Service
@RequiredArgsConstructor
public class UserService {
    private final UserRepository userRepository;  // 明确且可测试
}