I will show you how fast and easily can you build RESTful API using Lionframe

1. Lionframe
Rapid RESTful API development
powered by

2. Michał Marcinkowski
Współzałożyciel LAKION
Miłośnik Symfony2 i Open Source

3. ?Co to jest API

4. Application
Programming
Interface

5. User Interface

6. User Interface

7. Software-to-software
Interface

8. Amazon Client
My website Client
API
UI
UI

9. wykorzystanie API
• Współdzielenie treści i danych pomiędzy
aplikacjami/systemami
• Budowanie aplikacji korzystających z serwisu

10. ?Czy każda aplikacja
zależy od jakiegoś API

11. ?Czy każda aplikacja
zależy od jakiegoś API
TAK!

12. REST

13. CECHY REST
• Bezstanowość
• Cache
• Jednolitość interfejsów
• Oparte na standardach (HTTP, URL, XML, JSON)
• Niezależność od platformy i języka
• Może być stosowane w obecności firewalli
• Prostota

14. Prostota REST
POST / HTTP/1.1
Host: www.example.org
Content-Type: application/soap+xml; charset=utf-8
Content-Length: 300
<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
<soap:Body xmlns:m="http://www.example.org/">
<m:GetUserDetails>
<m:UserID>12345</UserID>
</m:GetUserDetails>
</soap:Body>
</soap:Envelope>
GET /users/12345 HTTP/1.1
Host: www.example.org
Accept: application/json

15. Dojrzałość REST
Richardson Maturity Model

16. Level 0
THE SWAMP OF POX
• Protokół jako tunel dla
request-response (zazwyczaj HTTP)
• Jeden entry point URI
• Jeden rodzaj metody (w HTTP,
zazwyczaj metoda POST)

17. Backend
system
Mobile
application
appointmentService
POST <openSlotRequest
POST <appointmentRequest
Level 0
THE SWAMP OF POX

18. Level 1
RESOURCES
• Wiele URIs
• Każdy URI inny resource
• Jeden rodzaj metody (POST)

19. Backend
system
Mobile
application
doctors/jdoe
POST <openSlotRequest
POST <appointmentRequest
slots/1234
Level 1
RESOURCES

20. Level 2
HTTP VERBS
• Używanie poprawnych metod
• Używanie poprawnych kodów odpowiedzi

21. Level 2
HTTP VERBS
• GET
• POST
• PUT
• PATCH
• DELETE

22. HTTP CODES
• 2xx Success
• 200 OK
• 201 Created
• 204 No Content
• 3xx Redirection
• 301 Moved Permanently
• 5xx Server Error
• 500 Internal Server Error
• 503 Service Unavailable
• 4xx Client Error
• 400 Bad Request
• 401 Unauthorized
• 403 Forbidden
• 404 Not Found
• 405 Method Not Allowed
• 409 Conflict

23. Level 3
Hypermedia controls
• Używanie HATEOAS do odkrywania
możliwości API

24. DEMO
Time

25. /**
* @AssertNotBlank()
*/
private $firstName;
VALIDATIOn

26. SERIALIZACJA
#src/Acme/DemoBundle/Resources/config/serializer/Entity.Player.yml
AcmeDemoBundleEntityPlayer:
exclusion_policy: ALL
xml_root_name: player
properties:
id:
expose: true
type: integer
xml_attribute: true
firstName:
expose: true
type: string
lastName:
expose: true
type: string

27. HATEOAS
#src/Acme/DemoBundle/Resources/config/serializer/Entity.Player.yml
AcmeDemoBundleEntityPlayer:
exclusion_policy: ALL
xml_root_name: player
properties:
id:
expose: true
type: integer
xml_attribute: true
firstName:
….
relations:
- rel: self
href:
route: acme_api_player_show
parameters:
id: expr(object.getId())

28. Z czego składa się LIONframe

29. Sylius Resource Bundle
• Domyślny kontroler
• Domyślny routing
• Domyślne repository z paginacją
• Aliasy do serwisów dla managerów, repository,
kontrolerów
• Podstawowe filtrowanie i sortowanie
• Wywołuje zdarzenia (events)

30. FOS REST BUNDLE
• Wykrywa format po nagłówach HTTP
• Wybiera i zwraca response w porządanym
formacie
• Integruje kontroler z serializerem

31. JMS Serializer BUNDLE
• Serializuje dane do opowiedniego formatu
• Łatwo konfigurowalny serializer

32. BaZinga hateoas Bundle
• Dodaje linki relacji
• Obsługuje XML i JSON
• Łatwo konfigurowalne relacje

33. @micmarcinkowski
@Lakion
lakion.com/lionframe
„Time is money”
Benjamin Franklin

34. Image Credits
http://martinfowler.com/articles/
richardsonMaturityModel.html
https://www.flickr.com/photos/kwl/4247555680