jjzjj

swagger-codegen

全部标签

java - Swagger with Spring Boot 2.0 导致 404 错误页面

我正在尝试将我的SpringBoot版本2.0.1.RELEASE与Swagger集成.从这里blogpost似乎只需添加两个Maven依赖项就很容易,一切都应该可以正常工作。所以我在pom中添加了以下依赖:io.springfoxspringfox-swagger22.8.0io.springfoxspringfox-swagger-ui2.8.0并创建了SwaggerConfigbean:@Configuration@EnableSwagger2publicclassSwaggerConfig{@BeanpublicDocketapi(){Docketdocket=newDocke

java - 如何配置 Swagger UI、Jersey 和文件上传?

我有一个Jersey服务,其文件上传方法看起来像这样(简化):@POST@Path("/{observationId:[a-zA-Z0-9_]+}/files")@Produces({MediaType.APPLICATION_JSON})@Consumes(MediaType.MULTIPART_FORM_DATA)@ApiOperation(value="Addafiletoanobservation",notes="AddsafiletoanobservationandreturnsaJSONrepresentationoftheuploadedfile.",response=O

java - 我如何告诉 swagger-codegen 我的自定义生成器?

我正在尝试基于现有的JAX-RS生成器制作自定义swagger代码生成器。我按照Swagger-CodegenGitHub页面上的说明使用命令java-jarmodules/swagger-codegen-cli/target/swagger-codegen-cli.jarmeta-ooutput/myLibrary-nABCCodegen生成了一个模块-pcom.abc.codegen。我创建了我需要的模板并更新了AbcCodegenGenerator.java文件。我在尝试运行代码时遇到了问题。命令java-cpswagger-codegen-cli.jar:ABCCodegen-

java - 使 Swagger 在生成的模型中使用原始 int 和 boolean

默认情况下,对于JSON规范中的"type":"boolean",Swagger将在模型中生成一个Boolean(对象,非原始,可为空)字段。有没有办法让Swagger在模型中生成boolean(原始的、不可为空的)字段?基本原理是:SpringMVC将在无效输入时使用null初始化这些字段,这是非常不受欢迎的。最好保留默认值。同样的问题,intvsInteger。注意:Swagger有自己的“原始”类型概念,这与Java原始类型完全无关,也不是我想要的。 最佳答案 这似乎是不可能的。我看了一下swagger-core和spring

java - 如何使用 Swagger codegen 开发一个简单的 REST 客户端?

我正在学习Swagger以及如何使用Swaggercodegen生成REST客户端。我知道如何用Swagger做文档,我也知道如何用Swagger生成一个简单的REST服务器,但我不知道如何用Swaggercodegen生成一个简单的REST客户端。例如,我有一个简单的应用程序,它是一个REST服务器,我想生成REST客户端。我可以用Swaggercodegen做到这一点吗?REST服务器的Controller:packagecom.dgs.spring.springbootswagger.controller;importio.swagger.annotations.Api;impo

java - Swagger 的 JSON 文件上的空值

我在处理通过Java注释生成的JSONswagger文档时遇到了一些问题(REST使用Jersey公开,序列化由Jackson处理)。查看生成的Swagger,它包含null值,这会导致swaggerUI崩溃(生成的YAML没有这个问题)。这里是JSON的摘录:{"swagger":"2.0","info":{"description":null,"version":"1.0.0","title":"","termsOfService":null,"contact":null,"license":null},"host":"localhost:8080","basePath":"/ap

rest - API Blueprint 与 Swagger 的独特目的是什么?

关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题?更新问题,以便editingthispost可以用事实和引用来回答它.关闭15天前。社区在15天前审查了是否重新打开此问题,并将其关闭:原始关闭原因未解决Improvethisquestion我正在尝试以云原生方式开发应用程序。我正在尝试对我的应用程序进行API优先设计。我应该使用哪个API文档工具?哪个更适合API优先合约?而是哪一个适合哪里?

java - 在 maven jaxb codegen 期间将 DTMManagerDefault 转换为 DTMManager 的 ClassCastException

在尝试运行使用jaxb2插件执行JAXB代码生成的Maven构建时,我遇到了一个奇怪的问题(请参阅下面的堆栈跟踪)。我能想到的最好的是,有一些DTMManager的实现是从与xalan-2.7.1中不同的JAR加载类的;但是,我已经验证用于运行jaxb:generate目标的类路径只有一个包含DTMManager或DTMManagerDefault的xalan-2.7.1.jar-所以我不知道还有什么可能会阻碍.最后一个数据点:我们的构建指定了一个“快照”配置文件,它实际上仅用于将源代码JAR(使用maven-source-plugin)并将它们发布为工件。我在上面描述的失败场景仅发生

java - 如何将 Swagger 与 Maven + Java + Jersey +Tomcat 集成

我似乎无法理解如何集成Swagger来生成API文档。网址:####:8080/MyService/rest/users/getall我在代码和依赖项中添加了注释。我尝试访问:####:8080/MyService/rest/但说找不到。//web.xmlmycompany-users-serlvetcom.sun.jersey.spi.container.servlet.ServletContainercom.sun.jersey.config.property.packagescom.users.services.mycompany,com.wordnik.swagger.jers

java - Springfox/Swagger 中用于返回 ObjectNode 的自定义 ResponseModel

我想使用Swagger为我的SpringBootAPI提供API文档。我设法让Springfox2.3.0正常工作,除了Controller返回ObjectNode之外,一切都按预期工作。Swagger尝试将返回的类(ObjectNode)转换为JSON-Representation,结果是这样的:{"array":true,"bigDecimal":true,"bigInteger":true,"binary":true,"boolean":true,"containerNode":true,"double":true,"float":true,"floatingPointNumbe