Presentation about Swagger for Torun JUG.

1. O mnie
Open API
Swagger
SpringFox
Demo
Żywa dokumentacja RESTa
Krzysztof Pobożan
29 czerwca 2016
Krzysztof Pobożan Żywa dokumentacja RESTa

2. O mnie
Open API
Swagger
SpringFox
Demo
O mnie
Wieloletni programista PHP, a od 2 lat jako pro-
gramista Java. Zwolennik SCRUMa i BDD.
Email: krzpob@gmail.com
Github: https://github.com/krzpob
Krzysztof Pobożan Żywa dokumentacja RESTa

3. O mnie
Open API
Swagger
SpringFox
Demo
Agenda
1 Open API
2 Swagger
3 SpringFox
4 Demo
Krzysztof Pobożan Żywa dokumentacja RESTa

4. O mnie
Open API
Swagger
SpringFox
Demo
Open API
OAI - fundacja skupiająca się na rozwijaniu i promowaniu niezależnego formatu
opisu API bazującego na specyfikacji Swagger. Strona domowa projektu Open
API Initiative
Rysunek: Członkowie
Krzysztof Pobożan Żywa dokumentacja RESTa

5. O mnie
Open API
Swagger
SpringFox
Demo
Specyfikacja
OpenAPI przejeło Swagger i rozwija go jako wersje 2.0
https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md
Krzysztof Pobożan Żywa dokumentacja RESTa

6. O mnie
Open API
Swagger
SpringFox
Demo
Swagger
Prosta i silna reprezentacja RESTful API niezależna od języka
Podstawowe narzędzia:
Swagger Codegen - generuje kod klienta. Dostępne jako plugin do mavena.
Krzysztof Pobożan Żywa dokumentacja RESTa

7. O mnie
Open API
Swagger
SpringFox
Demo
Swagger
Prosta i silna reprezentacja RESTful API niezależna od języka
Podstawowe narzędzia:
Swagger Codegen - generuje kod klienta. Dostępne jako plugin do mavena.
Swagger UI - dynamicznie generowany sandbox w HTML-u
Krzysztof Pobożan Żywa dokumentacja RESTa

8. O mnie
Open API
Swagger
SpringFox
Demo
Swagger
Prosta i silna reprezentacja RESTful API niezależna od języka
Podstawowe narzędzia:
Swagger Codegen - generuje kod klienta. Dostępne jako plugin do mavena.
Swagger UI - dynamicznie generowany sandbox w HTML-u
Swagger Editor - edycja API online
Krzysztof Pobożan Żywa dokumentacja RESTa

9. O mnie
Open API
Swagger
SpringFox
Demo
Springfox.io
Url: http://springfox.github.io/springfox/ Maven - minimum 1 zależność +
annotacja!
Krzysztof Pobożan Żywa dokumentacja RESTa

10. O mnie
Open API
Swagger
SpringFox
Demo
Springfox.io
Url: http://springfox.github.io/springfox/ Maven - minimum 1 zależność +
annotacja!
springfox-swagger2 - core
springfox-ui - klient REST w przeglądarce
Krzysztof Pobożan Żywa dokumentacja RESTa

11. O mnie
Open API
Swagger
SpringFox
Demo
spring-restdocs
http://projects.spring.io/spring-restdocs/ Generuje wstawki z opisem API do
użycia w ręcznie pisanej dokumentacji w asciidoc
Krzysztof Pobożan Żywa dokumentacja RESTa

12. O mnie
Open API
Swagger
SpringFox
Demo
DEMO
Krzysztof Pobożan Żywa dokumentacja RESTa