PUBLIC MARKS from night.kame with tag rest

Being truly RESTful, according to experts means (among other things) implementing HATEOAS. While that is appealing, it also has security implications. We always say that security by obscurity is not security, but providing attackers with full discoverability of your API is not necessarily wise..

[...]

If you're looking for a truly RESTful API design guide, you should probably continue looking elsewhere :)

Suivant le mouvements initié par les idiolâtres de Struts, les haineux du XML ont parachevé cette œuvre de débilisation de l'ingénierie logicielle pour l'amener où elle se trouve aujourd'hui : dans les bas-fonds des "services numériques" (quand ils ne sont pas "digitaux"). Nous avons donc la Banque Nationale de Belgique qui ne sait plus parler ni en français, ni en flamand, pour coller des mots aléatoirement sur des concepts, avec pour seule contrainte scientifique d'avoir entendu le dit mot au détour d'une allée dans ces colloques où le développeur, forcément super-héros, n'est qu'un Bisounours parmi les autres (croisé avec un Power Ranger évidemment). Au final il ne reste qu'un vague gloubi-boulga, indigeste, mais prag-ma-tique. Si Codd est mort, Reenskaug et Fielding ne le sont pas, et pourtant, cette foule les a bel et bien enterré, et désacralisent de leur verbe béotien ces tombes virtuelles.

I'm frustrated that Roy's frustrated by REST confusion. Would it be that hard for Roy to suggest in plain english what a restful API might look like? The dissertation is going on 9 years old now and there's more confusion than ever.

C'est ça la beauté de REST.

Transfer Methods. This is at the core of REST and ROA and is the foundation of Web-Oriented Architecture. You can read Roy Fielding's chapter on REST (he conceived of the approach originally) or you can just follow the simple guidelines here. At other times, protocols like BitTorrent can be used if the requirements warrant it, but these are exceptional scenarios that I will cover at some point in the future.

Ne pas citer XMPP dans les "Transfer Methods" quelque jours après l'annonce de Google Wave, et surtout le mettre dans le schéma au niveau des Microformats fait perdre toute crédibilité à l'article.

For the finder part I have implemented a SPARQL backend, which internally delegates to Sesame2, which is the same default index/query that is used to find Entities in general. This in itself is pretty cool, because it means that you can write your domain model in Java, have it be automatically persisted in a store like Neo4j, and then with no extra effort expose it through SPARQL for AJAX webapps to consume (both RDF/XML and JSON output is supported today). Minimally writing a domain model only involves writing Java interfaces (no classes), so it's pretty easy to get started.