Operationer i CouchDB ved hjælp af cURL

Lav interaktioner med CouchDB det er meget let, når vi har adgang til Futon og gennem den grafiske grænseflade kan vi begynde at oprette dokumenter og samlinger, men dette er kun funktionelt, når vi har en grafisk eller webgrænsefladeadgang. I andre miljøer har vi helt sikkert brug for en grænseflade gennem en webservice for at kunne bygge de strukturer, som vi får brug for.
En meget enkel måde at forbinde på en "ikke-grafisk" måde er igennem cURL da vi med dette værktøj kan sende anmodninger under de forskellige metoder HTTP hvad der understøtter CouchDB og vi kan også bruge det til andre formål end brugen af CouchDB.
Krav
1- Vi skal have en funktionel installation af CouchDBFor de første trin i dette værktøj kan du indtaste følgende link. Hvis vi har oprettet administratorbrugeren, skal vi have dit brugernavn og din adgangskode.
2- En internetforbindelse er nødvendig for at downloade kravene til installationen af cURL.
3- Vi bliver også nødt til at have tilladelser til at installere applikationer, da i tilfælde af ikke at have cURL du skal installere det.
Installation af cURL på Linux
Hvis vi bruger systemer baseret på Linux Hvad Ubuntu eller LinuxMint Installation af cURL Det er så enkelt som blot at bruge følgende kommando fra konsollen:

sudo apt-get updatesudo apt-get install curl libcurl3 libcurl3-dev php5-curl

Dette vil give os alle de nødvendige værktøjer til at kunne udføre cURL fra vores kommandolinje og dermed være i stand til at interagere med CouchDB.
Installation de cURL på Windows
I Windows desværre er processen lidt mere kompleks for at kunne opnå installationen af cURLDet er imidlertid ikke en umulig opgave, vi vil beskrive de trin, der er nødvendige for at nå dette mål, før vi interagerer med CouchDB.
1- Installer filerne Visual C ++ 2008 Y 2010 hedder videredistribuerbareVi kan få disse gratis og til 32-bit og 64-bit platforme. I vores tilfælde vil vi bruge 64-bit platformen i det følgende link.

FORSTØRRE

2- Næste akt skal vi installere versionen af OpenSSL svarende til vores system, til dette kan vi besøge følgende websted, hvor vi får pakken ifølge vores system enten 64 bit eller 32 bit.

3- Når vi har installeret forudsætningerne, fortsætter vi nu med at downloade og installere cURL For at gøre dette vil vi gå til følgende link og hente den generiske pakke til vores version, som vi har gjort i de foregående trin, vælger vi 64-bit pakken til denne sag.

FORSTØRRE

4- Når den forrige fil er opnået, skal vi pakke den ud i en mappe og foretage den tilsvarende installation.
5- Endelig skal vi installere certifikatet SSL, dette trin er meget vigtigt, og vi skal ikke springe det over, for dette går vi til den følgende webside, når vi er der, skal vi downloade filen cacert.pem og vi kommer til at kopiere det, hvor vi installerer cURL i det foregående trin omdøbte vi det endelig til curl-ca-bundle.crt.
6- Vi åbner en konsol med cmd og vi går til den mappe, hvor vi har krølle og det tidligere certifikat, og vi udfører curl.exe -hjælp for at se de forskellige tilgængelige kommandoer. Med dette vil vi allerede have cURL installeret på vores computer.
Etablerer vores første forbindelse med CouchDB
Da vi har kommunikationsværktøjet med tjenesten og i teorien skal vi have forberedt CouchDB, nu skal vi teste, at vi kan forbinde, for dette i den konsol, hvor vi har krølle vi vil udføre følgende:

curl http: //127.0.0.1:5984curl.exe http: //127.0.0.1:5984

Den første mulighed virker for os Linux og den anden i Windows, da det eneste, der ændrer sig, er .exe i slutningen af ​​kommandoen, og da vi bygger selvstudiet under Windows, vil vi beholde den anden i resten af ​​eksemplerne. Ved udførelse af den foregående instruktion serveren CouchDB Du skal svare ved at vise os en besked med versionen af ​​den.

Dette indikerer, at vi allerede har adgang til CouchDB og vi kan begynde at manipulere de forskellige samlinger af dokumenter, vi har, eller oprette nye, hvis vi ønsker det.
Opret en database
Efter filosofien om tjenester HVILE elementskabelse falder til metoden HTTP PUT, det er derfor, hvis vi vil oprette en database, skal vi kun sende en PUT -anmodning fra cURL og dermed kan vi opfylde målet, for dette kan vi udføre følgende:

curl.exe -X PUT http: //127.0.0.1:5984/test-bd

Hvad er efter adressen på CouchDB er navnet, som vores Database dette skulle give os et resultat som følgende:

Vi har et problem, da vores installation har en administratorbruger, vi kan ikke have gratis adgang, men dette er ikke et problem, vi skal kun videregive brugernavn og adgangskode i forbindelsen som følger:

http: //user:[email protected]:5984/

Efter at have vidst dette, vil vi fortsætte med at gentage kommandoen med de nødvendige indstillinger:

curl.exe -X PUT http: //root:[email protected]:5984/db-test

Nu ser vi, at hvis vi har en ok besked, betyder det, at operationen blev gennemført korrekt:

Hvis vi forsøger at gentage handlingen, får vi en fejl siden CouchDB vil validere, at databasen allerede findes:

Hvis vi vil konsultere indholdet i vores Database vi skal bare ændre metoden til SÆTTE ved FÅ og vi kan validere vigtige oplysninger om det:

curl.exe -X HENT http: //root:[email protected]:5984/db-test

Hvilket er virkelig værdifuldt at informere os om, hvad der sker med vores database, hvis vi ikke er sikre.
Opret et dokument i databasen
Nu går vi videre til den mest interessante del af selvstudiet, da vi har vores database, vil vi helt sikkert være interesseret i at gemme noget i den, for dette skal vi indsætte dokumenter. Dokumenterne i CouchDB er sammensat under strukturen JSON, så det er på denne måde, at vi skal sende dataene, så de kan behandles.
I cURL Vi behøver kun at etablere overskriften på den anmodning, vi sender, og angive, at den er det JSON, så giver vi dig ruten til vores Database som vi har oprettet, men i dette tilfælde ved hjælp af metoden STOLPE, og endelig sender vi dig indholdet af vores nye dokument.
Lad os se følgende kode, der tillader os tilføj et dokument til den database, som vi oprettede i den forrige øvelse:

curl.exe -H “Indholdstype: applikation /json” -X POST http: //root:[email protected]:5984/db-test -d \ “{\" title \ ": \" Første dokument \ "}"

Bemærk, at vi har placeret flugtstænger til de dobbelte citater inde i JSON, dette ville give os en ok besked, ligesom da vi oprettede vores database:

Hvis vi har bemærket svaret på ok, kom det ikke alene, det bragte os også andre felter inden for JSON man svarer til gå af dokumentet i Database og en anden til anmeldelsen.
Rådfør dig ved id
Det sidste afsnit i det foregående eksempel tager os til denne nye øvelse, som er at konsultere et dokument af vores Database, for dette er vi simpelthen nødt til at fremsætte en anmodning FÅ og videregive identifikationsnummeret efter databasens navn, for eksempel:

curl.exe -X HENT http: //root:[email protected]:5984/test-bd/90c25e76138e8341bfa1241a3700098e

Lad os huske det gå er forskellige på hvert hold, da det er en hash unik, så de skal sætte id'et, der svarer til deres egen forespørgsel. Dette i sidste ende vil give os følgende resultat, som vi kan se på følgende billede:

Slet databasen
Den sidste metode, som vi ikke har set, er den SLET, dette som navnet angiver det giver os mulighed for at fjerne ressourcer, det er meget kraftfuldt, da det vil udtrække fra vores server, hvad der matcher søge -parameteren for det samme.
Lad os slette Database som vi har oprettet for at demonstrere, hvordan vi kan bruge det, skal vi simpelthen bruge følgende kommando:

curl.exe -X SLET http: //root:[email protected]:5984/test-bd

Dette vil fjerne Database Sammen med alle dine dokumenter, så vi skal være forsigtige, når vi anvender denne metode, lad os se, hvordan resultatet er:

Hvis vi gentager søgningen via FÅ På samme måde som vi brugte i den første øvelse af selvstudiet, vil vi se, at vi simpelthen ikke får et resultat CouchDB Det vil fortælle os, at det ikke kan finde ressourcen, som vi ser på følgende billede:

Med dette afslutter vi denne vejledning, vi har set, hvordan vi kan installere værktøjet cURL og med det lave direkte interaktioner med vores server CouchDB, denne form for håndtering hjælper os med at forstå mere om processen bag denne store motor af Database, og det viser os også, at vi kan bruge konsollen uden at skulle håndtere et bestemt programmeringssprog.Kan du lide og hjælpe denne vejledning?Du kan belønne forfatteren ved at trykke på denne knap for at give ham et positivt punkt