通过Dapr实现一个简单的基于.net的微服务电商系统(十五)—

　　之前有小伙伴在评论区留言说如何集成swagger，最开始没有想透给了对方一个似是而非的回答。实际上后来下来想了一下，用.NET5 提供的Source Generator其实可以很方便的实现接口集成。今天就分享一下集中式接口文档的方案

　　源码生成器（Source Generator）是 C# Roslyn 代码分析器的一个新特性。与.net5同一时间发布了GA版本。开发者可以使用编译器生成的元数据检查用户代码，并生成附加的源文件，与程序的其他部分一起编译。通过这个特性我们可以很容易的在编译阶段静态织入各种代码实现相应功能。所以集中式接口文档实现思路就是在编译阶段通过反射获取到我们的remote/iapplicationservice下的接口类型，通过解析类型和方法生成对应的controller/action代码并织入到程序进程中。这样生成后的应用在启动时swagger组件即可检查到对应的控制器，从而生成相应文档。首先来看看成品：

　　相关代码已经更新至gthub,重新拉取并生成后即可通过 http://swagger.dapreshop.com:30882/swagger/index.html 访问，下面我们讲讲怎么实现的。首先我们需要通过vs2019创建一个空的webapi应用，并勾选“启用OpenApi支持”，这样创建的模板即可自带swagger。接着我们创建一个.net的类库项目，并让webapi引用它。同时注意webapi.csproj需要申明OutputItemType="Analyzer" ReferenceOutputAssembly="false"表示该项目用于代码编译器分析。

    <ProjectReference Include="..\ApiSourceGenerator\ApiSourceGenerator.csproj" OutputItemType="Analyzer" ReferenceOutputAssembly="false" />

　　接着类库项目需要引入nuget：Microsoft.CodeAnalysis.CSharp。这个包就是Generator的本体了。然后我们创建对应的Generator实现类，并继承ISourceGenerator接口。通过这个接口的两个方法我们即可实现代码的分析+织入。在Execute方法里，我们从IApplicationService程序集反射获取我们的所有接口和方法，并通过字符串的形式生成对应的代码文件。最后通过GeneratorExecutionContext的AddSource注入文件并随其他代码一同编译。具体的细节大家有兴趣的可以看看Services\ApiDocument下的代码，实现相对比较简单，这里就不再赘述。api文档生成后调用链也比较简单，其实就是充当了一个反向代理。通过api文档生成的action发起http请求扔给apigateway。和我们在静态页面上调接口是一个模式。

通过Dapr实现一个简单的基于.net的微服务电商系统(十五)——集中式接口文档实现的更多相关文章

通过Dapr实现一个简单的基于.net的微服务电商系统(十六)——dapr+sentinel中间件实现服务保护
dapr目前更新到了1.2版本,在之前4月份的时候来自阿里的开发工程师发起了一个dapr集成Alibaba Sentinel的提案,很快被社区加入到了1.2的里程碑中并且在1.2 release 相关 ...
通过Dapr实现一个简单的基于.net的微服务电商系统(十九)——分布式事务之Saga模式
在之前的系列文章中聊过分布式事务的一种实现方案,即通过在集群中暴露actor服务来实现分布式事务的本地原子化.但是actor服务本身有其特殊性,场景上并不通用.所以今天来讲讲分布式事务实现方案之sag ...
通过Dapr实现一个简单的基于.net的微服务电商系统(十八)——服务保护之多级缓存
很久没有更新dapr系列了.今天带来的是一个小的组件集成,通过多级缓存框架来实现对服务的缓存保护,依旧是一个简易的演示以及对其设计原理思路的讲解,欢迎大家转发留言和star 目录:一.通过Dapr实现 ...
通过Dapr实现一个简单的基于.net的微服务电商系统(十)——一步一步教你如何撸Dapr之绑定
如果说Actor是dapr有状态服务的内部体现的话,那绑定应该是dapr对serverless这部分的体现了.我们可以通过绑定极大的扩展应用的能力,甚至未来会成为serverless的基础.最开始接触 ...
通过Dapr实现一个简单的基于.net的微服务电商系统(十二)——istio+dapr构建多运行时服务网格
多运行时是一个非常新的概念.在 2020 年,Bilgin Ibryam 提出了 Multi-Runtime(多运行时)的理念,对基于 Sidecar 模式的各种产品形态进行了实践总结和理论升华.那到 ...
通过Dapr实现一个简单的基于.net的微服务电商系统(十四)——开发环境容器调试小技巧
之前有很多同学提到如何做容器调试,特别是k8s环境下的容器调试,今天就讲讲我是如何调试的.大家都知道在vs自带的创建项目模板里勾选docker即可通过F5启动docker容器调试.但是对于启动在k8s ...
通过Dapr实现一个简单的基于.net的微服务电商系统(十七)——服务保护之动态配置与热重载
在上一篇文章里,我们通过注入sentinel component到apigateway实现了对下游服务的保护,不过受限于目前变更component需要人工的重新注入配置以及重启应用更新componen ...
通过Dapr实现一个简单的基于.net的微服务电商系统(二十)——Saga框架实现思路分享
今天这篇博文的主要目的是分享一下我设计Saga的实现思路来抛砖引玉,其实Saga本身非常的类似于一个简单的工作流体系,相比工作流不一样的部分在于它没有工作流的复杂逻辑处理机制(比如会签),没有条件分支 ...
通过Dapr实现一个简单的基于.net的微服务电商系统(十一)——一步一步教你如何撸Dapr之自动扩/缩容
上一篇我们讲到了dapr提供的bindings,通过绑定可以让我们的程序轻装上阵,在极端情况下几乎不需要集成任何sdk,仅需要通过httpclient+text.json即可完成对外部组件的调用,这样 ...

随机推荐

Go 类型转换与类型判断
目录 Go 类型转换与类型判断 1.类型转化 2.类型判断 Go 类型转换与类型判断 1.类型转化 T(a) : T 是目标类型 a 是源变量 package main import "fm ...
9. VUE 常用正则表达式
1. 判断输入是否是数字 var numReg = /^[0-9]+$/ var numRe = new RegExp(numReg) if (!numRe.test(number)) { this. ...
【Spring】SpringIoC大致流程
目录 SpringIoC 是什么? 类图大致过程源码分析 SpringIoC 是什么? 官方文档的解释是:IoC也称为依赖注入(DI).在此过程中,对象仅通过构造函数参数,工厂方法的参数或在构 ...
同事写了一个疯狂的类构造器，我要疯了，Builder 模式都不会么？！
疯狂的类构造器最近栈长在做 Code Review 时,发现一段创建对象的方法: Task task = new Task(112, "紧急任务", "处理一下这个任务 ...
数据结构(1):稀疏数组使用java实现
主要是用于数组压缩,去除无效的数组内容: 原数组内容: 0 0 0 0 0 0 1 0 0 0 0 0 0 2 0 0 0 0 0 0 0 0 0 0 0 转换成稀疏数组 5 5 2 1 1 1 2 ...
软件调研——GoodNotes 5与Notability
项目内容这个作业属于哪个课程 2021春季软件工程(罗杰任健) 这个作业的要求在哪里作业要求我在这个课程的目标是积累软件开发经验,提高工程能力这个作业在哪个具体方面帮助我实现目标深入调 ...
C/C++ 实现VA与FOA之间的转换
PE结构中的地址互转,这次再来系统的复习一下关于PE结构中各种地址的转换方式,最终通过编程来实现自动解析计算,最后将这个功能集成到我的迷你解析器中,本章中使用的工具是上次讲解PE结构文章中制作的CMD ...
易酷CMS2.5本地文件包含漏洞复现
易酷CMS是一款影片播放CMS.该CMS2.5版本存在本地文件包含漏洞.我们可以利用这个漏洞,让其包含日志文件,然后再利用报错信息将一句话木马写入日志中.然后利用文件包含漏洞包含该日志文件,再用菜刀连 ...
一个或多个listeners启动失败，更多详细信息查看对应的容器日志文件
碰到这个问题很多次,每次碰到都是去百度找.但是,不尽人意,好在最后还是解决了,所以写下总结. 报错内容: org.apache.catalina.core.StandardContext.startI ...
7 IDEA连接数据库
IDEA连接数据库连接成功后,选择数据库查看数据库/表的内容就双击数据库修改数据库--要点击DB才能保存出现问题错误描述 Server returns invalid timezone. G ...

通过Dapr实现一个简单的基于.net的微服务电商系统(十五)——集中式接口文档实现

通过Dapr实现一个简单的基于.net的微服务电商系统(十五)——集中式接口文档实现的更多相关文章

随机推荐

热门专题