草庐IT

swagger-tools

全部标签

java - 升级到 Java7 后构建失败,缺少 Tools.jar 和错误的类版本

我最近在我的MacbookPro上升级到Java7。我下载了JDK(不是JRE)。»javacversionjavac1.7.0_17»echo$JAVA_HOME/Library/Java/JavaVirtualMachines/jdk1.7.0_17.jdk/Contents/Home但是,当尝试运行构建时,其中一个Maven编译器插件失败,声称我安装了JRE:»mvninstall[ERROR]executeerrororg.apache.maven.plugin.MojoExecutionException:YouneedtorunbuildwithJDKorhavetools

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

java - 为什么 swagger ui 不显示我带注释的 REST 方法?

我在配置swagger以查看我的REST方法时遇到问题。我在Eclipse和Tomcat7中工作。我有以下简单的REST方法/类:packagecom.rest;importjavax.ws.rs.GET;importjavax.ws.rs.Path;importcom.wordnik.swagger.annotations.Api;importcom.wordnik.swagger.annotations.ApiOperation;@Api(value="/",description="Sayhelloclass")@Path("/")publicclassHello{@GET@Pa

java - Kongchen Swagger 忽略了 @ApiModelProperty 注释

我已尝试在我的Swagger文档中添加更多信息,但我在特定的@ApiPropertyModel注释方面遇到了一些问题。不管我尝试做什么,它就是行不通。该插件正确生成Swagger.json,所有@ApiOperation注释都适用于REST资源,但对于模型部分,它仅内省(introspection)模型类的属性并且不看上面的注释。这是插件的配置方式:com.github.kongchenswagger-maven-plugin3.1.5com.example.rest.resourcescom.example.rest.model${project.build.directory}/g

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 - 谁能向我解释 tools.jar(捆绑在 jdk/lib 文件夹中)的功能以及为什么需要它?

我在java中遇到了tools.jar文件。所以,想知道它到底是做什么用的?我搜索了很多但找不到文档。如果有人可以为我指定它的详细信息,那将非常有帮助,因为我是java的新手。谢谢。 最佳答案 在tools.jar中是JDK而非JRE需要的所有工具。包含在tools.jar中的是例如编译器javac和工具javadoc。此.jar文件中包含用Java开发所需的所有工具。 关于java-谁能向我解释tools.jar(捆绑在jdk/lib文件夹中)的功能以及为什么需要它?,我们在Stack

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代码。 最佳答案 最近,我