swagger-maven-plugin
swagger-maven-plugin copied to clipboard
JAX-RS & SpringMVC supported maven build plugin, helps you generate Swagger JSON and API document in build phase.
`swagger-maven-plugin:3.1.6:generate` maven goal throws a NullPointerException when using generics in requestBody params : ``` Caused by: java.lang.NullPointerException at com.github.kongchen.swagger.docgen.spring.SpringSwaggerExtension.shouldIgnoreType (SpringSwaggerExtension.java:219) at com.github.kongchen.swagger.docgen.spring.SpringSwaggerExtension.extractParameters (SpringSwaggerExtension.java:45) at com.github.kongchen.swagger.docgen.reader.AbstractReader.getParameters (AbstractReader.java:399) at com.github.kongchen.swagger.docgen.reader.SpringMvcApiReader.parseMethod (SpringMvcApiReader.java:314) at...
I ran into an issue that's well described in a known SpringFox bug: https://github.com/springfox/springfox/issues/1605 TL;DR; a byte[] is modelled in swagger file as an Array of byte[]. => when using...
So in situtation where we have success result different as 200 (as denoted by ResponseStatus flag, that information should be considered when generating the swagger, at the moment it is...
Required body parameter is generated like an optional body parameter using Spring-MVC annotation `@ResponseBody` with default value TRUE for required. Even `@ResponseBody(required=true)` does not help. The "required" parameter is ignored...
Caught this updating from 3.1.6 to 3.1.8 Caused by: java.lang.NullPointerException at com.github.kongchen.swagger.docgen.AbstractDocumentSource.toSwaggerDocuments (AbstractDocumentSource.java:203) at com.github.kongchen.swagger.docgen.mavenplugin.ApiDocumentMojo.execute (ApiDocumentMojo.java:130) at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo (DefaultBuildPluginManager.java:137) at org.apache.maven.lifecycle.internal.MojoExecutor.execute (MojoExecutor.java:210) Full stacktrace: https://pastebin.com/Yp57y2Xs
Addresses https://github.com/kongchen/swagger-maven-plugin/issues/575.
(This is perhaps related to https://github.com/kongchen/swagger-maven-plugin/issues/302) We frequently, but not always, observe the following innocuous generation change despite no Swagger or code changes: ``` "file" : { "type" : "file"...
Hi everyone, I'm updating some dependency version in a project and I'm occurring in the following problem. |Library| Version (FROM/TO) | | ------- | ------- | | jakarta.xml.bind-api | 2.3.3...
see this issue here: https://stackoverflow.com/questions/76804907/given-an-existing-jersey-jax-rs-application-is-there-a-way-to-generate-openap basically - we have older code we want a contract on it without having to modify a ton of course code with annotations. I propose...