Developing Faster with Swagger
- 2. What is Swagger?
• A simple, structured way to describe your
API
• Methods, Resources, Parameters, media
types
• Everything your consumers need to know
to consume your API
- 4. Let’s talk Codegen
• We’ve seen code generators before…
– WSDL2Java
– WADL2Java
– W*2*???
– ODataWhere are
all the
projects!???
Too
complicated!
Hard to
customize!
- 8. Workflow
• Client SDKs regenerated, imported with
contract change
– Common practice for F/E & mobile devs
• Server updated by regeneration
– In-place with maven plugin
– “merged” with download from online
• …
- 10. Introducing Swagger Inflector
• Use Swagger as the Source of Truth for
the API
– Automatically route to controllers
– Automatically map models
– Generate Sample Data when controllers not
implemented
https://github.com/swagger-api/swagger-inflector
- 12. Swagger Connected
• Swagger is FOSS
• Specification + Tools at http://swagger.io
• All source at https://github.com/swagger-api
• Real-time support at irc.freenode.net
#swagger