MASA|MASA Framework - 整体设计思路 MASAFramework-整体设计思路

源起年初我们在找一款框架，希望它有如下几个特点：

学习成本低

只需要学.Net每年主推的技术栈和业务特性必须支持的中间件，给开发同学减负，只需要专注业务就好
个人见解：一款好用的框架应该是补充，而不是颠覆或过度创新
对扩展开放

可以按照业务需求任意调整依赖实现，而不被捆绑在一个架构思路上
功能强大却不限制架构，从单体到SOA再到微服务都可以适应

因为一个系统中总有复杂的也有简单的，最好能全面覆盖我们的业务场景
行业不限

既能支持传统行业的业务特殊性，又可以支持互联网行业的高并发特性
稳定性

有严格的测试标准，用起来更安心

契机 【MASA|MASA Framework - 整体设计思路】在我们做技术选型的时候，对Dapr的研究越深入，对我们想要做的事情就越清晰
站在Dapr的设计上我们找到了一个平衡点，Mecha

可以看下这篇文章（Mecha：将Mesh进行到底）： https://skyao.io/talk/202004-...

Mecha的特性

Mecha是通用的，高度可配置的，可重用的组件，提供分布式原语作为现成的能力
Mecha 可以与单个Micrologic组件一起部署(Sidecar模式)，也可以部署为多个共享(注：我称之为Node模式)
Mecha不对Micrologic运行时做任何假设。它与使用开放协议和格式（例如HTTP/gRPC，JSON，Protobuf，CloudEvents）的多语言微服务甚至单体一起使用
Mecha以简单的文本格式（例如YAML，JSON）声明式地配置，指示要启用的功能以及如何将其绑定到Micrologic端点
与其依靠多个代理来实现不同的目的（例如网络代理，缓存代理，绑定代理），不如使用一个Mecha提供所有这些能力

换个角度看Mecha

Mecha提供的是能力，不论是单体还是分布式
Mecha与服务之间交互是有开放API标准的
Mecha可以通过文本格式（Yaml或Json）声明式地配置

对于.Net开发来说，更习惯用Json
应用需要多种多样的能力，Mecha提供了一整套解决方案却不强绑定你所有都要用到，按需即可
每个能力有不同的实现版本，可以根据自身业务情况替换其中某一部分的能力

为什么是Mecha
Mecha的好处是业务逻辑和越来越多的分布式系统问题之间的松耦合，除了可以解决分布式以外，我们是否也可以延展成业务逻辑和架构之间的松耦合？

当然，说到底就是dll而已

文章图片

在分布式架构中，它以Sidecar的形式守护在应用身旁。
如果在.Net项目中，它是否可以类似.Net Framework作为基建/适配器/中间件/总线等身份驻留在.Net进程中提供基础能力？
设计思路一个完整的设计要先从概念开始，为了降低学习成本我们直接复用Dapr的概念定义
概念
构建块提供接口标准，并为了达到某个基础能力的串接不同组件（也通过接口），松耦合但不脱钩
组件基于接口标准的实现，比如服务间通讯提供HttpClient和Dapr Service Invocation等不同组件的实现
工具库提供更抽象的底层能力，供业务和组件完成自身功能，如缓存/配置/数据操作/安全等
Roadmap - v1.0

基于.Net主推技术栈，不魔改，降低学习成本
提供项目模板，根据业务需求自由组合功能集合
支持单体架构，也支持分布式架构
支持DDD方法论，也支持CQRS
尽量小的依赖集合，但不为了小而小
约定优于配置
有创新，且要经过生产验证

文章图片

目前进展
我们首先完成了用于指导架构相关的部分，如DDD、CQRS、Minimal APIs扩展等，并保持单元测试覆盖率在90%以上，目前93%。
以Contrib的目录结构为例：

MASA.Contrib ├── solution items │├── nuget.config ├── src │├── BasicAbility ││├── MASA.Contrib.BasicAbility.DccConfiguration API │├── Configuration ││├── MASA.Contrib.Configuration │├── Data ││├── MASA.Contrib.Data.UoW.EFUnit of work ││└── MASA.Contrib.Data.Contracts.EFProtocol EF version │├── DDD ││├── MASA.Contrib.DDD.DomainIn-process and cross-process support ││└── MASA.Contrib.DDD.Domain.Repository.EF │├── Dispatcher ││├── MASA.Contrib.Dispatcher.EventsIn-process event ││├── MASA.Contrib.Dispatcher.IntegrationEvents.Dapr ││└── MASA.Contrib.Dispatcher.IntegrationEvents.EventLogs.EF Cross-process event │├── ReadWriteSpliting ││└── CQRS │││└── MASA.Contrib.ReadWriteSpliting.CQRSCQRS │├── Service ││└── MASA.Contrib.Service.MinimalAPIsBest practices for [MinimalAPI] ├── test │├── MASA.Contrib.Dispatcher.Events ││├── MASA.Contrib.Dispatcher.Events.BenchmarkDotnetTest ││├── MASA.Contrib.Dispatcher.Events.CheckMethodsParameter.Tests ││├── MASA.Contrib.Dispatcher.Events.CheckMethodsParameterNotNull.Tests ││├── MASA.Contrib.Dispatcher.Events.CheckMethodsParameterType.Tests ││├── MASA.Contrib.Dispatcher.Events.CheckMethodsType.Tests ││├── MASA.Contrib.Dispatcher.Events.OnlyCancelHandler.Tests ││├── MASA.Contrib.Dispatcher.Events.CheckMethodsType.Tests ││├── MASA.Contrib.Dispatcher.Events.Tests │├── MASA.Contrib.Data.UoW.EF.Tests │├── MASA.Contrib.Dispatcher.IntegrationEvents.EventLogs.EF.Tests │├── MASA.Contrib.DDD.Domain.Tests │├── MASA.Contrib.DDD.Domain.Repository.EF.Tests

有什么新功能

Minimal APIs支持类似Controller的API分类聚合
Event Bus支持Hanlder编排、SAGA、Middleware、事务控制、Event和Hanlder解耦模式。相较于MediatR性能仅有0.x%的差距但功能更加强大，可以面对更复杂的业务场景，并且已规划性能优化路线
Integration Event Bus是Event Bus的增强版，支持分布式事务（最终一致性），与Dapr集成
Domain Event Bus是Event Bus和Integration Event Bus的集成版，支持在领域内自动控制进程内与进程外的事件，支持实时发送也支持入栈后统一发送

更多功能等你来体验，也欢迎提意见

什么是MASA MASA = Mesh Application Service Architecture，即网格应用服务架构

除了MASA Framework，我们马上将开源Blazor组件库（MASA Blazor），包括管理后台模板（MASA Blazor Pro）
后续还有MASA Stack开源产品，基于MASA Framework打造的一站式PaaS平台，具备DevOps、微服务观测治理、数据治理等平台级能力

示例 - MASA.EShop MASA.EShop是使用MASA.Framework复刻了eShopOnDapr的功能，并提供了多种架构方式的示例。

支持Docker Compose
dapr component配置
Blazor版EShop网站（正在筹备更换为MASA Blazor Pro的UI）
共享Contracts
所有服务都使用Minimal APIs和Dapr Pub/Sub进行通信
MASA.EShop.Services.Basket演示单体架构，使用Dapr State Management
MASA.EShop.Services.Catalog演示CQRS，使用CQRS、贫血模型
MASA.EShop.Services.Ordering演示CQRS与Actor，使用CQRS、贫血模型、Dapr Actor
MASA.EShop.Service.Payment演示CQRS与DDD，使用CQRS、DDD、充血模型

文章图片

开源地址 MASA.BuildingBlocks：https://github.com/masastack/...
MASA.Contrib：https://github.com/masastack/...
MASA.Utils：https://github.com/masastack/...
MASA.EShop：https://github.com/masalabs/M...
如果你对我们的MASA Framework感兴趣，无论是代码贡献、使用、提Issue，欢迎联系我们