Fastest to Mobile with Scalatra + Swagger
•
2 gefällt mir•2,294 views
Presentation by Tony Tam on using the Scalatra micro web framework with native support for Swagger. This gives the fastest possible server-to-mobile integration with Scala
Empfohlen
Empfohlen
Weitere ähnliche Inhalte
Was ist angesagt?
Was ist angesagt? (20)
Ähnlich wie Fastest to Mobile with Scalatra + Swagger
Ähnlich wie Fastest to Mobile with Scalatra + Swagger (20)
Mehr von Tony Tam
Mehr von Tony Tam (16)
Kürzlich hochgeladen
Kürzlich hochgeladen (20)
Fastest to Mobile with Scalatra + Swagger
- 1. Fastest to Mobile! With Scalatra + Swagger! ! @fehguy!
- 3. Swagger Philosophy! Service documentation sucks! ! typically(
- 4. Swagger Philosophy! • Communicating is too much work! – Users don’t want to write YOUR SDK! – If you’re good at Ruby, you suck at GO! • Consumers need a contract! – Service logic doesn’t belong in the SDK! • Services are plumbing! – We shouldn’t all be plumbers! – Business logic is your business!
- 5. Swagger Philosophy! • Solved by machine-readable, discoverable API contract! • Should speed up, not slow down development process! • External services/proxies not required!
- 6. What is Swagger?! • An interface to your service! – Described in JSON! • It is a contract to your service! • Enables “bigotry-free” restful design with emphasis on getting things done! – Many ways to delete a Pet!
- 7. How does it work?! • Discoverable at runtime, not compile-time! • It’s just JSON! • No server integration required! – You can describe an API that’s not even yours! – Deploy anywhere! Put it on github!! – Swagger is JUST a way to describe an API!
- 8. But Why?! • Machine-readable contract! – Description of *everything* the server can do! – Server-controlled documentation! – Server/language/platform/deployment agnostic! • Documentation, code generation, client generation! – Like Headers for C, Interfaces for Java!
- 9. How do you add Swagger?! • Static Files! – Manually crafted JSON! • Heuristics! – Traffic inspection! • Code inspection! – Code comments, static annotations! • Runtime generation! It’s just JSON!!
- 10. Swagger + Scalatra! • Scalatra is a Lightweight, High- performance Micro web framework! • Extremely clean DSL! • First-class swagger support! • http://www.scalatra.org!
- 11. Scalatra as a REST API!
- 12. Scalatra as a REST API! Content&Type& Nego,a,on&via& json4s&
- 13. Scalatra as a REST API! Content&Type& Nego,a,on&via& json4s& Simple&Rou,ng&
- 14. Scalatra as a REST API! Content&Type& Nego,a,on&via& json4s& Simple&Rou,ng& Param& Extrac,on&
- 15. Scalatra as a REST API!
- 16. Swagger + Scalatra! • Without Swagger Support! • With Swagger Support!
- 17. Swagger + Scalatra! • Auto- generation of swagger JSON!!
- 18. Swagger + Scalatra! • No ugly Java annotations!!
- 19. Swagger + Scalatra! • Model descriptions!
- 20. Swagger + Scalatra! • Model descriptions! Type&safety& has&its& benefits!&
- 21. Swagger UI for “free”!
- 22. Swagger UI for “free”! Your&Boss& can&try&your& API!&
- 23. Going Moble! • If you are good at scala, you probably suck at Objective C!
- 24. Swagger + Mustache! • Typesafe conversion between swagger to Objective C!
- 25. Swagger + Mustache! • Typesafe conversion between swagger to Objective C! Templates& you&can& Tweak!&
- 28. Sharing Libraries with Love!
- 29. Other Mobile SDKs! • Android + Java!
- 30. Other Mobile SDKs! • Android + Java!
- 31. Other Mobile SDKs! • Javascript!
- 32. Scalatra + Swagger! • Simplest DSL for REST APIs in Scala! • Minimal dependencies! • Tested at scale! • Not “hello world”! • Apache 2.0 everything!