Clean Code系列之DDD分层参数转换

简介: 从代码中,可以明显看出这是一段处理登陆请求的方法。在大多数项目中,这种代码很常见。它有什么坏味道呢?分层穿透了,LoginRequest类本应该属于入口层,结果穿透到了service层。细细追究,需要明确的问题:1、LoginRequest到底属于哪一层,是resource层,还是service层?2、没有达到DDD防腐层的意义,resource是隔离外部与核心业务的,但却变成了透传。

先看一段简单的代码:

package com.zhuxingsheng.adapter
@PostMapping("/login")
public LoginResponse login(LoginRequest loginRequest) {
    return loginService.login(loginReqeust);
}

从代码中,可以明显看出这是一段处理登陆请求的方法。在大多数项目中,这种代码很常见。

它有什么坏味道呢?

分层穿透了,LoginRequest类本应该属于入口层,结果穿透到了service层。

细细追究,需要明确的问题:

1、LoginRequest到底属于哪一层,是resource层,还是service层?

2、没有达到DDD防腐层的意义,resource是隔离外部与核心业务的,但却变成了透传。

归属哪一层

在《再议DDD分层》[1]中,也讨论过。

当前系统是以REST方式对外提供服务,如果后面需要以RPC方式对外提供服务,显然LoginRequest可能不再适用。


image.png

从图中可以看出REST方式是Controller,而如果是thrift方式是TService。controller的LoginRequest参数,会在TService中失效。在实现层面,LoginRequest本质上就是个DTO,传输数据。而且不再像过去原始servlet,传输数据时会有很多原生API类型,现在的框架都进化了,request对象中只有业务属性。

从这个角度讲,request对象是在resource层,并且是与各个实现框架绑定的。

另外,resource层还需要处理request参数的检验与转换。如果直接透传到service层,不仅加重了service的职责,而且对于service层,我们更推荐使用ADT方式,让代码更有业务语义,不使用单纯的技术基础类型。

总结一下整体结构就是这样:

image.png

DDD防腐层

DDD中有限界上下文,而且限界上下文之间需要高度自治、隔离变化,防腐层因运而生。

而这儿的LoginRequest就是两个限界上下文的通信数据,而核心业务层是有对应的业务对象承接数据。

这样有常见的两个问题

1、代码重复

《DDD实战指南》[2]中提出,我们引入CQRS架构中的概念,业务层有对应cmd和query对象。

如LoginRequest到LoginCmd转换,但两个类的内容都一样

package com.zhuxingsheng.adapter.pl
public class LoginCmd {
    private String username;
    private String password;
}

如果是这样,那我们参数校验逻辑是不是得写到service里面,不然校验逻辑也要重复了。

当测试代码时,controller的测试与service的测试是一致的,use case是相同的。

怎么应对,还是上文提到的ADT方式,对于service层,不再提倡使用技术层面的基本类型,如username属性包装成Username类,而校验逻辑可以封装在Username中

package com.zhuxingsheng.adapter.pl
public class Username {
    private String username;
    public Username(String username) {
        if (username == null) {
            throw   new ValidationException("username不能为空");
        } else if (isValid(username)) {
            throw   new ValidationException("username格式错误");
        }
        this.username = username;
    }
}

这样对于service层的方法业务语义更加显现化。

public void login(Username username,Password password) {
}

对于login方法的测试,use case数量相对基础类型也变少了。

对于复杂对象的转换,可以使用mapstruct,既方便,性能也高效。

2、代码复用

比如创建文章,编辑文章,两者入参差不多,只是创建时没有id,而编辑时有id,从代码复用角度,不想类的膨胀,DTO只创建一个。会出现一个dto会有很多很多的属性。

但从业务语义角度,两个业务行为就不应该共用同一个对象。需要有CreateArticleCmd和EditArticleCmd

而对于request dto的数量,从友好API角度,应该要有两个DTO,但如果是复杂的查询操作,query dto属性数量比command dto更多些。

clean code,这篇主要阐述了分层架构中传输对象与业务对象职责不清问题。

应对策略:

大到一个微服务,小到一个变量,SRP原则无处不在。

DTO属性要明确简单,业务对象要语义清晰显现化。

References

[1] 《再议DDD分层》: https://www.zhuxingsheng.com/blog/further-discussion-on-ddd-layering.html

[2] 《DDD实战指南》: https://www.zhuxingsheng.com/blog/ddd-tactical-practice-guide.html

目录
相关文章
|
存储 设计模式 缓存
DDD领域驱动设计实战-分层架构及代码目录结构(下)
DDD领域驱动设计实战-分层架构及代码目录结构
2481 0
DDD领域驱动设计实战-分层架构及代码目录结构(下)
|
Java 测试技术 网络架构
SpringBoot之请求处理
SpringBoot之请求处理
453 1
|
消息中间件 Java Maven
一文搞懂Spring Boot整合RocketMQ
一文搞懂Spring Boot整合RocketMQ
837 0
|
Java Maven
Maven 3.8.1 报错 Blocked mirror for repositories
Maven 3.8.1 报错 Blocked mirror for repositories
1756 0
Maven 3.8.1 报错 Blocked mirror for repositories
|
8月前
|
机器学习/深度学习 人工智能 安全
零基础保姆级指南!OpenClaw(Clawdbot)阿里云/本地秒级部署接入大模型DeepSeek V3.2教程
2026年,开源AI智能体工具迎来爆发式迭代,OpenClaw(曾用名Clawdbot、MoltBot)凭借轻量化架构、多平台适配、插件化扩展及原生多模型兼容特性,成为个人与轻量团队实现自动化办公、开发辅助、长文本处理的核心工具。其核心优势在于可将自然语言指令转化为实际系统操作,打破传统AI“只说不做”的局限,而DeepSeek V3.2作为2026年开源大模型领域的标杆产品,通过DeepSeek稀疏注意力(DSA)机制、可扩展强化学习框架等核心技术突破,在长上下文处理、复杂推理、工具调用等方面实现跨越式提升,甚至在多项权威基准测试中追平闭源巨头,两者协同可充分释放AI智能体的核心价值。
3058 13
|
8月前
|
Unix API PHP
汇率转换-汇率换算-汇率查询-外汇查询API接口介绍
本API提供实时汇率换算与查询服务,支持全球100+货币,数据每分钟更新。可精准转换金额、查询单币种对多币种汇率,广泛适用于跨境支付、外贸结算、旅游换汇等场景,响应快、覆盖全、集成便捷。
1723 2
|
存储 安全 Java
Spring Security 入门
Spring Security 是 Spring 框架中的安全模块,提供强大的认证和授权功能,支持防止常见攻击(如 CSRF 和会话固定攻击)。它通过过滤器链拦截请求,核心概念包括认证、授权和自定义过滤器。配置方面,涉及密码加密、用户信息服务、认证提供者及过滤器链设置。示例代码展示了如何配置登录、注销、CSRF防护等。常见问题包括循环重定向、静态资源被拦截和登录失败未返回错误信息,解决方法需确保路径正确和添加错误提示逻辑。
1139 2
Spring Security 入门
|
IDE Ubuntu 开发工具
2025年vscode (visual studio code)国内高速下载加速镜像,极速秒下!
Visual Studio Code(简称VSCode)是一款由微软开发的轻量级IDE,支持多种操作系统,以其高效、跨平台和免费的特点受到广泛欢迎。针对国内用户下载速度慢的问题,终于有了国内镜像,访问 https://www.baihezi.com/vscode/download
14579 10
2025年vscode (visual studio code)国内高速下载加速镜像,极速秒下!
|
人工智能 IDE Java
免费用的 AI 工具 CodeGeeX ,开发效率翻倍!!!
AI 会淘汰程序员,但只会淘汰不会用 AI 的程序员。AI可以通过学习和分析大量的性能数据,自动寻找性能瓶颈并进行智能调优,加快软件的响应速度,提升用户体验。此外,AI在软件开发需求分析、自动化测试、代码生成、项目管理、持续集成与部署等方面也有应用,可以节省时间和精力,提高开发速度和质量。就分享到这了。所以AI技术在软件开发领域的应用可以造福程序员。AI可以提供更高效的代码自动生成和智能推荐功能,帮助程序员快速编写高质量的代码。这可以减轻程序员的工作负担,提高开发效率。
1162 1