.NET Core3.1 WebApi Swagger接口文档问题

三年丿 2020-04-20 01:28:05

求助,使用.NET Core3.1写的WebApi，配置了Swagger，但是没有Models模块，类库中的实体类等都没有在接口文档中显示，只有一个Schemas,但是这个只能接口写死类型的情况下，实体类才会显示在这里面，如何配置整个类库中的实体显示出来呢

...全文

373 1 打赏收藏转发到动态举报

写回复

1 条回复

切换为时间正序

请发表友善的回复…

发表回复

三年丿 2020-04-20

打赏
举报

回复

附上引用包版本

架构设计：ASP.Net Core 3.1 WebApi+Swagger+Jwt+Autofac。分享初衷：最近在做前后端分离项目，用到了文件上传下载功能，找了很多类似的案例，基本上都是相互转载，很少有原创的(总之找了很久没找到合适的)，最后没有达到我想要的预期效果，故写此篇博客。需求背景：以前在做文件上传下载，都是基于FrameWork项目或者Core Web项目实现的文件上传或下载，基于web的文件下载及权限比较好实现的。但是现在很多公司技术领导层，都在推行前后端分离理念，所以这一次我承担了Core Api 架构设计，采用的是Vue+Core 3.1 WebApi去实现前后端分离. 实现效果图：https://blog.csdn.net/qq_15632461/article/details/108626802

基于博客园大神文章创作的框架，自用，使用的是sqlsugar,后期改成freesql(https://www.cnblogs.com/huguodong/p/13414560.html).使用到的技术有Swagger，JWT权限验证，仓储模式，Sqlsugar+异步泛型仓储，AutoFac，AutoMapper，Serilog

随着微服务架构的流行，REST风格也是大势所趋。那么，什么是REST？如何规范我们的RESTFUL API 文档？本课堂将主要基于以上两个话题进行讨论并探讨在“数字化企业云平台”的实践中如何规范RESTful文档，同时课堂中将引入API Mock的概念并讨论Mock和Doc领域的集成实现。

某架构师review代码后，评价为简洁干练、功能丰富。包含swagger文档、公共的自定义api入参、出参、用户菜单授权协议、错误处理等，可谓开箱修改即用，是你学习或者开发的最佳辅助代码。

.netcore3.1添加swagger及JWT Authorize 验证 JWT 的优缺点相比于传统的 cookie-session 认证机制，优点有：更适用分布式和水平扩展在cookie-session方案中，cookie内仅包含一个session标识符，而诸如用户信息、授权列表等都保存在服务端的session中。如果把session中的认证信息都保存在JWT中，在服务端就没有session存在的必要了。当服务端水平扩展的时候，就不用处理session复制（session replication）/ session黏连（sticky session）或是引入外部session存储了。适用于多客户端（特别是移动端）的前后端解决方案移动端使用的往往不是网页技术，使用Cookie验证并不是一个好主意，因为你得和Cookie容器打交道，而使用Bearer验证则简单的多。无状态化 JWT 是无状态化的，更适用于 RESTful 风格的接口验证。它的缺点也很明显：更多的空间占用 JWT 由于Payload里面包含了附件信息，占用空间往往比SESSION ID大，在HTTP传输中会造成性能影响。所以在设计时候需要注意不要在JWT中存储太多的claim,以避免发生巨大的,过度膨胀的请求。无法作废已颁布的令牌所有的认证信息都在JWT中，由于在服务端没有状态，即使你知道了某个JWT被盗取了，你也没有办法将其作废。在JWT过期之前（你绝对应该设置过期时间），你无能为力。

62,074

社区成员

669,028

社区内容

发帖

与我相关

我的任务

javascript云原生企业社区

社区管理员

加入社区

近7日
近30日
至今

加载中

查看更多榜单

社区公告

.NET 社区是一个围绕开源 .NET 的开放、热情、创新、包容的技术社区。社区致力于为广大 .NET 爱好者提供一个良好的知识共享、协同互助的 .NET 技术交流环境。我们尊重不同意见，支持健康理性的辩论和互动，反对歧视和攻击。

希望和大家一起共同营造一个活跃、友好的社区氛围。

试试用AI创作助手写篇文章吧

+ 用AI写文章