-
0 votesanswersviews
昂首阔步不承认api描述
我像这样安排 docket @Bean public Docket api() { return new Docket(DocumentationType.SWAGGER_2) .select() .apis(RequestHandlerSelectors.basePackage("com.config.internal")) ... -
0 votesanswersviews
使用springfox,swagger和gradle生成静态文档[重复]
这个问题在这里已有答案: How to generate swagger.json using gradle? 2个答案 我已经在一个简单的Spring Boot应用程序中评估了 springfox 的集成,暴露了一些REST API . 乍看之下一切正常 - 当应用程序启动时,我可以在JSON endpoints 看到Swagger规范,我可以连接并使用Swagger UI,Swagger注... -
0 votesanswersviews
集中式门户网站上的Spring REST doc
我已经尝试过使用spring boot在springfox swagger上做一些poc . 它确实在我的应用程序运行时在同一主机和端口上生成swagger ui . http://localhost:8080/swagger-ui.html 我的应用程序由部署在 Cloud 基础架构上的多个微服务组成 . 这样我最终可能会有多个swagger hub ui as http://microserv... -
4 votesanswersviews
Swagger2 Spring REST API无法正常工作
我有一个Spring Rest控制器及其NOT spring启动应用程序 . 它只是一个REST API项目 . 我想在我的项目中集成swagger2 . 我尝试了Net和演示中的所有示例,但没有运气 . 当我尝试执行http://localhost:8085/context/swagger-ui.html时,我收到404错误 . 请在下面找到我的问候,如果有任何差异请告诉我 . 任何帮助都非常感... -
1 votesanswersviews
Springfox Swagger2 - @ApiOperation无效
我使用springfox-swagger2作为我的Spring MVC REST API . 一切都很好用,但我的问题是我不能在我的招摇文档中添加额外的信息 . Maven依赖: <!-- Swagger --> <dependency> <groupId>io.springfox</groupId> <artifactId&g... -
2 votesanswersviews
springfox / swagger2与springboot应用程序集成
我是springfox和swagger2的新手 . 我一直在尝试将springfox / swagger2与我的spring boot微服务集成,以生成API文档 . 我按照'http://springfox.github.io/springfox/docs/snapshot/'网站中给出的步骤进行了操作 . 但我没有成功带来api文档页面 . 每当我试图点击URL“http://localhos... -
0 votesanswersviews
如何为swlger为驼峰REST服务生成的api指定'securityDefinitions','security'?
我正在使用Apache Camel和XML定义的DSL实现休息服务 . 其余服务使用camel-swagger-java插件在json中提供Swagger API springfox是替代品吗? api是正确生成的,但缺少securityDefinitions和安全性 . 如何在生成的api中包含它 . 我正在使用basicAuth . 我需要json根目录下面的块 "securityD... -
2 votesanswersviews
如何使用带有swagger ui的ResourceOwnerPasswordCredentialsGrant
我正在使用swagger,swagger ui和spring rest api来获得测试/记录API的平台,所以我需要在swagger ui中使用oAuth2授权,我在授权服务器上使用密码授权,所以我不得不使用 ResourceOwnerPasswordCredentialsGrant 从包含 springfox.documentation.service 的包中有一个参数到其构造函数,即令牌ur... -
20 votesanswersviews
使用带有swagger ui的@RequestParam注释方法
我正在使用 Springfox 库生成REST服务的文档,并在Swagger UI中显示它 . 我按照Springfox documentation的指示行事 . 我有一个控制器,它使用查询字符串中的参数,方法映射如下: @ApiOperation(value = "") @RequestMapping(method = GET, value = "/customco... -
0 votesanswersviews
SpringFox Swagger与Springboot应用程序集成
我按照link中列出的步骤(直到步骤5.1)来集成swagger文档 . 下面是我的控制器类的样子 . 当我尝试访问文档时遇到404错误,类似于使用url> http://localhost:8080/greetingservice/swagger-ui.html在文档中描述的文档 但是我看到使用url http://localhost:8080/swagger-ui.html#!/gree... -
3 votesanswersviews
Swagger使用Spring Data Rest显示错误的id字段
我正在使用Spring Boot Spring DATA REST和Swagger(Springfox 2.7.0) . Spring DATA REST遵循HATEOAS原则,因此id字段永远不会出现在返回资源中 . 在GET方法中,这可以正常工作,但在POST方法中,表单显示了一个id参数,我不明白它来自哪里 . 这是Swagger ui的截图 . 如您所见,表单包含一个类型为path的id... -
42 votesanswersviews
如何配置Spring Security以允许无需身份验证即可访问Swagger URL
我的项目有Spring Security . 主要问题:无法在http://localhost:8080/api/v2/api-docs访问swagger URL . 它表示缺少或无效的授权标头 . Screenshot of the browser window我的pom.xml有以下条目 <dependency> <groupId>io.springfo... -
1 votesanswersviews
Springfox swagger继承支持
有没有办法在springfox swagger(2.7.0)中公开继承/多态?我知道swagger规范支持allOf . springfox支持这个吗?以下是示例域模型 . @ApiModel public abstract class Animal{ private String name; } @ApiModel(parent=Animal.class) public class ... -
0 votesanswersviews
使用swagger和Spring MVC来休息Api文档
嗨'我在我的spring mvc项目中有几个REST api,我想为每个服务创建文档并将其存储在文件中,以便我可以与团队共享 . 我经常阅读有关Swagger或Springfox的内容并进行配置,我补充道 <dependency> <groupId>io.springfox</groupId> <artifactId>springfo... -
1 votesanswersviews
如何在Springfox Swagger UI中配置 Headers ,描述和许可证?
当您在Spring Boot应用程序中使用Springfox启动Swagger UI时,它看起来像这样: 如何配置 Headers 和描述(“Api文档”)和许可证(Apache 2.0) . -
0 votesanswersviews
Java:是否可以使用任何适配器的swagger-core注释?
我想知道是否有可能只在swagger-core annotations上使用jax-rs或springfox等任何适配器的帮助来构建Swagger文档? 为什么要问这个问题:例如当使用springfox时,它依赖于Spring注释,如 @RequestMapping , @ResponseStatus 等 . 想象一下,我想指定一个默认返回201的POST方法: @ApiOperation(val... -
3 votesanswersviews
Swagger API操作订购
如何按字母顺序按方法对操作进行排序,例如: DELETE , GET , POST , PUT . 我已经阅读过这篇文章,但它是用HTML格式的,但就我而言,我已将Swagger集成到Spring Boot中,因此我需要在创建Docket时对其进行排序 . Sort API methods in Swagger UI 然后我在Docket中注意到了这个方法 operationOrdering(... -
0 votesanswersviews
如何将swagger api docs url传递给springfox swagger-ui
我在端口上托管springfox swagger-ui,我还有一个服务托管在另一个端口上 . 我想把我的服务swagger api docs url传递给swagger-ui . 我试过http://localhost:8081/swagger-ui.html?url=http://localhost:8080/v2/api-docs但是我无法加载API定义 . 有没有办法可以做到?我在sprin... -
1 votesanswersviews
Swagger没有显示多个版本的API
在Spring Boot应用程序中,我创建了一个目录“V1_2”,并在目录中添加了一个控制器,这是V1_1中存在的另一个版本的API . 版本控制基于“产生”属性,即1.1产生=“application / v1 . 1json“和1.2”产生= application / v1.2json“ . 但是当我加载swagger UI时,我希望它显示两个API,但它只显示V1_2 . -
1 votesanswersviews
使用Spring重新命名API
我知道在Spring中使用Swagger记录API时,我可以通过添加 @Api 注释来更改API的描述,但是当我按如下方式添加它时 @Api(value= "NEW_NAME", description="NEW_DESCRIPTION") 只更改说明,而不是名称 . 如此处所见 此外,我不确定默认名称和描述的来源,在添加API之前,名称似乎是从控制器名称... -
13 votesanswersviews
如何生成离线Swagger API文档?
我有一个Spring Boot MVC java Web应用程序 . 我已经能够集成Springfox for API文档 . 当服务器启动并运行时,我可以直观地看到所有API . 如何生成OFFLINE swagger API文档?注意:我不想使用asciidoc或markdown文档,但我想在html文件中使用相同的swagger API用户界面 . 我想这样链接是相对于本地目录而不是本地主机... -
4 votesanswersviews
Springfox招摇 - 没有api-docs Spring 季靴子球衣和gradle
我有一个带有jersey和gradle的spring boot应用程序,我正在尝试使用springfox自动生成API文档 . 我按照这里的步骤进行了操作:http://springfox.github.io/springfox/docs/current/ 这是我做的: build.gradle: dependencies { ......... //Swagger c... -
3 votesanswersviews
Springfox Swagger将响应状态200添加到POST和PUT
我正在使用springfox-swagger2版本2.6.1,它会自动为PUT和POST操作插入HTTP 200响应消息,尽管我试图将其配置为不这样做(我没有使用响应状态200进行POST或PUT,但是分别为201和204);见下面的截图: 我已经看到类似问题的答案,其中作者建议将 @ResponseStatus 注释添加到控制器"fix"它,但这变得不灵活,并且违反了Spr... -
1 votesanswersviews
void操作需要在assertj-swagger中使用'produces' swagger定义
我有以下Spring Boot(1.3.1) @RestController 定义: @RequestMapping(value = "/blah", method = DELETE) @ResponseStatus(NO_CONTENT) public void blah() {...} 并使用assertj-swagger来验证上面的以下swagger规范: '/blah... -
2 votesanswersviews
Spring Boot Swagger配置有什么问题需要获取REST API的文档?为什么我无法访问文档?
我正在研究 Spring Boot 应用程序,我正在尝试配置Swagger以自动生成我的REST服务文档 . 我正在学习本教程:http://www.baeldung.com/swagger-2-documentation-for-spring-rest-api 但我发现这样做有些困难 . 基本上我已经在我的 Spring Boot 项目中创建了以下Java配置类: @Configuration ... -
4 votesanswersviews
如何用Swagger描述“ModelAttribute”的最佳方法
我正在尝试将Swagger2集成到基于Spring Boot的应用程序中 . 问题是招摇不考虑模型属性 . @GetMapping(value = "/events", produces = MediaType.APPLICATION_JSON_VALUE) public PagedResources<EventResource> getEvents( ... -
0 votesanswersviews
如何将标记发送到Swagger的 Headers
我有Spring Boot应用程序 . 我想在我的项目中整合招摇 . 我在swagger上使用springfox 2.7.0和auth0进行身份验证,但是从auth0到swagger的头部发送id_token有问题 . 这是我的Swagger配置代码: @Bean public Docket api() { return new Docket(DocumentationType.SWAGGER... -
0 votesanswersviews
Swagger UI无法工作休息APi
我有一个Rest Api项目,我正在尝试使用swagger进行文档和UI . 我能够获得文档但UI没有看到api文档并且空白 . 我已经在webapps / WEB-INF下复制了dist文件夹的内容我可以使用以下方法访问文档:http://localhost:8080/ml-api-ws/v2/api-docs我试图将index.html中的url更改为指向此文档,但是显得空白 . 的webap... -
2 votesanswersviews
添加了Springfox Swagger-UI并且它无法正常工作,我缺少什么?
按照这里的说明: http://www.baeldung.com/swagger-2-documentation-for-spring-rest-api 我将这些依赖项添加到我的项目中: compile "io.springfox:springfox-swagger2:2.7.0" compile "io.springfox:springfox-swagger-ui:... -
1 votesanswersviews
使用Springfox更改Swagger UI的 Headers 和描述
我正在构建一个Spring Boot应用程序,并使用Spring Fox Swagger UI使用Swagger UI对其进行记录 . 我've got everything documented, but want to customize the title and description but can'弄清楚如何 . 例如,在此图像中:https://springfox.github.io...