- html - 出于某种原因,IE8 对我的 Sass 文件中继承的 html5 CSS 不友好?
- JMeter 在响应断言中使用 span 标签的问题
- html - 在 :hover and :active? 上具有不同效果的 CSS 动画
- html - 相对于居中的 html 内容固定的 CSS 重复背景?
我是 Swagger 的新手,据我所知,它用于自动生成 API 文档。除此之外,我认为它还可以通过使用 Swagger Codegen 来生成前端。在这一步,我对在我的项目中正确使用 swagger 感到困惑。
我已经使用 .NET Core 创建了后端,并且 API 方法已准备就绪。现在,我需要将 swagger 集成到我的项目中。我有一个初始的 Angular 前端应用程序,但由于代码是混合的,我想从 stratch 创建前端,然后将 Swagger 集成到其中。所以;
1. 我应该使用必要的 Swagger 工具生成前端吗?看起来不太好,但是如果一般使用的话,随着项目变大不会有问题,我当然可以使用这个选项。
2.如果我从stratch创建Angular项目,如何集成swagger?是否应该使用相关组件的ts文件来生成代码?
3. 如果我向前端添加一个新组件,并向已使用 Swagger 的 API 添加相应的 API 方法。我应该做哪些修改?我尝试了一下,它在构建项目后生成了一个新的 swagger 配置文件。
最佳答案
继续讨论我在问题下发表的评论。
为了澄清什么是 swagger 和 openApi,swagger 既是一个 REST API 规范(例如 swaggerSpec.Json),又是一组处理该规范的工具。例如,swagger codegen、swagger UI 等。现在在某个时间点,该规范已从 swagger 重命名为 OpenApi。
这意味着该规范称为 OpenApi,而 swagger 是一组处理 openApi 的工具。
来源:https://swagger.io/blog/api-strategy/difference-between-swagger-and-openapi/
除了 swagger 之外,还有一组替代工具(例如 NSwag 和 Swashbuckle)可以使使用 openApi 规范变得更加容易。
有两个主要部分:
我研究了所有 3 个选项(Swagger、SwashBuckle 和 NSwag),我选择了 NSwag,因为当时 a) 它是我工作的那个,b) 它具有最多的功能,c) 社区相当不错积极的。这是大约一年前的事。
我将解释我的工作流程,这应该可以回答您的大多数问题。我觉得这个问题变得相当广泛,所以请进行一些挖掘,并尝试根据您的需求找到更具体的问题。
就像我说的,我使用 NSwag 工具链:
我在服务器应用程序中创建 Asp.Net Controller 。这包含 Controller 功能/端点的一些属性,以便更好地生成 swagger 规范:
然后我使用 NSWag studio 创建一个 openApi 文档文件
Startup.cs 中的某处:
public void Configure(IApplicationBuilder app, IWebHostEnvironment env, IOptions<AppSettings> appSettingsAccessor, ILogger<Startup> logger, StaticFileConfigSection staticFileConfig)
{
// Add the openApi document and serve the swagger dashboard.
app.UseOpenApi();
app.UseSwaggerUi3(); // serve Swagger UI
...
然后我可以转到/swagger 查看 Web UI:
就是这样。当然,所有这些工具都可以自动化 - 但我选择不这样做。要让它发挥作用可能会很麻烦,而且在 NSwag studio 中我总是只需点击一下按钮即可。这迫使我对工作更加小心。
关于asp.net - 在 Angular 中使用 Swagger,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/64059809/
我试图对 ASP.Net MVC 有一个高层次的理解,我开始意识到它看起来很像原始的 ASP 脚本。过去,我们将“模型”/业务逻辑代码组织到 VBScript 类或 VB COM 组件中。 当然,现在
我已经搜索了一段时间,但似乎找不到答案。 我想在我的旋转木马中显示一个计数器,左边是当前项目(工作),左边是项目总数。 我的代码:
. 最佳答案 Scott Gu 称这些为代码块。这就是我的看法。 http://weblogs.asp.net/scottgu/archive/2010/04/06/new-lt-gt-syntax
我有一个使用 Visual Studio 2010/.net 4/VB 制作的网站。 我真的很喜欢我发现的 FAQ 系统的布局,因为它很简单,但它是经典的 asp。所以,显然,我不能包括我的母版页布局
好吧,对于你们许多人来说,这个问题可能有一个非常明显的答案,但它让我难住了。 我有一个 asp.net Web 表单,上面有两个控件(嗯,不止这两个,但我们将重点关注这些) - 第一个是 asp:dr
当我将 ASP.NET 复选框控件设置为 asp.net 更新面板的异步回发触发器时,EventName 属性是什么? 最佳答案 我相信它是 CheckedChanged。 关于asp.net - a
我有一个用经典 asp 编写的(巨大的)网站。现在我必须切换到 vb.net (razor)。有没有办法将这两个结合起来直到切换完成? 有没有办法让应用程序与经典的 asp 和 vb.net 一起工作
I am creating a products page, where the user selects an option in a radiobuttonlist for example, an
我最近将一个经典的 ASP 应用程序转换为 ASP.NET 3.5,但我觉得我的经典 ASP 版本要快一些(我不知道可能买家会后悔)。 所以你们能帮我解决这个问题吗,让我知道哪个更快,asp、asp.
从本周开始,我被要求开始学习如何使用 ASP 开发网站。我通过 XNA 对 C# 有一定的经验,所以这部分对我来说并不是什么麻烦。 我一直在关注Music Store Tutorial这需要我设置一个
关闭。这个问题需要多问focused 。目前不接受答案。 想要改进此问题吗?更新问题,使其仅关注一个问题 editing this post . 已关闭 8 年前。 Improve this ques
我想将一些表单变量发布到经典 ASP 页面中。我不想改变经典的 ASP 页面,因为需要完成大量的工作,以及消耗它们的页面数量。 经典的 ASP 页面需要将表单变量 Username 和 Userpas
已结束。此问题正在寻求书籍、工具、软件库等的推荐。它不满足Stack Overflow guidelines 。目前不接受答案。 我们不允许提出寻求书籍、工具、软件库等推荐的问题。您可以编辑问题,以便
在某种程度上,这可能是一个异端问题。我们有一个大型站点,其中许多页面仍在ASP中。通常,并没有真正动态的,而是包括(通过SSI或Server.Execute)定期重新生成的HTML块。看起来好像是一个
关闭。这个问题需要多问focused 。目前不接受答案。 想要改进此问题吗?更新问题,使其仅关注一个问题 editing this post . 已关闭 9 年前。 Improve this ques
我有一个遗留的 ASP 应用程序——在不久的某个时候——需要迁移到 ASP.Net 2.0(以与也在 2.0 中的其他应用程序兼容)。 对于这类事情是否有最佳实践,即作为第一步将当前 html、vbs
我目前在一家公司工作,该公司使用 ASP.NET Webforms 和旧 ASP 页面的组合进行 Web 开发。这对于他们当前的项目来说效果很好,但我想说服/建议他们切换到 ASP.NET MVC,因
我有一个经典的 asp 应用程序。我想将该页面的竞赛表格发布到 Asp.Net 表格。原因是我想在进入数据库之前使用我在 Asp.Net 页面中内置的大量逻辑进行验证,而我对 asp 不太了解。更不用
我知道在 ASP.NET MVC 中,您可以拥有移动 View 并执行类似 Index.mobile.cshtml 的操作。和 _Layout.mobile.cshtml并且服务器知道将这些 View
我需要从一些服务器端 c#.net 代码中调用经典 asp 页面上的 VBscript 函数 - 有谁知道一种干净的方法来做到这一点?在 .net 中重写函数不是一种选择。 我会再解释一下这个问题..
我是一名优秀的程序员,十分优秀!