Riccardo Solimena e Stefano Dellafiore Javaday IV Roma 30 gennaio 2010

Transcript

1 Applicazioni RESTful con Jersey Come realizzare un microblog in 10 minuti

2 About us Senior Milano

3 About us Senior Lugano

4 JIP Java Italian Portal Sito Internet - Il portale è stato realizzato e modellato in modo da accompagnare quei programmatori che vivono il proprio lavoro come passione e creatività professionale. Tutte le attività di JavaPortal sono gratuite. La community è sempre lieta di accogliere nuovi collaboratori che contribuiscano all arricchimento del sito,che abbiano nuove idee e la voglia di curarle.

5 Sommario ReST: la teoria ReST e Java: JAX-RS (JSR 311) Le implementazioni di JAX-RS Jersey Demo!

6 ReST: la teoria Cosa NON è ReST Non è (solo) una buzzword Non è un framework Non è un prodotto Non è la soluzione di tutti i problemi

7 ReST: la teoria Cosa è ReST Chiediamolo a Roy* Ciao Roy, cos è questo rest di cui tutti parlano? Representational State Transfer, uno stile architetturale per un sistema di ipermedia distribuito * Roy T. Fielding Ph.D dissertation, Architectural Styles and the Design of Network-based Software Architectures, (2000)

8 ReST: la teoria Cosa è ReST??? Ok, uno stile architetturale è un insieme di vincoli imposti all interazione fra componenti, al fine di ottenere alcune proprietà desiderabili quali scalabilità e uniformità d accesso

9 Ehm... ReST: la teoria Cosa è ReST Sono sicuro che sai di cosa sto parlando. Tempo fa ho scritto l HTTP, lo conosci? Sìsì!! Ecco, bene. Dovevo fare la tesi di dottorato, così ho preso l HTTP, ne ho estratto i principi base e con il marketing abbiamo pensato ad un nome cool. REST è il risultato

10 Principi del REST: Intro IDENTIFICAZIONE UNIVOCA DELLE RISORSE OGNI RISORSA HA UN ID UNIVOCO (AD ESEMPIO URI) INTERFACCIA D ACCESSO UNIFORME LE RISORSE SONO MANIPOLATE ATTRAVERSO LO STESSO INSIEME DI METODI COMUNICAZIONE STATELESS DI RAPPRESENTAZIONI DELLE RISORSE DAI AL CLIENT CIÒ CHE TI CHIEDE! IPERTESTO COME MOTORE DELLO STATO DELL APPLICAZIONE (HATEOAS) INSERISCI LINK ALLE RISORSE CORRELATE NELLA RISPOSTA.

11 Principi del REST: 1 di 4 IDENTIFICAZIONE UNIVOCA DELLE RISORSE OGNI RISORSA HA UN ID UNIVOCO (AD ESEMPIO URI) UNA URL, UNA RISORSA!

12 Principi del REST: 1 di 4 IDENTIFICAZIONE UNIVOCA DELLE RISORSE OGNI RISORSA HA UN ID UNIVOCO (AD ESEMPIO URI) UNA URL, UNA RISORSA!

13 Principi del REST: 2 di 4 INTERFACCIA D ACCESSO UNIFORME LE RISORSE SONO MANIPOLATE ATTRAVERSO LO STESSO INSIEME DI METODI CRUD Create (crea giocatore) Read (recupera giocatore o squadra) Update (aggiorna giocatore) Delete (elimina squadra) DELETE

14 Principi del REST: 3 di 4 COMUNICAZIONE STATELESS DI RAPPRESENTAZIONI DELLE RISORSE DAI AL CLIENT CIÒ CHE TI CHIEDE! non mantengono lo stato Ma chi sei?

15 Principi del REST: 3 di 4 COMUNICAZIONE STATELESS DI RAPPRESENTAZIONI DELLE RISORSE DAI AL CLIENT CIÒ CHE TI CHIEDE! ma eseguono una richiesta GET Nemo location P. Sherman, 42 Wallaby Way, Sydney

16 Principi del REST: 3 di 4 COMUNICAZIONE STATELESS DI RAPPRESENTAZIONI DELLE RISORSE DAI AL CLIENT CIÒ CHE TI CHIEDE! JSON XML {"giocatore": { }} "numero": "10java", "caratteristiche": { } "caratteristica": [ ] {"type": "capelli", "value": "blu"}, {"type": "baffi", "value": "no"}, {"type": "altezza", "value": "185"} <giocatore numero="7java"> <caratteristiche> <caratteristica type="capelli" value="blu" /> <caratteristica type="baffi" value="no" /> <caratteristica type="altezza" value="185" /> </caratteristiche> </giocatore>

17 Principi del REST: 3 di 4 COMUNICAZIONE STATELESS DI RAPPRESENTAZIONI DELLE RISORSE DAI AL CLIENT CIÒ CHE TI CHIEDE! JSON XML

18 Principi del REST: 4 di 4 IPERTESTO COME MOTORE DELLO STATO DELL APPLICAZIONE (HATEOAS) INSERISCI LINK ALLE RISORSE CORRELATE NELLA RISPOSTA. <giocatore numero="7java"> <link href=" rel= squadra"/> <link href=" rel= self"/> <caratteristiche> <caratteristica type="capelli" value="blu" /> <caratteristica type="baffi" value="no" /> <caratteristica type="altezza" value="185" /> </caratteristiche> </giocatore>

19 HTTP è RESTful?

20 HTTP è RESTful

21 HTTP è RESTful Principi REST/HTTP IDENTIFICAZIONE UNIVOCA DELLE RISORSE URI INTERFACCIA D ACCESSO UNIFORME GET,PUT,POST,DELETE (e altro ancora ) COMUNICAZIONE STATELESS DI RAPPRESENTAZIONI DELLE RISORSE Stateless e Content Negotiation (accept/content type) IPERTESTO COME MOTORE DELLO STATO DELL APPLICAZIONE (HATEOAS) Header LINK, redirect, moved

22 Essere RESTful VANTAGGI SVANTAGGI (PER CHI VIENE DA RPC)

23 JAX-RS (JSR 311) JAVA REST JEE JCP API JAVA PER LO SVILUPPO DI WEB SERVICES RESTFUL VERSIONE ATTUALE 1.1 INCLUSA NELLA PIATTAFORMA JEE6 POJO (PLAIN OLD JAVA OBJECT) + ANNOTATION = RISORSA SERVER-SIDE ONLY (CLIENT PREVISTO VERSION 2.0) JAX-RS

24 Risorsa d /blogs/ ) Identifica il frammento di URI alla quale la risorsa risponderà

25 Risorsa d Dependency Injection Principio di Hollywood Non chiamarmi, ti chiamerò io Configurazione dinamica dell URI Info

26 Risorsa d Annotazioni sui metodi della classe che risponderanno alle corrispondenti chiamate HTTP

27 Risorsa d application/json, }) Indica il tipo di rappresentazione che il server dichiara di essere in grado di produrre per quella risorsa

28 Risorsa d application/xml, }) Indica il tipo di rappresentazione che il server dichiara di essere in grado di interpretare

29 Risorsa @FormParam Utility per l estrazione dei parametri dall URL

30 Cosa avviene in pratica 1 di 2 Request HTTP GET Application Resource 1 new Object() Response 200 OK Content-Type: text/xml <xml> </xml> Resource 2 Resource N D.I. Esecuzione

31 Cosa avviene in pratica 2 di 2 DALLE RICHIESTE HTTP IN OGGETTI JAVA MessageBodyReader DAGLI OGGETTI JAVA IN RISPOSTE HTTP MessageBodyWriter

32 Alcune Implementazioni (ad oggi) Reference Implementation JEE6 Configurazione XML Avanzata API Client Avanzata Restlet edition for GWT and Android

33 Il nostro Microblog Creiamo un applicazione web-based che permetta di editare semplici contenuti testuali (tweet) con la possibilità di organizzarli in sezioni. Un microblog collaborativo

34 Microblog - Layers Presentation REST Data DBMS HTML JQuery Jersey JPA EclipseLink MySQL Helper & Converter Glassfish v3

35 Microblog - ER

36 Microblog Class Diagram << JAXB entity >> MicroblogConverter <<create>> << Jersey Resource >> MicroblogResource << wrap >> << entity >> Microblog <<uses>> UriResolver

37 Proxy Javascript Client Server Microblog.js Http MicroblogResource MicroblogConverter Microblog

38 Microblog - Funzionalità Microblog Tweet Creare (POST) Lista (GET) Creare (POST) Lista (GET) Edita (PUT) Cancellazione (DELETE) Cancellazione (DELETE)

39 Cosa realizzeremo POST DELETE GET POST PUT GET DELETE

40 DEMO

41 Riferimenti WEB FREE TIME TWITTER RICCARDO SOLIMENA riccardosolimena.blogspot.com riccardosolimen STEFANO DELLAFIORE WEB FREE TIME losfidantefaleroe.blogspot.com birradiscimmia.blogspot.com

42 Per approfondire

43 Q&A

44 Ringraziamenti