Java业务类同时承担校验与持久化时,如何按职责重构并拆分组件?
把“修改客户资料”作为例子:收到姓名和手机号后,接口要检查格式、确认手机号没有被其他客户使用,再保存修改。重构时,不要让一个业务类同时负责解析请求、判断所有业务规则和执行数据库写入;可以让应用服务协调流程,把请求校验、业务规则和持久化分别交给合适的组件。
拆分不等于把每一行 if 都搬进新类。关键是明确谁负责哪类判断:接口负责请求格式,领域对象维护自身必须成立的状态,业务规则组件执行需要查询数据的校验,仓储负责读取和保存,应用服务负责按顺序组织这些操作。
先确定各类职责
以 Spring Boot 3、Spring Data JPA 为例,可以按下面的边界整理代码:
| 职责 | 适合放置的逻辑 | 示例 |
|---|---|---|
| 请求对象 | 字段是否缺失、长度和格式是否符合接口约定 | 姓名非空、手机号格式正确 |
| 领域对象 | 对象自身必须维持的不变量 | 客户姓名不能是空白 |
| 业务校验组件 | 需要查询已有数据才能得出的业务结论 | 手机号是否已被其他客户使用 |
| 仓储 | 按条件读取、保存领域数据 | 按手机号检查、更新客户记录 |
| 应用服务 | 组织一次完整业务操作和事务 | 查询客户、校验、修改、保存 |
其中,“手机号是否已被占用”不能只靠请求字段的格式注解判断,因为它依赖数据库里的其他记录。反过来,仓储也不应决定“手机号重复时返回什么业务错误”;它提供查询能力,业务规则组件根据查询结果作出判断。
请求校验放在接口边界
先把 HTTP 请求映射成独立的请求对象。接口字段约束由 Bean Validation 检查,不必在业务服务里重复编写一遍。
package com.example.customer.api;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Pattern;
import jakarta.validation.constraints.Size;
public record UpdateProfileRequest(
@NotBlank
@Size(max = 40)
String displayName,
@NotBlank
@Pattern(regexp = "^\\+?[0-9]{7,15}$")
String phone
) {
}
这里的手机号表达式只是示例:它允许可选的加号和 7 至 15 位数字。项目如果支持分机号、空格或其他号码形式,应按照自己的接口约定调整,而不是把示例正则直接当作通用号码标准。
控制器用 @Valid 触发请求校验,只负责接收参数并调用用例:
package com.example.customer.api;
import com.example.customer.application.CustomerProfileService;
import jakarta.validation.Valid;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/customers")
public class CustomerController {
private final CustomerProfileService profileService;
public CustomerController(CustomerProfileService profileService) {
this.profileService = profileService;
}
@PutMapping("/{id}/profile")
public ResponseEntity<Void> updateProfile(
@PathVariable long id,
@Valid @RequestBody UpdateProfileRequest request) {
profileService.update(id, request);
return ResponseEntity.noContent().build();
}
}
请求格式不符合约束时,Spring 会在调用控制器方法前完成校验。请求格式正确则进入业务流程。这样,HTTP 相关的校验不会散落到持久化代码中。
把依赖数据的判断单独表达
手机号是否被其他客户使用,需要查询仓储。把这条业务规则放进校验组件,组件只判断并反馈结果,不执行保存。
package com.example.customer.application;
import com.example.customer.persistence.CustomerRepository;
import org.springframework.stereotype.Component;
@Component
public class CustomerProfileValidator {
private final CustomerRepository customerRepository;
public CustomerProfileValidator(CustomerRepository customerRepository) {
this.customerRepository = customerRepository;
}
public void validatePhoneAvailable(long customerId, String phone) {
boolean usedByAnotherCustomer =
customerRepository.existsByPhoneAndIdNot(phone, customerId);
if (usedByAnotherCustomer) {
throw new PhoneAlreadyUsedException(phone);
}
}
}
package com.example.customer.application;
public class PhoneAlreadyUsedException extends RuntimeException {
public PhoneAlreadyUsedException(String phone) {
super("手机号已被其他客户使用");
}
}
异常消息没有必要包含完整手机号。若系统日志或错误响应会被更多人员访问,避免把敏感信息直接写入日志和客户端响应。
仓储接口负责表达查询和保存能力:
package com.example.customer.persistence;
import com.example.customer.domain.Customer;
import org.springframework.data.jpa.repository.JpaRepository;
public interface CustomerRepository extends JpaRepository<Customer, Long> {
boolean existsByPhoneAndIdNot(String phone, Long id);
}
Spring Data JPA 可以根据方法名生成查询。校验组件依赖的是仓储的查询能力,而不是自行拼接 SQL 或直接操作数据库连接。保存操作则留给应用服务通过仓储执行。
如果项目规模较大,或者希望领域层不依赖 Spring Data,可以再定义独立的仓储端口,由基础设施层实现。小型业务中直接使用 Spring Data 仓储接口也很常见,不必为了分层额外堆叠一组没有实际价值的转发类。
应用服务负责组织完整流程
应用服务将客户查询、业务校验、领域对象修改和保存串成一次操作,并在这里声明事务。

package com.example.customer.application;
import com.example.customer.api.UpdateProfileRequest;
import com.example.customer.domain.Customer;
import com.example.customer.persistence.CustomerRepository;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
@Service
public class CustomerProfileService {
private final CustomerRepository customerRepository;
private final CustomerProfileValidator profileValidator;
public CustomerProfileService(
CustomerRepository customerRepository,
CustomerProfileValidator profileValidator) {
this.customerRepository = customerRepository;
this.profileValidator = profileValidator;
}
@Transactional
public void update(long customerId, UpdateProfileRequest request) {
Customer customer = customerRepository.findById(customerId)
.orElseThrow(() -> new CustomerNotFoundException(customerId));
String name = request.displayName().trim();
String phone = request.phone();
profileValidator.validatePhoneAvailable(customerId, phone);
customer.changeProfile(name, phone);
customerRepository.save(customer);
}
}
@Transactional 放在应用服务的业务操作上,能让“查询、校验、修改和保存”处于同一事务范围内。校验组件不负责开启事务,也不负责保存;仓储不负责调度整个业务流程。
对于 JPA 管理的实体,在事务内修改已加载的实体通常会由持久化上下文检测变更,显式调用 save 是否必要取决于项目使用方式和代码约定。保留这次调用可以让持久化动作更醒目;若项目统一依赖脏检查,也可以省略,但应保持团队内一致。
让领域对象守住自身不变量
接口校验不能替代领域对象的基本约束。实体也可能由批处理、定时任务或其他应用服务创建,因此不应只依赖某个控制器保证字段永远有效。
package com.example.customer.domain;
import jakarta.persistence.*;
@Entity
@Table(
name = "customer",
uniqueConstraints = {
@UniqueConstraint(
name = "uk_customer_phone",
columnNames = "phone"
)
}
)
public class Customer {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Column(name = "display_name", nullable = false, length = 40)
private String displayName;
@Column(nullable = false, length = 20)
private String phone;
protected Customer() {
}
public void changeProfile(String displayName, String phone) {
if (displayName == null || displayName.isBlank()) {
throw new IllegalArgumentException("客户姓名不能为空");
}
if (phone == null || phone.isBlank()) {
throw new IllegalArgumentException("手机号不能为空");
}
this.displayName = displayName;
this.phone = phone;
}
}
实体方法只维护自身状态的基本合法性,不查询仓储,也不负责把自己写入数据库。实体不需要知道一次修改是从 HTTP 接口、后台任务还是消息消费流程发起的。
这里的唯一约束也很重要。应用层先查询手机号是否重复,能返回清晰的业务错误,但“先查询、后写入”之间仍可能发生并发:两个请求都查到号码未使用,然后同时尝试保存。数据库唯一约束才是最终的数据完整性保障。

生产环境应通过数据库迁移脚本创建或确认唯一索引,不要假设实体注解一定会自动修改已有数据库结构。若并发写入触发唯一约束异常,应在异常处理层识别对应约束并转换为合适的冲突响应;不宜把所有 DataIntegrityViolationException 都笼统转换成“手机号重复”,因为其他字段也可能违反约束。
对外返回有区分度的结果
请求格式错误、客户不存在和手机号冲突属于不同情况,接口应使用不同的状态码或错误码表达。例如:
- 请求字段格式不合法:返回
400 Bad Request。 - 客户记录不存在:返回
404 Not Found。 - 手机号已被其他客户占用:返回
409 Conflict。 - 更新成功:示例接口返回
204 No Content。
可以通过 @RestControllerAdvice 统一映射业务异常和参数校验异常,避免在每个控制器方法里重复写异常处理。响应体可以包含稳定的错误码和面向调用方的说明,但不要把 SQL、数据库约束细节或堆栈信息直接暴露给客户端。
按风险逐步拆分旧业务类
如果旧服务类已经包含查询、校验和保存,不必一次性改写所有调用方。可以沿着一次具体操作逐步迁移:
- 先列出方法中的判断,区分字段格式、对象不变量和需要查库的业务规则。
- 把请求字段约束移到请求 DTO,并确认所有入口是否都经过该 DTO。
- 将需要查询数据的校验提取为独立组件,让它只调用仓储查询并返回校验结果或抛出明确异常。
- 保留应用服务作为流程编排位置,在事务内完成查询、校验、状态修改和保存。
- 为重复校验、记录不存在和更新成功分别补充测试,再检查数据库唯一约束和异常映射。
测试也应对应职责:请求 DTO 或控制器测试检查格式错误;校验组件测试检查手机号重复与可用两种分支;应用服务测试检查流程是否调用正确;数据库集成测试确认唯一约束实际生效。不要只测“服务方法没有抛异常”,否则很难发现校验组件被绕过或保存顺序改变。
完成后,调用 PUT /customers/42/profile 并传入符合约束的姓名和手机号,应用服务会先读取客户,再检查号码是否被其他记录占用,最后修改并保存。格式校验留在接口边界,业务校验与持久化各有明确职责,而应用服务仍保留业务流程的完整视图。
面向承载 Java 业务后台与数据库的部署需求,A5idc数据提供香港、美国、日本等多地物理服务器,覆盖 Xeon Gold 与 AMD EPYC 等平台,并有 SSD、NVMe 等存储配置。不同地区和产品系列具备不同的硬件与网络组合,可为应用服务运行、数据持久化及业务访问提供相应的计算、存储和网络资源。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9822.html



