http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_CouchDB_via_l%27interface_RESThttp://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_CouchDB_via_l%27interface_REST#REST.3FREST – pour Representational State Transfer – est une architecture client-serveur dans laquelle un client utilise le vocabulaire standard d'un protocole pour identifier et manipuler des ressources sur un serveur. Un point clé étant que le serveur est sans état. Ce qui implique qu'à chaque requête le client doit être en mesure de fournir assez d'informations au serveur pour qu'il puisse traiter la requête.

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_CouchDB_via_l%27interface_REST#Pour_commencerDonc, CouchDB est installé sur votre machine. Dans mon cas, ce sera sur l'hôte couchdb. Pour vous, ce sera peut-être localhost, ou le nom ou l'adresse IP du serveur sur lequel vous avez installé CouchDB... Avant toute autre manipulation, nous allons vérifier que le serveur est opérationnel et accessible:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_CouchDB_via_l%27interface_REST#Cr.C3.A9er.2FSupprimer_une_baseMaintenant que nous savons que la base est active et accessible, passons aux choses plus sérieuses. Pour la suite de cet article, nous allons considérer le cas d'une base de données servant à référencer des lieux d'intérêt touristique. Notre base s'appellera tourism-db. C'est le type de base de données qui pourrait par exemple servir à un tour operator ou à un office de tourisme.

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_CouchDB_via_l%27interface_REST#JSONAvant d'aller plus loin, un mot rapide sur le format des données renvoyées par CouchDB:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_CouchDB_via_l%27interface_REST#Ajouter_un_documentLa beauté des architectures REST est d'utiliser le même vocabulaire pour manipuler de manière uniforme les diverses ressources gérées. Nous avons utilisé les méthodes PUT et DELETE pour créer et supprimer des bases de données. Nous utiliserons également PUT et DELETE pour créer et supprimer des documents:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_CouchDB_via_l%27interface_REST#Relire_un_documentRelire les données ne pose aucun problème. Vous l'avez deviné, il faut utiliser une requête GET:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_CouchDB_via_l%27interface_REST#Modifier_un_documentPour la saison à venir, suite à d'importants travaux, l'Hôtel de la Mer offre désormais des chambres supplémentaires. Il est tentant d'utiliser nos connaissances actuelles:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_CouchDB_via_l%27interface_REST#Supprimer_un_documentPoursuivons sur notre lancée. Supprimer ≡ DELETE. Considérons donc l'exemple de l'Hôtel du Borgne – établissement rustique s'il en est...

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_CouchDB_via_l%27interface_REST#ConclusionAvec la suppression se termine notre tour d'horizon des possibilités élémentaires de CouchDB. S'il y avait qu'une chose à retenir ici, ce serait qu'on accède à une base CouchDB exactement comme à un site web: même protocole—même sémantique—mêmes outils.

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_CouchDB_via_l%27interface_REST#Ressources