Reacties op: REST en ROA http://blog.finalist.com/2008/08/04/rest-en-roa/ Nederlandse blog over software ontwikkeling Tue, 06 Jan 2009 03:58:45 +0000 http://wordpress.org/?v=2.1.3 By: Rikkert Koppes http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-20224 Rikkert Koppes Tue, 05 Aug 2008 06:23:27 +0000 http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-20224 "Alternatief voor SOAP" klinkt een beetje raar, alsof REST nieuwer is. Dat is natuurlijk niet zo. REST is zo oud als de nacht, of nou ja, zo oud als HTTP. Daarom zou nooit de overweging moeten zijn of je "REST gaat doen", maar of je iets anders [dan REST] zou willen inzetten. Vaak is dat niet het geval. “Alternatief voor SOAP” klinkt een beetje raar, alsof REST nieuwer is. Dat is natuurlijk niet zo. REST is zo oud als de nacht, of nou ja, zo oud als HTTP.

Daarom zou nooit de overweging moeten zijn of je “REST gaat doen”, maar of je iets anders [dan REST] zou willen inzetten. Vaak is dat niet het geval.

]]> By: Edwin van der Elst http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-20229 Edwin van der Elst Tue, 05 Aug 2008 09:33:23 +0000 http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-20229 Ik zou SOAP gebruiken als de argumenten voor acties complex worden (bv. een SOAP method om een 'order' met 'orderregels' toe te voegen). Dit wil je in 1 transactie, en dus in 1 call naar de server. Met SOAP is het dan eenvoudig om een samengesteld object als parameter te versturen. Wanneer je met externe partijen moet communiceren is een WSDL nuttig als contract, ik ben benieuwd hoe je bij REST-services hierover afspraken maakt. Ik zou SOAP gebruiken als de argumenten voor acties complex worden (bv. een SOAP method om een ‘order’ met ‘orderregels’ toe te voegen). Dit wil je in 1 transactie, en dus in 1 call naar de server.
Met SOAP is het dan eenvoudig om een samengesteld object als parameter te versturen.

Wanneer je met externe partijen moet communiceren is een WSDL nuttig als contract, ik ben benieuwd hoe je bij REST-services hierover afspraken maakt.

]]> By: Rikkert Koppes http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-20230 Rikkert Koppes Tue, 05 Aug 2008 10:33:28 +0000 http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-20230 verzenden kan toch gewoon als form data? Dat is behoorlijk gespecificeerd. In het geval van orderregels heb je parameters als: orderrule0.name = ... orderrule0.value = ... orderrule1.name = ... orderrule1.value = ... Web forms 2 repetition model kan je daar prima bij helpen, maar dat is niet eens noodzakelijk. verzenden kan toch gewoon als form data? Dat is behoorlijk gespecificeerd. In het geval van orderregels heb je parameters als:
orderrule0.name = …
orderrule0.value = …
orderrule1.name = …
orderrule1.value = …

Web forms 2 repetition model kan je daar prima bij helpen, maar dat is niet eens noodzakelijk.

]]> By: Lennaert http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-20232 Lennaert Tue, 05 Aug 2008 11:15:44 +0000 http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-20232 Als een functioneel of technische beschrijving niet volstaat, zou je kunnen kijken naar WADL (https://wadl.dev.java.net/). Je kunt ook een xml-document te PUTten of te POSTen waar je een XML Schema document voor kunt schrijven. Je kunt ervoor kiezen om zowel een hele order te kunnen bewerken en ook de afzonderlijke orderregels. Of je kunt een formulier plaatsen in je presentatie om aan te geven wat er verzonden kan worden. HTML5 voorziet naast GET en POST ook in PUT en DELETE . Voordeel hiervan is dat de connectedness (verbondenheid) groter wordt. @Rikkert: het was niet mijn bedoeling om REST of ROA als nieuw te presenteren. Ik kende de mogelijkheden van HTTP niet en zag het daarom niet eerder als alternatief. Overigens is ROA niet alleen een alternatief voor SOAP, maar ook voor RPC-styijl/REST-RPC-hybride constructies. Als een functioneel of technische beschrijving niet volstaat, zou je kunnen kijken naar WADL (https://wadl.dev.java.net/). Je kunt ook een xml-document te PUTten of te POSTen waar je een XML Schema document voor kunt schrijven. Je kunt ervoor kiezen om zowel een hele order te kunnen bewerken en ook de afzonderlijke orderregels.

Of je kunt een formulier plaatsen in je presentatie om aan te geven wat er verzonden kan worden. HTML5 voorziet naast GET en POST ook in PUT en DELETE . Voordeel hiervan is dat de connectedness (verbondenheid) groter wordt.

@Rikkert: het was niet mijn bedoeling om REST of ROA als nieuw te presenteren. Ik kende de mogelijkheden van HTTP niet en zag het daarom niet eerder als alternatief. Overigens is ROA niet alleen een alternatief voor SOAP, maar ook voor RPC-styijl/REST-RPC-hybride constructies.

]]> By: Edwin van der Elst http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-20233 Edwin van der Elst Tue, 05 Aug 2008 11:39:03 +0000 http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-20233 @Rikkert Een 'form' op die manier gebruiken vind ik nogal lelijk. En dan blijf je met de vraag hoe dit geparsed moet worden. Is het toevoegen van een getal (zoals orderrule0, 1, etc.) een standaard, tel je vanaf 0 of 1, welke velden kunnen er zijn, iemand anders bedenkt misschien 'orderrule[0].name=...' En het grootste probleem blijft dat er dan geen contract is (welke velden zijn verplicht, wat voor datatypes, etc.). @Lenneart WADL: Dat is de oplossing! Het lijkt misschien geneuzel van mijn kant, maar ik heb al meegemaakt dat (externe) gebruikers van een service. zonder SOAP bibliotheek met het handje de XML opbouwden en dan probeerden de call uit te voeren. Ik was maar wat blij met de controles aan de server kant tegen de WSDL! Ik vind het prettig om (bijvoorbeeld) bij verplichte velden zelf niet meer te hoeven controleren of ze echt wel ingevuld zijn en of een getal het juiste formaat heeft (bv. decimale scheidingsteken). @Rikkert
Een ‘form’ op die manier gebruiken vind ik nogal lelijk. En dan blijf je met de vraag hoe dit geparsed moet worden.
Is het toevoegen van een getal (zoals orderrule0, 1, etc.) een standaard, tel je vanaf 0 of 1, welke velden kunnen er zijn, iemand anders bedenkt misschien ‘orderrule[0].name=…’

En het grootste probleem blijft dat er dan geen contract is (welke velden zijn verplicht, wat voor datatypes, etc.).

@Lenneart
WADL: Dat is de oplossing!

Het lijkt misschien geneuzel van mijn kant, maar ik heb al meegemaakt dat (externe) gebruikers van een service. zonder SOAP bibliotheek met het handje de XML opbouwden en dan probeerden de call uit te voeren. Ik was maar wat blij met de controles aan de server kant tegen de WSDL!
Ik vind het prettig om (bijvoorbeeld) bij verplichte velden zelf niet meer te hoeven controleren of ze echt wel ingevuld zijn en of een getal het juiste formaat heeft (bv. decimale scheidingsteken).

]]> By: Lennaert http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-20238 Lennaert Tue, 05 Aug 2008 15:54:25 +0000 http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-20238 De HTML5 webforms 2 specificatie biedt een aardige lijst met uitbreidingen, waaronder verplichte velden en datatypes (zie http://www.whatwg.org/specs/web-forms/current-work/). Je kunt een webforms2 formulier dus gebruiken als specificatie. Serverside moet er uiteraard nog wel gevalideerd worden, misschien zijn er bibliotheken die dat kunnen aan de hand van het formulier? De HTML5 webforms 2 specificatie biedt een aardige lijst met uitbreidingen, waaronder verplichte velden en datatypes (zie http://www.whatwg.org/specs/web-forms/current-work/).

Je kunt een webforms2 formulier dus gebruiken als specificatie. Serverside moet er uiteraard nog wel gevalideerd worden, misschien zijn er bibliotheken die dat kunnen aan de hand van het formulier?

]]> By: Matthieu van den Berg http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-21711 Matthieu van den Berg Fri, 17 Oct 2008 07:31:28 +0000 http://blog.finalist.com/2008/08/04/rest-en-roa/#comment-21711 Ik vrees dat ik in GWBASIC versie 1.0 ben blijven steken. Len, neem even contact op aub dan kunnen we bijpraten. Groet, Matthieu Ik vrees dat ik in GWBASIC versie 1.0 ben blijven steken. Len, neem even contact op aub dan kunnen we bijpraten.

Groet,

Matthieu

]]>