- 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/
我在网上搜索但没有找到任何合适的文章解释如何使用 javascript 使用 WCF 服务,尤其是 WebScriptEndpoint。 任何人都可以对此给出任何指导吗? 谢谢 最佳答案 这是一篇关于
我正在编写一个将运行 Linux 命令的 C 程序,例如: cat/etc/passwd | grep 列表 |剪切-c 1-5 我没有任何结果 *这里 parent 等待第一个 child (chi
所以我正在尝试处理文件上传,然后将该文件作为二进制文件存储到数据库中。在我存储它之后,我尝试在给定的 URL 上提供文件。我似乎找不到适合这里的方法。我需要使用数据库,因为我使用 Google 应用引
我正在尝试制作一个宏,将下面的公式添加到单元格中,然后将其拖到整个列中并在 H 列中复制相同的公式 我想在 F 和 H 列中输入公式的数据 Range("F1").formula = "=IF(ISE
问题类似于this one ,但我想使用 OperatorPrecedenceParser 解析带有函数应用程序的表达式在 FParsec . 这是我的 AST: type Expression =
我想通过使用 sequelize 和 node.js 将这个查询更改为代码取决于在哪里 select COUNT(gender) as genderCount from customers where
我正在使用GNU bash,版本5.0.3(1)-发行版(x86_64-pc-linux-gnu),我想知道为什么简单的赋值语句会出现语法错误: #/bin/bash var1=/tmp
这里,为什么我的代码在 IE 中不起作用。我的代码适用于所有浏览器。没有问题。但是当我在 IE 上运行我的项目时,它发现错误。 而且我的 jquery 类和 insertadjacentHTMl 也不
我正在尝试更改标签的innerHTML。我无权访问该表单,因此无法编辑 HTML。标签具有的唯一标识符是“for”属性。 这是输入和标签的结构:
我有一个页面,我可以在其中返回用户帖子,可以使用一些 jquery 代码对这些帖子进行即时评论,在发布新评论后,我在帖子下插入新评论以及删除 按钮。问题是 Delete 按钮在新插入的元素上不起作用,
我有一个大约有 20 列的“管道分隔”文件。我只想使用 sha1sum 散列第一列,它是一个数字,如帐号,并按原样返回其余列。 使用 awk 或 sed 执行此操作的最佳方法是什么? Accounti
我需要将以下内容插入到我的表中...我的用户表有五列 id、用户名、密码、名称、条目。 (我还没有提交任何东西到条目中,我稍后会使用 php 来做)但由于某种原因我不断收到这个错误:#1054 - U
所以我试图有一个输入字段,我可以在其中输入任何字符,但然后将输入的值小写,删除任何非字母数字字符,留下“。”而不是空格。 例如,如果我输入: 地球的 70% 是水,-!*#$^^ & 30% 土地 输
我正在尝试做一些我认为非常简单的事情,但出于某种原因我没有得到想要的结果?我是 javascript 的新手,但对 java 有经验,所以我相信我没有使用某种正确的规则。 这是一个获取输入值、检查选择
我想使用 angularjs 从 mysql 数据库加载数据。 这就是应用程序的工作原理;用户登录,他们的用户名存储在 cookie 中。该用户名显示在主页上 我想获取这个值并通过 angularjs
我正在使用 autoLayout,我想在 UITableViewCell 上放置一个 UIlabel,它应该始终位于单元格的右侧和右侧的中心。 这就是我想要实现的目标 所以在这里你可以看到我正在谈论的
我需要与 MySql 等效的 elasticsearch 查询。我的 sql 查询: SELECT DISTINCT t.product_id AS id FROM tbl_sup_price t
我正在实现代码以使用 JSON。 func setup() { if let flickrURL = NSURL(string: "https://api.flickr.com/
我尝试使用for循环声明变量,然后测试cols和rols是否相同。如果是,它将运行递归函数。但是,我在 javascript 中执行 do 时遇到问题。有人可以帮忙吗? 现在,在比较 col.1 和
我举了一个我正在处理的问题的简短示例。 HTML代码: 1 2 3 CSS 代码: .BB a:hover{ color: #000; } .BB > li:after {
我是一名优秀的程序员,十分优秀!