问题标签 [springdoc]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
158 浏览

java - 为什么在 RouterFunctions.DefaultRouterFunction 中使用谓词字段类获取 DefaultErrorWebExceptionHandler?

我正在使用'org.springdoc:springdoc-openapi-webflux-ui:1.2.28'库在我的 spring-boot 应用程序中显示 swagger UI API 文档。http://localhost:8080/swagger-ui.html不起作用,它返回:

很快这个问题:How to display app API documentation by using springdoc-openapi-webflux-ui?

我找到了一个原因。Predicate类的字段RouterFunctions.DefaultRouterFunction<T extends ServerResponse>有时会DefaultErrorWebExceptionHandler作为该对象的值:

在此处输入图像描述

0 投票
3 回答
5901 浏览

java - 使用 Spring Security 允许匿名访问 springdoc-openapi-ui

如何在受 Spring Security 保护的 Spring Boot 应用程序中允许匿名访问springdoc-openapi-ui (OpenAPI 3.0 )?/swagger-ui.html

0 投票
1 回答
9270 浏览

java - 在 springdoc-openapi-ui 中为基本身份验证启用授权按钮

如何在springdoc-openapi-ui (OpenAPI 3.0 /swagger-ui.html) 中启用“授权”按钮以进行基本身份验证。

@ControllerSpring和@Configuration类需要添加哪些注解?

授权按钮

基本认证的授权表格

0 投票
3 回答
19645 浏览

java - 在 springdoc-openapi-ui 中为承载令牌身份验证(JWT)启用授权按钮

如何在springdoc-openapi-ui (OpenAPI 3.0 /swagger-ui.html) 中为承载令牌身份验证启用“授权”按钮,例如 JWT。

@ControllerSpring和@Configuration类需要添加哪些注解?

授权按钮

承载令牌认证的授权表

0 投票
1 回答
155 浏览

angular - 使用生成的客户端代码无法上传文件

我有一个input从本地驱动器中选择文件的简单方法:

选择文件后,我想将其上传到我的服务器。

为此,我实际上使用了一个生成的客户端,它公开了接口:

上传看起来像这样:

但是,它不起作用,因为 POST 请求 URL 如下所示:https://localhost:8443/api/tracks?file=%5Bobject%20Object%5D(对于方法 1 和方法 2),我收到了以下响应:

在服务器端,我有这个端点,它目前负责将该文件存储在其他地方:

我不太确定我必须做什么才能完成这项工作。

我很确定问题是我应该将文件作为Blob. 但是,我找不到将File对象转换为Blob.

0 投票
4 回答
11195 浏览

spring-boot - SpringDoc openAPI 工具未扫描 Spring Boot 项目中的 API

我无法让这个工作。我从一个工作正常的 SpringBoot (v2.2.2) 应用程序和一个工作的 @RestController 开始。为了让 springdoc 工作,我在我的 pom 中包含了以下依赖项:

然后我建立并开始了我的服务。然后我浏览到 api-docs 端点,我得到:

我错过了一步吗?我假设在运行时它会扫描我的代码,找到@RestController,找到@RequestMapping 方法并从中生成api。

作为第二次尝试,我决定用大张旗鼓的@Operation 注释来注释我的一个方法,但仍然没有得到任何东西。

最后,我尝试使用 springdoc.packagesToScan 手动使用我的控制器指定包,但这也不起作用。

这感觉就像 springdoc 没有看到我的控制器 .. 即使 spring 看到了 .. 它非常活跃并且可以工作..

不知道我错过了什么..

这是我的项目依赖项:

这是我项目的树..它是标准的 Spring Boot 结构.. Controller 位于 web dir/package 下

0 投票
1 回答
465 浏览

spring-boot - Springboot2 中对 Kotlin 路由器 DSL 的 OpenAPI 支持

我们正在移动代码库以在 springboot 2 APP 中使用 Kotlin 路由器 DSL。目前我们正在使用带有 OpenAPI 注释的 @RestController 和 kotlin,这工作得很好。

是否有人知道 OpenAPI/Swagger 注释中有任何支持与 RouterFunctions DSL 一起使用?

我使用这个依赖。

0 投票
1 回答
2984 浏览

spring - 如何从 Open API 3 规范全局忽略 Spring Boot 的 API?

我已经浏览了文档:https ://springdoc.github.io/springdoc-openapi-demos/faq.html#how-can-i-ignore-some-field-of-model- ,但是文档不是很清楚,我有Spring Boot REST HATEOAS实现项目并使用Open API 3 规范而不是 Swagger

我已经为每个端点实现了分页,但是我的行业标准如何期望内容作为复数内容。但由于这是 Pageable API 的一部分,我无法覆盖它,而是希望禁用它。有什么建议我们该怎么做?

就像在 Springfox Swagger 中一样,我们可以像下面那样做,在Open API 3 (springdoc-openui)中它的等价物是什么 ?

这是我的终点

0 投票
1 回答
186 浏览

spring - 在 Spring Boot REST Open API 3 中保持相同的 URL 但合同更改?

我正在使用Spring Boot and REST and Open API 3实现。在这个例子中,v1Group 有 List 实现——所有数据都将进入 List,v2Group 中有分页实现——所有数据将以页面的形式出现。

对于消费者,我们不想更改端点 url 以供他们使用。

返回列表的端点。

分页端点

我希望 V1 端点显示在中,GroupedOpenApi而 v2 端点显示在GroupedOpenApi2. 有什么建议么 ?

0 投票
1 回答
4159 浏览

spring-boot - 如何使用springdoc在swagger openapi规范3.0的@RequestBody中创建多个模式?

我有下面的 api,我需要有两个内容类型的参数,application/x-www-form-urlencoded因此我使用@RequestBody 而不是@Parameter

我需要 swagger.json 类似于下面的示例,但我不知道如何使用 springdoc 生成它。我也尝试了@ArraySchema,但我没有得到我需要的输出。我在语法上犯了一些错误,无法在线找到示例。

非常感谢任何帮助。TIA