Hypermedia

Erlend Hamnaberg BigOne 13. april 2011 Hypermedia

Disclaimer Jeg antar at deltakerene har kjennskap til REST. Jeg kommer ikke til å forklare REST her.

Hvem er jeg? Konsulent Java / Tech1 Laget Escenic sin REST-webservice Despot for HTTPCache4j, en browsercache i Java Aktiv på #rest på irc.freenode.net Nestleder i javaBin

Agenda HATEOAS Definisjon av Hypermedia Hypermediafaktorer Tips og triks

«Hypertext As The Engine Of Application State» HATEOAS eller ‘The hypertext constraint’

Ressurstilstand Hva som er på serveren nå

Applikasjonstilstand Hvilket «skjermbilde» klienten er på nå. Et «skjermbilde» kan være oppbygd av mange ressurser Hvilke oppgaver klienten kan gjøre basert på resultatet fra den foregående forespørslen. Hver interaksjon med serveren kan man si er en del av en tilstandsmaskin

Tilstandsmaskin – ordre Velg Godkjenn Betal Send Ønskeliste Fritt fra REST in Practice - RESTBucks

Definisjon av hypermedia “The use of text, data, graphics, audio and video as elements of an extended hypertext system in which all elements are linked so that the user can move between them at will” (min utheving)

Hva betyr dette? To elementtyper: Hypertekst Data (herunder: tekst, data, grafikk, audio og video)

Hypertekst? I sin enkleste form en link (URI).

Spesifikasjon Spesifikasjonen til hypermediaformatet er abstrakt. Sammenhengen mellom et instansdokument + link-relasjoner er hva som utgjør applikasjoner.

Registrerte hypermedia typer HTML ATOM VOICE/XML uri-list SMIL turtle CSS SVG

Hva med JSON og XML? ikke hypermedia format Ikke RESTfullt, pga punktet over Å gi application/json eller application/xml over HTTP er som å si: «Her har du en ting, men jeg kan ikke si hvordan den ser ut, eller hvordan du kan interaktere med den»

Hypermediafaktorer Linkstøtte: Utgående linker Inline linker Maler for søkestrenger Ikke-idempotente oppdateringer Idempotente oppdateringer

Utgående linker Eksempel: HTML: <a href="http://example.com"...>...<a/> Atom: <link href="http://example.com" .../> Uri-list: består kun av utgående linker

Inline linker HTML: <img src="http//img.example.com/123.jpg" .../> Atom: <content src="http//example.com/text.html"/>

Maler for søkestrenger HTML: Atom: Finnes ikke i standarden, kan lages som påbygg. (opensearch)

Ikke-idempotente oppdateringer HTML: Atom: Ikke i standarden, men i atompub

Idempotente oppdateringer HTML: må bruke Code-On-Demand (javascript) Atom: Ikke i standarden, men i atompub.

Hypermediafaktorer Kontrolldatastøtte Kontrolldata for leseforespørsler Kontrolldata for oppdateringsforespørsler Kontrolldata for grensesnittsmetoder Kontrolldata for linker

Kontrolldata for leseforespørsler HTML: Kan gjøres ved Code-On-Demand(JS) Atom: Finnes ikke. Xsl:include: <xsl:include href="http://www.example.org/newsfeed" accept="application/rss" />

Kontrolldata for oppdateringsforespørsler HTML: Atom: Atompub

Kontrolldata for grensesnittsmetoder HTML: method attributtet i <form> Atom: finnes ikke

Kontrolldata for linker HTML: Atom:

HTML Stort sett det eneste man trenger Kontekst til elementene gis via en profile attributt i <head>

Egne hypermedia format Det er mulig. Gjør et godt forsøk på å utrykke deg i et eksisterende format. Lag et generelt format for domenet, om du ikke kan bruke et eksisterende Tenk på hypermediafaktorerene når du designer La formatet du designer være protokolluavhenigig

Egne hypermedia format Tenk på utvidbarhet: feks XML namespaces Link-relasjoner bør være definert som URIer Det er fullt mulig å lage et JSON-basert hypermedia format. Men; man får veldig fort applikasjons lock-in. XML er enklere, pga namespacer som muliggjør gjenbruk av eksisterende formater.

Viktige ting å tenke på La den private objektgrafen på server/klient forbli privat Tenk heller foretningsregler/protokoller i stedet for serialisering. Hva kan man la være å eksponere? Versjonering? Du trenger det ikke med et godt designet hypermediaformat ALDRI send application/xml eller application/json med mindre dette er et endepunkt.

Anbefalt lesestoff Atompub: http://tools.ietf.org/html/rfc5023 H-Factors: http://amundsen.com/hypermedia/hfactor/ Fielding’s REST: http://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm Registrerte MIME-typer: http://www.iana.org/assignments/media-types/ Registrerte Link-relasjoner:http://www.iana.org/assignments/link-relations/ REST in Practice (bok) RESTful Web Services Cookbook (bok)

Andre ressurser http://amundsen.com/media-types/maze/format/ - forsøk på å designe et nytt hypermedia-format (ngarthl er meg)

Til slutt Hypermedia workshop med Mike Amundsen: http://java.no/event/180 Implementing RESTFul webapps med Mike Amundsen: http://java.no/event/177

Hypermedia

Recommandé

Recommandé

Contenu connexe

Similaire à Hypermedia

Similaire à Hypermedia (20)

Hypermedia

Notes de l'éditeur