[NIFI-2899] Update swagger-maven-plugin to 3.0.1 to have a spec-compliant swagger.json

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.0.0
• Fix Version/s: 1.1.0
• Component/s: Documentation & Website
• Assignee: Andy LoPresto
• Reporter: Stephane Maarek
• Created: 13/Oct/16 23:27
• Updated: 14/Oct/16 00:28
• Resolved: 14/Oct/16 00:23

Description

I tried using swagger-codegen with the generated swagger.json but it gave me errors.
I opened a bug report on their project at https://github.com/swagger-api/swagger-codegen/issues/3976, and after investigation, our current swagger-maven-plugin produces a swagger.json file with "type" : "ref" in it. This is non compliant with the specs, and a fix was introduced in https://github.com/kongchen/swagger-maven-plugin/issues/141

Therefore, we need to upgrade the swagger-maven-plugin from 3.0-M1 to 3.0.1. I tested it and it works now with the swagger-codegen plugin. Happy to submit a PR, let me know your thoughts

Issue Links

• links to: GitHub Pull Request #1135