eShopOnContainers .Net 微服务微软官方Demo 分享3 Basket.Api

代码

测试目录两个项目

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