Operații în CouchDB folosind cURL

Faceți interacțiuni cu CouchDB este foarte ușor odată ce avem acces Futon și prin intermediul interfeței grafice putem începe să creăm documente și colecții, totuși acest lucru este funcțional doar atunci când avem acces la o interfață grafică sau web. În alte medii, cu siguranță vom avea nevoie de o interfață prin intermediul unui serviciu web pentru a putea construi structurile de care vom avea nevoie.
O modalitate foarte simplă de a vă conecta într-un mod „non-grafic” este prin răsuci deoarece cu acest instrument putem trimite cereri prin diferite metode HTTP ce sprijină CouchDB și îl putem folosi și în alte scopuri decât utilizarea CouchDB.
Cerințe
1- Trebuie să avem o instalare funcțională de CouchDBPentru primii pași din acest instrument puteți introduce următorul link, dacă am stabilit utilizatorul administrator trebuie să avem numele dvs. de utilizator și parola.
2- Este necesară o conexiune la Internet pentru a descărca cerințele pentru instalarea răsuci.
3- De asemenea, va trebui să avem permisiuni pentru instalarea aplicațiilor, deoarece în cazul în care nu avem răsuci trebuie să-l instalați.
Instalarea cURL pe Linux
Dacă folosim sisteme bazate pe Linux Ce Ubuntu sau LinuxMint Instalarea de răsuci Este la fel de simplu ca și simpla utilizare a următoarei comenzi de pe consolă:

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

Acest lucru ne va oferi toate instrumentele necesare pentru a putea executa răsuci din linia noastră de comandă și astfel să putem interacționa cu CouchDB.
Instalare de CURL pe Windows
În Windows din păcate procesul este puțin mai complex pentru a putea realiza instalarea răsuciCu toate acestea, nu este o sarcină imposibilă, vom descrie pașii necesari pentru atingerea acestui obiectiv înainte de a interacționa cu CouchDB.
1- Instalați fișierele Visual C ++ 2008 Da 2010 numit redistribuibileLe putem obține gratuit și pentru platformele pe 32 și 64 de biți. În cazul nostru, vom utiliza platforma pe 64 de biți în următorul link.

MARI

2- Actul următor trebuie să instalăm versiunea de OpenSSL corespunzător sistemului nostru, pentru aceasta putem vizita următorul site web unde vom primi pachetul în funcție de sistemul nostru fie pe 64 de biți, fie pe 32 de biți.

3- Odată ce am instalat cerințele preliminare, acum vom continua să descărcăm și să instalăm răsuci Pentru a face acest lucru, vom merge la următorul link și vom obține pachetul generic pentru versiunea noastră, așa cum am făcut în pașii anteriori, vom alege pachetul pe 64 de biți pentru acest caz.

MARI

4- Odată ce fișierul anterior este obținut, îl vom dezarhiva într-un folder și vom face instalarea corespunzătoare.
5- În cele din urmă trebuie să instalăm certificatul SSL, acest pas este foarte important și nu ar trebui să îl omitem, pentru aceasta mergem la următoarea pagină web, odată ce vom descărca fișierul cacert.pem și o vom copia unde o instalăm răsuci în pasul anterior, în cele din urmă l-am redenumit în curl-ca-bundle.crt.
6- Deschidem o consolă cu cmd și mergem la dosarul unde avem răsuci și certificatul anterior și executăm curl.exe --help pentru a vedea diferitele comenzi disponibile. Cu aceasta vom avea deja răsuci instalat pe computerul nostru.
Stabilirea primei noastre conexiuni cu CouchDB
Deoarece avem instrumentul de comunicare cu serviciul și, teoretic, trebuie să ne pregătim CouchDB, acum vom testa că ne putem conecta, pentru aceasta în consola unde avem răsuci vom executa următoarele:

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

Prima opțiune funcționează pentru noi Linux iar al doilea în Windows, deoarece singurul lucru care se schimbă este .exe la sfârșitul comenzii și din moment ce construim tutorialul sub Windows, vom păstra al doilea pentru restul exemplelor. La executarea instrucțiunii anterioare, serverul CouchDB Trebuie să răspundeți arătându-ne un mesaj cu versiunea acestuia.

Acest lucru indică faptul că avem deja acces la CouchDB și putem începe să manipulăm diferitele colecții de documente pe care le avem sau să creăm altele noi, dacă dorim.
Creați o bază de date
Urmând filosofia serviciilor ODIHNĂ crearea de elemente revine metodei HTTP PUT, de aceea, dacă dorim să creăm o bază de date, trebuie să trimitem doar o cerere PUT de la răsuci și astfel putem îndeplini obiectivul, pentru aceasta putem executa următoarele:

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

Ce se află după adresa CouchDB este numele pe care al nostru Bază de date acest lucru ar trebui să ne ofere un rezultat precum următorul:

Avem o problemă, deoarece instalarea noastră are un utilizator administrator, nu putem avea acces gratuit, dar aceasta nu este o problemă, trebuie doar să trecem numele de utilizator și parola în conexiune după cum urmează:

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

După ce știm acest lucru, vom continua să repetăm ​​comanda cu setările necesare:

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

Acum vedem că, dacă avem un mesaj ok, înseamnă că operațiunea a fost finalizată corect:

Dacă încercăm să repetăm ​​acțiunea vom primi o eroare de atunci CouchDB va valida faptul că baza de date există deja:

Dacă dorim să consultăm conținutul nostru Bază de date trebuie doar să schimbăm metoda A PUNE de OBȚINE și putem valida informații importante despre aceasta:

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

Ceea ce este cu adevărat valoros pentru a ne informa ce se întâmplă cu baza noastră de date în caz că nu suntem siguri.
Creați un document în baza de date
Acum vom trece la cea mai interesantă parte a tutorialului, deoarece avem baza noastră de date, cu siguranță vom fi interesați să stocăm ceva în ea, pentru aceasta trebuie să inserăm documente. Documentele din CouchDB sunt compuse sub structură JSON, deci trebuie să trimitem datele astfel încât să poată fi procesate.
În răsuci Trebuie doar să stabilim antetul cererii pe care o trimitem și să indicăm că este JSON, apoi vă oferim traseul nostru Bază de date pe care le-am creat dar în acest caz folosind metoda POSTși, în cele din urmă, vă transmitem conținutul noului nostru document.
Să vedem următorul cod care ne permite adăugați un document la baza de date pe care am creat-o în exercițiul anterior:

curl.exe -H „Content-type: application / json” -X POST http: //root:[email protected]:5984/db-test -d \ “{\" title \ ": \" First Document \ "}"

Rețineți că am plasat bare de evacuare pentru ghilimele duble în interiorul JSON, acest lucru ne-ar da un mesaj ok la fel ca atunci când ne-am creat baza de date:

Dacă am observat răspunsul ok nu a venit singur, ne-a adus și alte domenii în cadrul JSON unul corespunde merge a documentului din cadrul Bază de date și altul la recenzie.
Consultați după id
Ultimul paragraf al exemplului anterior ne duce la acest nou exercițiu, care este să consultăm un document al nostru Bază de date, pentru aceasta trebuie pur și simplu să facem o cerere OBȚINE și treceți numărul de identificare după numele bazei de date, de exemplu:

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

Să ne amintim asta merge sunt diferite în fiecare echipă, deoarece este o hash unic, așa că trebuie să pună ID-ul corespunzător propriei interogări. În cele din urmă, acest lucru ne va oferi următorul rezultat, după cum putem vedea în următoarea imagine:

Ștergeți baza de date
Ultima metodă pe care nu am văzut-o este cea a ȘTERGE, așa cum indică numele său, ne permite să eliminăm resursele, este foarte puternic, deoarece va extrage de pe serverul nostru ceea ce se potrivește cu parametrul de căutare al aceluiași.
Să ștergem Bază de date pe care le-am creat pentru a demonstra cum o putem folosi, trebuie pur și simplu să folosim următoarea comandă:

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

Acest lucru va elimina Bază de date Împreună cu toate documentele dvs., deci trebuie să fim atenți atunci când folosim această metodă, să vedem cum este rezultatul:

Dacă repetăm ​​căutarea prin OBȚINE În același mod în care l-am folosit în primul exercițiu al tutorialului, vom vedea că nu vom avea un rezultat, pur și simplu CouchDB Ne va spune că nu poate găsi resursa așa cum vedem în următoarea imagine:

Cu aceasta terminăm acest tutorial, am văzut cum putem instala instrumentul răsuci și cu aceasta faceți interacțiuni directe cu serverul nostru CouchDB, acest tip de manipulare ne ajută să înțelegem mai multe despre procesul din spatele acestui mare motor al Bază de dateși ne arată, de asemenea, că putem folosi consola fără a fi nevoie să gestionăm un anumit limbaj de programare.V-a plăcut și ați ajutat acest tutorial?Puteți recompensa autorul apăsând acest buton pentru a-i oferi un punct pozitiv