C#中垂直切片架构_C#Vertical Slice教程【推荐】

秋静姑娘_4965

秋静姑娘_4965

2026-05-24

1139人浏览

原创

vertical slice architecture 是一种靠项目结构和命名空间约束落地的组织约定,非语言特性或框架;需按功能建目录(如features/orders/createorder)、统一命名空间、禁止跨切片引用,依赖通过shared项目或接口隔离。

c#中垂直切片架构_c#vertical slice教程【推荐】

Vertical Slice Architecture 不是 C# 语言特性,也不是 .NET 内置功能,它是一种靠项目结构和命名空间约束来落地的组织约定。你不需要安装新 SDK 或升级到 .NET 9 才能用——只要项目能建文件夹、能设引用、能写 IRequest 和 IRequestHandler,今天就能开始。


怎么建第一个切片:从 Controllers 文件夹里搬出来

常见错误是先写好一个 OrdersController,再慢慢“拆”成切片。这几乎注定失败:控制器里混着 DTO、验证逻辑、仓储调用,边界早已模糊。

正确做法是从零新建一个功能目录:

在解决方案根目录下创建 Features/Orders/CreateOrder/ 文件夹

所有类型都放在 Features.Orders.CreateOrder 命名空间下

只允许该目录内互相引用;禁止 Features.Customers.GetCustomerQuery 出现在这个文件夹里的任何类中

接口定义(如 IOrderRepository)必须放在 Application 或 Shared 项目中,且仅被依赖,不反向引用实现

示例入口点只需三样东西:

public record CreateOrderCommand(string CustomerId, List<orderitemdto> Items) : IRequest<result>>;
public class CreateOrderEndpoint : IEndpoint
{
    public void Map(IEndpointRouteBuilder routes) =>
        routes.MapPost("orders", async (CreateOrderCommand cmd, ISender sender) =>
            await sender.Send(cmd));
}
public class CreateOrderHandler : IRequestHandler<createordercommand result>>
{
    private readonly IOrderRepository _repo;
    public CreateOrderHandler(IOrderRepository repo) => _repo = repo;
<pre class="brush:php;toolbar:false;">public async Task<Result<Guid>> Handle(CreateOrderCommand req, CancellationToken ct)
{
    var order = new Order(req.CustomerId);
    foreach (var item in req.Items)
        order.AddItem(item.ProductId, item.Quantity);
    await _repo.AddAsync(order, ct);
    return Result.Success(order.Id);
}

}


MediatR 是最顺手的载体,但不是唯一选项

MediatR 能自然对齐「一个请求 → 一个处理者」的切片语义,但它只是工具。如果你不想引入额外依赖,完全可以用:

原生委托:Func<createordercommand cancellationtoken task>>></createordercommand>

自定义接口:IHandle<trequest tresponse></trequest> + 手动注册

甚至直接在 MapPost 里写业务逻辑(仅限极简原型,不推荐长期使用)

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

关键判断点在于:是否容易阻止跨切片调用?MediatR 的 ISender 是抽象的,天然不暴露 Handler 实现,比直接 new 一个 CreateOrderHandler 更利于隔离。

注意:不要把 MediatR 当作垂直切片的“开关”。禁用它的注册或换掉它,只要切片目录结构、命名空间、引用方向没变,架构就还在。


Shared 项目不是“放公共代码的地方”,而是“防污染的隔离墙”

很多人建一个 Shared 项目,然后往里塞 Result<t></t>、AppException、ValidationFailure,再顺手加个 DateTimeProvider —— 这已经越界了。

Shared 只应包含两类东西:

跨切片通信契约:如 Result<t></t>、IRequest<tresponse></tresponse>、IQuery<tresponse></tresponse>

基础抽象:如 IUnitOfWork、IEmailSender,但它们的实现(SqlUnitOfWork、SmtpEmailSender)必须在具体切片或 Infrastructure 中

一旦你在 Shared 里放了具体实现、DTO 映射逻辑、或某个切片专用的枚举,就等于给所有切片开了后门。后续没人敢动它,因为它“好像哪都在用”。


切片之间真的一点都不能通信?那关联查询怎么办

严格来说,切片之间不能直接引用彼此的 Handler、Query 或 Command 类型。但业务上肯定有依赖,比如「创建订单后发邮件通知客户」。

可行解法只有两种:

事件驱动:在 CreateOrderHandler 末尾发布 OrderCreatedEvent,由另一个切片(如 Notifications/SendOrderConfirmation/)订阅处理

通过共享接口协作:定义 ICustomerService.GetCustomerById(Guid id),实现放在 Customers 切片,但接口声明在 Shared;CreateOrderHandler 只依赖接口,不碰具体实现

别用静态方法、Service Locator 或直接 new 一个跨切片类——这些都会让边界瞬间失效,而且后期根本没法做单元测试隔离。

真正的难点不在技术实现,而在于每次新增一个跨功能调用时,你得停下来问一句:这个依赖是不是真的不可绕过?能不能用事件延迟耦合?有没有更小粒度的接口可以抽出来?这种纪律性,比写十个 IRequestHandler 都难。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c#

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2929

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

2208

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

1180

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

1118

4

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

2023.09.05

1316

5

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

2058

7

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2023.09.20

3240

8

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

2023.09.22

14395

6

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

529

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Conan 2 Essentials 免费课程
Conan 2 Essentials 免费课程

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 高级依赖模型介绍
Conan 2 高级依赖模型介绍

共0课时 | 0人学习