代码
测试目录两个项目
Basket.FunctionalTests 测试功能, 需要连通第三方组建
BasketScenarios.cs 购物车功能场景测试
做法是创建一个AspNetCore 的 TestServer 并且发起Http请求,验证正确的响应状态码
测试的功能点包括 Post basket , Get basket , Checkout basket , 因为checkout 方法需要使用 Header中一个标识 ,所以扩展了一个类 HttpClientExtensions.cs 来模拟这个Header
使用了AutoAuthorizeMiddleware Mock了验证功能 , 在构建 TestServer的时候注册了这个 BasketTestsStartup
RedisBasketRepositoryTests.cs Redis 的功能测试
Redis的配置在 appsettings.Development.json 中配置的有
Api 目录一个项目
Basket.API
Auth
Swagger Api的验证
Controllers
具体购物车的一些实现,增删改查,还有一个checkout, 这个操作会推送一条 UserCheckoutAccepted事件到消息中
Grpc
gRpc服务的实现类, 类似WCF实现契约的具体类文件 , 不过这里没有契约接口了, 用的Proto协议文件.
Infrastructure
ActionResult
异常返回的结果类, 这里只标记了StatusCode 为500
Exceptions
这里的类没啥用
Filters
全局异常捕获过滤器, Model的参数验证过滤器, 按自己的 JsonErrorReponse格式返回
Middlewares
权限验证, 中断中间件, 模拟手动停用,启用服务
IntegrationEvents
EventHandling
里面有OrderStarted 和 ProductPriceChanged 两个事件处理类
Events
里面有3消息实体 OrderStarted , ProductPriceChanged , UserCheckoutAccepted , 都继承基类 Microsoft.eShopOnContainers.BuildingBlocks.EventBus.Events.EntergrationEvent , 说明垮项目被引用的一些基类都写在了BuildingBlocks里面
事件发布:当用户点击购物车结算时,发布用户结算事件。
事件消费:订单创建成功后,进行购物车的清空
事件消费:商品价格更新后,进行购物车相关商品的价格同步
Model
一些实体类文件
Proto
gRpc的Proto协议文件. VS在编译的时候自动根据项目文件配置的类别生成和协议文件相同的Server抽象服务类或者是client调用类, 需要自己去继承这个类并实现协议中的方法. gRpc 只能在http/2下面使用
Services
身份验证获取类, 从HttpContext 中获取User信息 , 这里封装一了一个接口是为了给单元测试做Mock用的.
Startup.cs
Configure中配置Swagger, 配置验证, 配置gRpc,配置健康检查 , 配置消息总线
ConfigureServices 注册gRpc, 注册过滤器, 注册Swagger,注册验证,注册健康检查,注册Redis ,注册MQ, 注册消息总线, 注册Autofac
下一个项目会分享 Ordering 服务
参考文档
https://github.com/dotnet-architecture/eShopOnContainers/wiki/gRPC#grpc-usage-in-eshoponcontainers
https://www.cnblogs.com/sheng-jie/p/10218839.html