Dezvoltarea aplicatiilor orientate spre servicii Web. De la REST la mash-up-uri si API-uri

Dr.SabinBuragawww.purl.org/net/busaco
Dezvoltarea aplicatiilor Web
de la servicii Web la API-uri deschise

“Prima calitate a stilului este claritatea.”
Aristotel

Care sunt scopurile Web-ului?

Constituirea si interactiunea
cu un spatiu de comunicare inter-umana
partajarea cunostintelor

Constituirea si interactiunea
cu un spatiu de comunicare inter-umana
partajarea cunostintelor
Web social (“Web 2.0”), Web-ul datelor (semantic),…

Exploatarea puterii computationale
accesul la Web se poate realiza
via dispozitive avand resurse reduse

Exploatarea puterii computationale
accesul la Web se poate realiza
via dispozitive avand resurse reduse
Web ubicuu (omniprezent), Web mobil, Web 3D,…
performantaasigurarea scalabilitatii

Cum pot fi accesate & procesate resursele
– date, informatii, cunostinte –
disponibile pe Web?

nevoi ale dezvoltatorilor Web
Solutii multi-platforma, slab-conectate
integrare (in timp-real) la nivel de Internet/Web
a aplicatiilor, serviciilor si sistemelor

integrare (in timp-real) la nivel de Internet/Web
a aplicatiilor, serviciilor si sistemelor
exemplificare: gasirea de resurse Web pe baza localizarii
geografice a utilizatorului, privind ofertele de servicii
multiple disponibile la nivel de dispozitiv mobil

datele sa poata fi descrise pentru a fi “intelese”
de calculatoare si pentru a fi interconectate usor

datele sa poata fi descrise pentru a fi “intelese”
de calculatoare si pentru a fi interconectate usor
exemplu: Web “puzzles”inter-conectarea mai multor
servicii informative (e.g., situri de stiri, blog-uri) conform
preferintelor utilizatorului, pe baza intereselor sale

Servicii atasabile (pluggable) & versatile
Software as a Service – SaaS
Application Service Provider – ASP

Exista un model arhitectural de dezvoltare
a serviciilor la nivel de Web?

solutie
Divizarea aplicatiilor in servicii – independente –
care se pot compune,
menite a se conecta si orchestra in mod spontan
in cadrul proceselor de afaceri/tehnice

solutie
Divizarea aplicatiilor in servicii – independente –
care se pot compune,
menite a se conecta si orchestra in mod spontan
in cadrul proceselor de afaceri/tehnice
Web component-based software

solutie
“The Web is the computer”

solutie
disponibilitatea unei/unor arhitecturi care…
ofera suport pentru paradigme de comunicare
– bazata pe actualele tehnologii Web –
intre aplicatii eterogene

solutie
permit(e) localizarea transparenta a serviciilor

solutie
faciliteaza adaugarea, inlocuirea, eliminarea
serviciilor in mod dinamic

solutie
ascund(e) dezvoltatorului detaliile de sistem

solutie
asigura calitatea dezvoltarii si exploatarii
aplicatiilor distribuite si/sau paralele:
standardizare, securitate, disponibilitate,
reutilizare, mentenanta facila etc.

servicii web

servicii web
Software oferind o functionalitate specifica
acces la resurse – Delicious, Pinterest, Slideshare, Vimeo
agregare de stiri – Digg, Reddit
cartografiere – Bing Maps, Google Maps, Nokia Maps
mesagerie instantanee – Jabber, Twitter
realizare de statistici – Google Analytics
retele sociale – e.g., Facebook Open Graph Protocol
spelling checking – Spellr.us
stocare de date – Amazon S3, Dropbox, SkyDrive etc.
…

servicii web
Software oferind o functionalitate specifica
acces la resurse – Delicious, Pinterest, Slideshare, Vimeo
agregare de stiri – Digg, Reddit
cartografiere – Bing Maps, Google Maps, Nokia Maps
mesagerie instantanee – Jabber, Twitter
realizare de statistici – Google Analytics
retele sociale – e.g., Facebook Open Graph Protocol
spelling checking – Spellr.us
stocare de date – Amazon S3, Dropbox, SkyDrive etc.
…
utilizare – la distanta – de alte aplicatii/servicii

servicii web
Accesate standardizat via Web
URI
HTTP
XML si/sau alte formate (e.g., JSON)

servicii web
Cum am implementa un serviciu?

servicii web
Implementare standard
script-uri CGI sau utilizarea serverelor de aplicatii Web
ASP.NET, JSP, PHP, RoR,…

servicii web
Arhitectura generica a unei aplicatii Web
(3-tier application)
Internet
(Web)
Client Server de aplicatii Stocare
(interface) (application) (persistence)

Sponge / Database
Jelly / Business Logic
Custard / Page Logic
Cream / Markup
Fruit / Presentation
C. Henderson, “Scalable Web Architectures”,
Web 2.0 Expo, 2007: iamcal.com/talks/

servicii web
Traditional, aplicatia ofera o interfata-utilizator
disponibilă pe Web

servicii web
disponibilă pe Web
cererile sunt capt(ur)ate via formulare
+ legaturi hipertext

servicii web
disponibilă pe Web
cererile sunt capt(ur)ate via formulare
+ legaturi hipertext
utilizatorii umani trebuie sa interpreteze etichetele
si campurile de dialog + raspunsul receptionat

servicii web
Cum obtinem raspunsul pentru a fi (re)folosit
in programele noastre?
procesarea datelor din codul HTMLWeb scrapping
<tr><td>valoare</td><td><input name="val" value="0" readonly type="text"></td></tr>
<tr><td>total (cu TVA)</td><td><input name="cutva" value="0" readonly type="text"></td></tr>

servicii web
Cum obtinem raspunsul pentru a fi (re)folosit
in programele noastre?
orice modificare în marcajerescrierea programului
de preluare a datelor din documentul HTML
???!

servicii web
Ce-ar fi să indicăm datele de intrare și
răspunsul oferit de serviciul Web
într-un format standardizat?

servicii web
posibile soluții:
XML-RPC
SOAP
POX (Plain Old XML)
JSON (JavaScript Object Notation)
“dialog”
prin XML

Există un model arhitectural de dezvoltare
a serviciilor la nivel de Web?

soa
Arhitectura orientata spre servicii
SOA – Service Oriented Architecture

soa
Arhitectura orientata spre servicii
SOA – Service Oriented Architecture
stil arhitectural de proiectare & dezvoltare de aplicatii
considerate drept servicii
care pot fi invocate de alte aplicatii

soa
Paradigma de dezvoltare a software-ului
care adopta folosirea de servicii,
oferind functionalitati solicitate de utilizatori

soa
Paradigma de dezvoltare a software-ului
care adopta folosirea de servicii,
oferind functionalitati solicitate de utilizatori
resursele sunt disponibile via o suita de servicii
independente ale caror implementari
nu trebuie sa fie cunoscute (black box)

soa
Componentele sistemului in ansamblu
au un grad mare de independenta (de-coupling)

soa
Componentele sistemului in ansamblu
au un grad mare de independenta (de-coupling)
serviciile pot fi recompuse/orchestrate
conform cerintelor

soa
Serviciile sa nu depinda de starea comunicarii
(statelessness)

soa
Serviciile sa nu depinda de starea comunicarii
(statelessness)
cantitatea de informatie specifica unei activitati
ce trebuie retinuta trebuie sa fie minimala

Exista o modalitate pragmatica
privind dezvoltarea & invocarea serviciilor Web?

rest: representational state transfer
Stil arhitectural de dezvoltare a aplicațiilor Web
cu focalizare asupra reprezentării datelor
teza de doctorat a lui Roy Fielding, 2000

rest
Viziune complementara de implementare si
utilizare a serviciilor Web – fara SOAP

rest
Rezultatul unei procesari conduce la obtinerea
unei reprezentari a unei resurse

rest
resursa Web
un utilizator avand cont in cadrul unui sistem,
blog-ul unei persoane, fotografia unui utilizator,
flux de stiri, program etc.

rest
reprezentare = (X)HTML, JPEG, PNG, PDF, Atom, JSON,…

rest
reprezentare = (X)HTML, JPEG, PNG, PDF, Atom, JSON,…
formatul reprezentarii e desemnat de tipuri MIME
text/html, image/png, application/xhtml+xml etc.

rest
reprezentarile aceleasi resurse
– desemnate de un URI unic – pot fi multiple
reprezentare1
(XHTML)
reprezentare2
(Atom)
resursa
URI

rest
fiecare reprezentare a unei resurse are asociat un URL
reprezentare1
(XHTML)
reprezentare2
(Atom)
resursa
URI
URLURL

rest
Clientii – e.g., navigatoare Web, roboti, player-e –
interactioneaza cu reprezentarile resurselor via verbe
(“acceseaza”: GET, “modifica”: POST, “sterge”: DELETE,…)
reprezentare1
(XHTML)
reprezentare2
(Atom)
resursa
URI
URLURL
GET POST GET DELETE

rest
Verbele (actiunile) sunt stipulate de protocolul HTTP
GET
scop: accesarea (citirea) unei reprezentari de resursa
nu conduce la modificarea starii serverului (safe)
idempotenta – cereri identice vor conduce la returnarea
aceluiasi raspuns (aceeasi reprezentare)

rest
PUT
actualizeaza o reprezentare de resursa sau
eventual creeaza o resursa la nivel de server Web
uzual, returneaza un identificator (URI) al resursei
nu e considerata safe, dar este idempotenta

rest
POST
creeaza o resursa (uzual, subordonata altei resurse)
nu este nici safe, nici idempotenta
utilizata cand clientul nu cunoaste a-priori
care va fi URI-ul resursei ce va fi create

rest
DELETE
sterge (elimina) o resursa desemnata de un URI
este idempotenta

rest
Orice accesare a unei reprezentari
plaseaza aplicatia – ori clientul Web – intr-o stare
ce va fi schimbata in urma unui transfer de date
(accesarea altei reprezentari)

resursa1
reprezentare1
(XHTML)
http://blog.info/
resursa2
reprezentare2
(XHTML)
http://blog.info/mesaj
resursa3
reprezentare3
(XHTML)
http://blog.info/mesaj/edit
resursa4
reprezentare4
(Atom)
http://blog.info/stiri
GET
GET
POST

resursa1
reprezentare1
(XHTML)
http://blog.info/
resursa2
reprezentare2
(XHTML)
http://blog.info/mesaj
resursa3
reprezentare3
(XHTML)
http://blog.info/mesaj/edit
resursa4
reprezentare4
(Atom)
http://blog.info/stiri
GET
GET
POST
HATEOAS (Hypermedia As The Engine Of Application State)

rest
Transferul se realizeaza prin protocolul HTTP
Reprezentarea este modelata in XML
(sau alt format) si indicata prin tipuri MIME
Adresabilitatea se rezolva via URI

rest
Aplicatiile care invoca functionalitati (servicii)
consuma reprezentari de resurse – in stilul pull

Fiecare cerere este considerata independenta,
fara a se lua in consideratie contextul
stateless server
rest

Reprezentarile de resurse pot fi stocate temporar
caching
rest

statelessserver
client
cache
client
cache
adaptare dupa B. Mulloy (2012)

statelessserver
client
cache
client
cache
fiecare cerere
trebuie sa contina
toate informatiile
necesare procesarii

statelessserver
client
cache
client
cache
contextul activitatilor
nu-i stocat de server

statelessserver
client
cache
client
cache
clientul are dreptul
sa reutilizeze datele
receptionate

Aplicatia Web dezvoltata va fi stratificata
layered system
rest

client
state-
less
server
state-
less
server
state-
less
server
load
balan
cer
gatewayfire-
wall

client
state-
less
server
state-
less
server
state-
less
server
load
balan
cer
gatewayfire-
wall
fiecare strat ofera
servicii stratelor
vecine

client
state-
less
server
state-
less
server
state-
less
server
load
balan
cer
gatewayfire-
wall
un strat nu poate
“vedea” strate
neinvecinate

client
state-
less
server
state-
less
server
state-
less
server
load
balan
cer
gatewayfire-
wall
stratele pot incapsula
(“ascunde”) sisteme
traditionale – blackbox

client
state-
less
server
state-
less
server
state-
less
server
load
balan
cer
gatewayfire-
wall
are rol in asigurarea
performantei/
fiabilitatii

rest: exemplu
Serviciile puse la dispozitie de Delicious
managementul adreselor Web favorite (bookmark-uri),
cu posibilitatea atasarii de termeni de continut (tag-uri)
si comentarii
social bookmarking
https://delicious.com/developers

rest: exemplu
Serviciile puse la dispozitie de Delicious
functionalitate de baza:
listarea tuturor bookmark-urilor
(eventual, filtrate dupa diverse criterii)
managementul bookmark-urilor:
adaugare, editare, stergere

rest: exemplu
Resursa URL Metoda Reprezentare
Bookmark /bookmarks/{md5} GET application/bookmark+xml
Bookmark /bookmarks/{md5} PUT application/bookmark+xml
Bookmark /bookmarks/{md5} DELETE
Lista de
bookmark-uri
/bookmarks GET application/atom+xml
Lista de utilizatori /users GET application/atom+xml
Lista de tag-uri
(termeni de
continut)
/tags GET application/atom+xml
Pagina principala / GET application/delicious+xml

GET /bookmarks
200 OK
Content-type: application/atom+xml
<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom">
<title>Bookmarks</title>
<entry>
<title>O resursa interesanta</title>
<link
href="/bookmarks/a211528fb5108cddaa4b0d3aeccdbdcf"/>
<summary>
http://undeva.info/o-resursa-interesanta
</summary>
</entry>

</feed>
raspuns XML (Atom)
oferit de serviciul Delicious
digest MD5
obtinerea
bookmark-urilor

GET /bookmarks/a211528fb5108cddaa4b0d3aeccdbdcf
200 OK
Content-type: application/bookmark+xml
<bookmark>
<title>O resursa interesanta</title>
<url>http://undeva.info/o-resursa-interesanta</url>
<user href="/users/tux">tux</user>
<tags>
<tag href="/tags/interesting">interesting</tag>
<tag href="/tags/penguin">penguin</tag>
</tags>
</bookmark>
preluarea unui bookmark:
răspunsul XML dat de serviciul Delicious

POST /bookmarks
…
201 Created
Location: /bookmarks/a211528fb5108cddaa4b0d3aeccdbdcf
PUT /bookmarks/a211528fb5108cddaa4b0d3aeccdbdcf
…
200 OK
crearea unui
bookmark
actualizarea
unui bookmark

rest
Resursele sunt numite folosind URI-uri (URL-uri)
Reprezentarile sunt interconectate prin URL-uri
Pot exista intermediari (proxy, cache, porti)
intre clienti si resurseperformanta, securitate,...
Transferul de date poate fi si asincron – stil Ajax/Comet

rest
O resursa poate avea asociate reprezentari XML
(XML, JSON, eventual in alte formate de date)
ce pot fi accesate/alterate via operatii HTTP
operatii CRUD – Create, Retrieve, Update, Delete

rest: metodologie
Divizarea in resurse a setului de date
ale problemei
clase tipice de resurse:
Utilizator
Document – alternative: Fotografie, Produs, Software,…
Metadata – e.g., Comentariu, Format, Locatie, Platforma etc.

rest: metodologie
Numirea prin URI a fiecarei resurse
exemplificari:
http://aplicatie.info/Utilizator/tux
http://aplicatie.info/Document/pinguini-cu-mere-albastre

rest: metodologie
cazuri concrete:
insemnarile etichetate cu fii disponibile pe un blog
http://fiistudent.wordpress.com/tag/fii/
accesarea datelor despre o productie cinematografica
http://www.imdb.com/title/tt0401383/
obtinerea listei utilizatorilor ce urmaresc o persoana
http://twitter.com/followers

rest: metodologie
cazuri concrete:
acces la prezentarile Slideshare ale utilizatorului busaco
http://www.slideshare.net/busaco/presentations
bookmark-urile cu tag-ul web ale utilizatorului busaco
http://delicious.com/busaco/web
efectuarea actiunii de editare a unui document XWiki
http://www.info.uaic.ro/bin/edit/Students/Timetable

rest: metodologie
Interactiunea cu un serviciu Web dezvoltat in stilul REST
se face via un API (Application Programming Interface)
pentru exemple de bune practici, a se consulta
http://www.restapitutorial.com/

rest: metodologie
Proiectarea reprezentarii(lor) acceptate
ce pot fi trimise de aplicatia client
si reprezentarii(lor) intoarse spre client
de considerat formatele standard – e.g., HTML, Atom

rest: metodologie
Integrarea resurselor
via legaturi hipertext + formulare

rest: metodologie
Crearea de studii de caz
specificarea conditiilor de eroare si/sau de exceptie,
inclusiv aspecte privind controlul versiunilor API-ului

Cum pot fi accesate reprezentari de resurse Web
prin REST?

rest: implementare
Biblioteci/API-uri implementând HTTP
libcURL (C, cu portări pentru Perl, PHP, Ruby,…)
libwww (C, Perl)
httplib (Python)
Net:HTTP (Ruby)
RestSharp (C#)
etc.

rest: implementare
Studiu de caz: invocarea unui serviciu Web
de prescurtare de URL-uri – http://is.gd/
un nou URL prescurtat va fi creat folosind adresa
http://is.gd/create.php?format=xml&url=adresaWeb
alte formate:
web (HTML), json,
simple (text)

Cererea HTTP ce invoca serviciul Web prin REST:
GET /create.php?format=xml&url=profs.info.uaic.ro/~busaco HTTP/1.1
Host: is.gd
Raspunsul obtinut, transmis de serverul Web:
HTTP/1.1 200 OK
Server: nginx
Date: Tue, 15 May 2012 07:48:18 GMT
Content-Type: text/xml;charset=UTF-8
<?xml version="1.0" encoding="UTF-8" ?>
<output>
<shorturl>http://is.gd/DBmG2L</shorturl>
</output>
reprezentare POX
(Plain Old XML)

// initializam cURL
$c = curl_init ();
// stabilim URL-ul serviciului Web invocat
curl_setopt ($c, CURLOPT_URL,
'http://is.gd/create.php?format=xml&url=profs.info.uaic.ro/~busaco');
// rezultatul cererii va fi disponibil ca sir de caractere
curl_setopt ($c, CURLOPT_RETURNTRANSFER, 1);
// preluam resursa oferita de server (aici, un document XML)
$res = curl_exec ($c);
// inchidem conexiunea cURL
curl_close ($c);
// procesam rezultatul via DOM
$doc = new DOMDocument ();
$doc->loadXML ($res);
// preluam continutul elementului <shorturl>
$urls = $doc->getElementsByTagName ('shorturl');
foreach ($urls as $url) {
echo '<p>Adresa prescurtata este: ' . $url->nodeValue . '</p>';
}
apelarea serviciului
Web REST via PHP

rest: implementare

rest: implementare
Studiu de caz: accesarea celor mai recente mesaje
disponibile pe Twitter
se recurge la URL-ul
http://twitter.com/statuses/public_timeline.json
pentru a obtine mesajele publice
in format JSON (JavaScript Object Notation)
detalii la https://dev.twitter.com/docs/api

HTTP/1.1 200 OK
Date: Tue, 15 May 2012 07:03:27 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 40860
[ {
...
"created_at": "Tue May 15 07:03:23 +0000 2012",
"truncated": false,
"retweet_count": 0,
"retweeted": false,
"in_reply_to_user_id": null,
"user": {
"name": "Tuxy Pinguinescu",
"location": "South Pole",
"created_at": "Wed Oct 21 06:33:14 +0000 2010",
"lang": "en",
"followers_count": 133374,
...
},
"in_reply_to_status_id": null
} ]
raspuns in
format JSON

rest: implementare
permit dezvoltarea de aplicații desktop, mobile etc.
suport pentru crearea de mash-up-uri la nivel de server
nu funcționează în navigatorul Web

rest: implementare
permit dezvoltarea de aplicații desktop, mobile etc.
suport pentru crearea de mash-up-uri la nivel de server
nu funcționează în navigatorul Web
atentie la problemele de securitate ce pot aparea!

rest: implementare
Navigatoarele Web actuale
nu necesită o interfață de programare (API) specifică
disponibilitate pe orice platforma
suport pentru REST via obiectul XMLHttpRequest (Ajax)
dependența de implementarea la nivel de browser

rest: implementare
Exemplificare recurgand la biblioteca jQuery (JavaScript):
jQuery.ajax ({ // executa o cerere POST pentru invocarea serviciului Web
type: "POST",
contentType: "application/json; charset=utf-8",
url: "http://undeva.info/ServiciuWeb/Resursa",
data: "{…}", // datele de intrare trimise serviciului
dataType: "json", // asteptam raspunsul in format JSON
success: function(data) { // functie apelata la transfer cu succes
$('.rezultat').html(data); // preluam datele, convertindu-le in HTML
}
});

rest: dezvoltare
ASP.NET MVC (C#)
JAX-RS – Java Architecture for RESTful web Services
Jifty (Perl)
neon (C)
Restlet (Java)
RIP – REST in Python
Ruby on Rails (Ruby)
Recess, Symfony, Tonic, Zend Framework (PHP)
etc.

rest: dezvoltare
Servicii publice ce pot fi consumate via REST – exemple:
500px, Amazon, Basecamp, Blip.tv, eBay, Ericsson,
Facebook, GitHub, Google, Klout, LinkedIn, Muselius,
Netflix, OpenSocial, Scribd, SlideShare, TripIt, Yahoo! etc.
4892 API-uri specifice (9 octombrie 2012)
vezi si http://tinyurl.com/2ssfc2
disponibile pentru C++, C#, JavaScript, Java,
PHP, Python, Objective-C, Ruby,…

testarea de API-uri Web cu hurl.it
accesarea
serviciului Web
oferit de GitHub
JSON

rest: dezvoltare
Pasi uzuali de urmat pentru implementarea unei aplicatii
ce va invoca un serviciu Web pe baza unui API public:
(1) inregistrarea aplicatiei concepute
via situl entitatii furnizoare a serviciului
cheie de acces – API key, consumer key

rest: dezvoltare
(2) pe baza acestei chei, aplicatia se va putea autentifica
pentru a putea fi autorizata sa acceseze serviciul

rest: dezvoltare
(2) pe baza acestei chei, aplicatia se va putea autentifica
pentru a putea fi autorizata sa acceseze serviciul
pot fi impuse diverse politici de acces (permissions):
doar consultare (read), posibilitatea editarii etc.

rest: dezvoltare
(3) autentificarea si autorizarea aplicatiei
au loc cu acordul utilizatorului

rest: dezvoltare
(3) autentificarea si autorizarea aplicatiei
au loc cu acordul utilizatorului
daca utilizatorul nu este autentificat, i se vor solicita
informatiile de autentificare (e.g., nume + parola),
apoi va putea autoriza aplicatia sa aiba acces la date
via serviciul Web furnizat

rest: dezvoltare
(4) aplicatia apeleaza metodele oferite de serviciu
pentru preluarea/modificarea datelor de interes,
conform politicilor de acces

rest: dezvoltare
(4) aplicatia apeleaza metodele oferite de serviciu
sesiunea curenta va fi stabilita si mentinuta
pe baza unor informatii de autentificare (auth tokens)

rest: dezvoltare – oauth
Autorizarea securizata a unei aplicatii sa acceseze
date private intr-un mod standardizat
se poate realiza via OAuth

Autorizarea securizata a unei aplicatii sa acceseze
date private intr-un mod standardizat
se poate realiza via OAuth
protocol deschis
OAuth 1.0 – RFC 5849 (2010), OAuth 2.0 (in lucru)
http://oauth.net/
http://hueniverse.com/oauth/

Exemplificari concrete:
Evernote, Facebook, Google, Ohloh, OpenSocial,
Photobucket, TripIt, Twitter, Vimeo, Windows Live,
Yahoo!, Yammer,...

rest: dezvoltare – openid
OpenID
mecanism descentralizat de autentificare a utilizatorului
la nivel de Web pe baza paradigmei SSO – Single Sign On
via un ofertant (serviciu) de identitate (identity provider),
utilizatorii pot sa-si gestioneze prezente online multiple
http://openid.net/

OpenID
fiecare identitate e desemnata de un URL (stabilit de
identity provider): me.yahoo.com, nume.wordpress.com,
google.com/profiles/nume, launchpad.net/~nume etc.
pentru a-si confirma identitatea,
utilizatorul va trebui sa se autentifice:
nume de cont + parola, smart card, date biometrice,…

OpenID
Biblioteci open source disponibile
pentru C#, Java, Perl, PHP, Python, Ruby,…
http://openid.net/developers/libraries/
http://www.janrain.com/openid-enabled

Cum se pot combina date
oferite de mai multe servicii Web?

mash-ups
Combinarea – la nivel de client și/sau server –
a datelor ce provin din surse (situri) multiple,
oferindu-se o funcționalitate/experiență nouă

mash-ups
Se bazează pe fluxuri RSS/Atom,
servicii Web, API-uri publice,…
“curentul” SaaS (Software As A Service)

mash-ups
combinare
utilizarea de surse de date multiple
poate avea caracter multidimensional:
subiect de interes + locație geografică + moment de timp
Yahoo! music search + Google maps + Eventful

mash-ups
vizualizare
pot fi adoptate diverse tehnici de vizualizare (prezentare)
a datelor: cartografică, tag cloud-uri, tridimensională,…
Twitter + Google EarthTwittEarth

mash-ups
agregare
gruparea datelor provenite din mai multe surse
și analizarea lor: statistici, clasificări, predicții,…
e.g., folosind data mining se pot releva
aspecte “ascunse” ale datelor procesate

instrumente
(GUI tools)
biblioteci de dezvoltare
(libraries)
interfete de programare
(API-uri)
surse de date (data feeds)
platforme

instrumente
(GUI tools)
(libraries)
(API-uri)
platforme
RSS, geoRSS,
microformate,
RDFa,…

instrumente
(GUI tools)
(libraries)
(API-uri)
platforme
privind
fluxurile
RSS/Atom
specifice
serviciilor
publice

instrumente
(GUI tools)
(libraries)
(API-uri)
platforme
framework-uri
Web oferite de
organizatii

instrumente
(GUI tools)
(libraries)
(API-uri)
platforme
medii de
dezvoltare
Web

instrumente
(GUI tools)
(libraries)
(API-uri)
platforme
Facebook,
Google App Engine,
WordPress,…

mash-ups: aspecte de interes
performanță: scalabilitatea & latența
limite ale API-urilor + existența versiunilor multiple
drepturi de autor asupra datelor & licențiere
securitate: abuz, confidențialitate, încredere etc.
monetizare
lipsa unei interoperabilități reale între platforme

mash-ups: dezvoltare
API-uri publice & exemple disponibile la
ProgrammableWeb.com

privire pragmatica
Ingineria dezvoltarii de servicii Web prin REST
Brian Mulloy, Web API Design, Apigee, 2012
http://offers.apigee.com/web-api-design-ebook/

privire pragmatica
URL-urile desemnand resurse (concepte) de
interes trebuie sa fie simple si intuitive
utilizarea substantivelor pentru fiecare “lucru”
colectii de resurse (uzual, la plural)
/students
identificatori unici pentru membrii unei colectii
/students/tuxy (concret) vs. /students/69 (abstract)

privire pragmatica
Folosirea verbelor (metodelor) HTTP pentru efectuarea
de operatii asupra unor (colectii de) resurse
resursa
(URI)
POST
(creeaza)
GET
(acceseaza)
PUT
(actualizeaza)
DELETE
(sterge)
/students
creează
un student nou
listeaza studentii
existenti
actualizeaza
un set de studenti
sterge toti
studentii
/students/69
(un URL deja
existent)
eroare 
ofera date
despre student
daca exista,
actualizeaza,
altfel eroare
sterge
studentul
respectiv

privire pragmatica
Tratarea erorilor
folosirea codurilor de stare HTTP
(200 – OK, 400 – Bad Request, 500 – Internal Server Error)
mesajele returnate trebuie sa includa informatii utile
exemplu: Twilio – cod de stare intors: 401
{ "status" : "401", "message":"Authenticate", "code": 20003,
"more info": "http://www.twilio.com/docs/errors/20003" }

privire pragmatica
Controlul versiunilor API-ului dezvoltat
“Never release an API without a version
and make the version mandatory.” (Mulloy, 2012)
specificarea versiunii
in antetul HTTP vs. in cadrul URL-ului
salesforce.com – /services/data/v20.0/sobjects/Account
Facebook – ?v=1.0

privire pragmatica
Paginarea & oferirea de raspunsuri partiale
uzual, se folosesc parametri precum limit si offset
/students?limit=33&offset=74
filtrele optionale (e.g., in contextul faceted search)
pot fi delimitate de virgula
/students?fields=name,age,year,email

privire pragmatica
Eterogenitatea formatelor reprezentarilor intoarse
indicarea via un parametru optional in URL
?alt=json (Google Data)
specificarea formatului acceptat in antetul cererii HTTP
Accept: application/json (Digg)
precizarea formatului in numele resursei solicitate
/venue.json (Foursquare)

privire pragmatica
Utilizarea subdomeniilor pentru API-uri diferite
ale aceluiasi ofertant de servicii
exemplificare:
search.twitter.com
stream.twitter.com
api.twitter.com

privire pragmatica
Suplimentar, alaturi de API
poate fi oferit un SDK (Software Development Kit)
incapsuleaza functionalitatile API-ului intr-o biblioteca
(implementata intr-un anumit limbaj de programare,
pentru o platforma software/hardware specifica)
API façade pattern

privire pragmatica

Development as a Service
A.Iqbal,M.Haunsenblas,S.Decker(2012)

Web: CodeRun, Cloud9, eXo Cloud
desktop: Eclipse, <oXygen/>, Visual Studio
Google App Engine, Heroku,
Jelastic, Windows Azure
BitBucket, GitHub,
SourceForge, Unfuddle

Rezumat
Dezvoltarea de aplicatii orientate spre servicii Web
de la REST la mash-up-uri & API-uri

?

Dezvoltarea aplicatiilor orientate spre servicii Web. De la REST la mash-up-uri si API-uri

More Related Content

What's hot (20)

Similar to Dezvoltarea aplicatiilor orientate spre servicii Web. De la REST la mash-up-uri si API-uri (18)

More from Sabin Buraga (20)

Dezvoltarea aplicatiilor orientate spre servicii Web. De la REST la mash-up-uri si API-uri