草庐IT

$swagger

全部标签

java - Swagger 的 Spring MVC 项目

关于在SpringMVC中集成Swagger:Swagger未显示@RequestMapping的GET/PUT/POST文档在我的SpringMVCRestweb服务应用程序中,我有一个登录Controller和一个学生Controller。我刚刚配置了Swagger来生成RestAPI文档。引用:http://java.dzone.com/articles/how-configure-swagger-generate问题:但是,Swagger只显示类级路径,我猜它不会显示类级@RequestMapping。,方法级映射被忽略。有什么原因吗?@Controller@RequestMa

java - Swagger 不显示继承的对象

我有一个继承自“SuperModel”类的“SubModel”类。我的REST请求返回这些类之一的对象。现在我想记录在我的SwaggerUI中,将返回SubModel的对象或SuperModel的对象。我在谷歌上搜索了这个用例并找到了@ApiModel注释,但它们不起作用,有人知道我在这里做错了什么吗?@ApiModel(value="SuperModel",discriminator="foo",subTypes={SubModel.class})publicclassSuperModel{@ApiModelProperty(required=true)privateStringfo

java - 如何正确使用从 swagger 规范生成的服务器 stub ?

我正在使用Swagger2.0和swagger-codegen(实际上是Maven的swagger-codegen-plugin)来指定、记录和生成API,以Java作为目标语言。该项目已设置为构建服务器stub(JAX-RS)和文档,Eclipse可识别项目buildPath中生成的代码。我不确定从这里开始的正确工作流程是什么。:-/我认为我不应该修改生成的类,否则每当我更改swagger规范时我的更改都会被覆盖,我希望随着开发的进行,我对API的更多思考会改变它。那我该怎么办呢?继承生成的类(哪些?)或将它们包含在我自己的类中? 最佳答案

java - 如何启用 Swagger UI? Tomcat、SpringMVC、REST

我的配置如下:pom.xmlcom.mangofactoryswagger-springmvc0.9.1org.webjarsswagger-ui2.0.24根上下文.xml我将我的应用程序部署到Tomcat8.0。我能够在URI处看到SwaggerJSON数据:http://localhost:8080/myapp/api-docs但我无法运行SwaggerUI。我还应该做什么才能在我的项目中运行SwaggerUI? 最佳答案 诀窍在于您的swagger-uimaven依赖项是一个webjar。您需要配置从您的网络服务器到webj

java - 如何使用 Swagger 在测试中验证 API?

我正在尝试找出让我的API文档成为真实来源的最佳方法,并使用它来理想地通过集成测试或类似的东西来验证实际的JavaREST代码。我们正在使用契约优先或消费者契约类型的方法,因此我们不希望文档必须从带注释的代码生成,并在开发人员每次进行更改时更新。一个想法是使用Swagger,但我不确定如何最好地使用它来验证API。理想情况下,最好在构建或集成测试过程中进行验证,以查看真实响应(以及请求,如果可能)是否符合预期。我知道Swagger有很多用途和工具,我只是想全神贯注于它。或者是否有更好的替代方法来使用Java代码。 最佳答案 最近,我

java - Swagger - 如何使用 swagger-codegen 并长期构建项目

Swagger项目非常适合用各种语言轻松创建客户端和服务器应用程序,但我不明白如何以适当的方式维护或扩展现有项目。我正在生成一个Java服务器-语言参数是jaxrs-spec。我已经编写了自己的Mavenpom并使用了swagger-codegen-maven-plugin,所以现在我可以直接使用maven生成模型或api。我发现每次重建我的项目时,API都会被swagger-codegen插件完全重写。我需要实现我的应用程序逻辑,目前除了自定义生成的API源之外我没有看到任何其他方法。因此,为了避免在每次构建时丢失我的工作,我可以配置.swagger-codegen-ignore(我

java - Swagger-core Scala 依赖项过大

我发现在我开始为我的RESTAPI使用swagger文档工具后,我的war文件的大小增加了近4.5倍,从8.7MB到39MB。我正在使用Maven构建项目。那是因为SwaggerScala的依赖性很大,特别是scala-compiler。所以我试图找出哪些依赖项不是真正需要的。我在项目的Github页面中创建了一个新问题:https://github.com/wordnik/swagger-core/issues/624他们回答说,删除任何scala依赖项不是一个好主意,因为框架是用该语言编写的,这可能会破坏它。还建议将依赖项放在容器/服务器中而不是war中作为解决方法。

SpringBoot集成Swagger UI显示的接口可以显示Json格式的信息说明

介绍      Swagger是一个规范且完整的框架,用于生成、描述、调用和可视化RESTful风格的Web服务。      使用Swagger后可以直接通过代码生成文档,不再需要自己手动编写接口文档,对程序员来说非常方便,可以节约写文档的时间去学习新技术。      提供Web页面在线测试API,参数和格式都定好,直接在界面上输入参数对应的值即可在线测试接口。SpringBoot集成swagger1、导入swagger依赖 io.springfox springfox-boot-starter 3.0.0 com.github.xiaoymin swagger-bootstrap-ui 1.

java - Swagger 的日期字段与日期时间字段

我正在使用swagger来测试我的restapi,我的实体类的一个属性是一个日期字段,我需要yyyy-mm-dd格式的日期,但是swagger模型模式将该字段显示为日期-时间而不是日期字段,因此它给出了带有时间和区域的日期。如何将此日期时间转换为日期字段?我有一个java实体类TimeEntry.java,它的属性之一是Date,它看起来像这样。@ApiModelProperty(required=true)@JsonFormat(pattern=DATE_FORMAT)privateDatedate;对于这个字段,在swaggerUI模型架构中,字段日期显示为“date”:“2016

java - Spring Boot + Swagger + 自定义 swagger-ui.html

我在将war应用程序迁移到springbootjar应用程序时遇到问题。我正在使用springboot1.4.1和swagger2.6.0。要在war中自定义swaggerui,您必须将自定义swagger-ui.html放入/webapp目录。在springboot中,不建议使用webapp目录,因为它在捆绑的jar中不起作用。但是将自定义的swagger-ui.html放入/resources/static将被swagger忽略。是否有任何简单的解决方案(而不是将整个swagger分发添加到我的应用程序中)?我的自定义swagger-ui.html看起来像API.swagger-s