Bewerkingen in CouchDB met behulp van cURL

Maak interacties met BankDB het is heel gemakkelijk als we eenmaal toegang hebben tot Futon en via de grafische interface kunnen we beginnen met het maken van documenten en collecties, maar dit is alleen functioneel als we een grafische of webinterface toegang hebben. In andere omgevingen hebben we zeker een interface nodig via a webservice om de structuren te kunnen bouwen die we nodig hebben.
Een heel eenvoudige manier om op een "niet-grafische" manier verbinding te maken, is via Krul omdat we met deze tool verzoeken kunnen verzenden onder de verschillende methoden HTTP wat ondersteunt? BankDB en we kunnen het ook voor andere doeleinden gebruiken dan het gebruik van BankDB.
Vereisten
1- We moeten een functionele installatie hebben van: BankDBVoor de eerste stappen in deze tool kunt u de volgende link invoeren, als we de administrator-gebruiker hebben vastgesteld, moeten we uw gebruikersnaam en wachtwoord hebben.
2- Er is een internetverbinding nodig om de vereisten voor de installatie van Krul.
3- We zullen ook machtigingen moeten hebben om applicaties te installeren, omdat in het geval van niet hebben Krul je moet het installeren.
cURL installeren op Linux
Als we systemen gebruiken die zijn gebaseerd op: Linux Wat Ubuntu of LinuxMint De installatie van Krul Het is net zo eenvoudig als het gebruik van de volgende opdracht vanaf de console:

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

Dit geeft ons alle benodigde tools om te kunnen uitvoeren Krul vanaf onze opdrachtregel en dus in staat zijn om te communiceren met BankDB.
Installatie de cURL op Windows
In ramen helaas is het proces een beetje ingewikkelder om de installatie van te kunnen bereiken KrulHet is echter geen onmogelijke taak, we zullen de stappen beschrijven die nodig zijn om dit doel te bereiken voordat we communiceren met BankDB.
1- Installeer de bestanden Visual C++ 2008 Y 2010 genaamd herverdeelbare bestandenWe kunnen deze gratis krijgen en voor 32-bits en 64-bits platforms. In ons geval zullen we het 64-bits platform gebruiken in de volgende link.

VERGROTEN

2- De volgende handeling moeten we de versie van . installeren OpenSSL overeenkomt met ons systeem, hiervoor kunnen we de volgende website bezoeken waar we het pakket volgens ons systeem 64 bits of 32 bits zullen krijgen.

3- Zodra we de vereisten hebben geïnstalleerd, gaan we nu verder met downloaden en installeren Krul Om dit te doen, gaan we naar de volgende link en verkrijgen het generieke pakket voor onze versie, zoals we in de vorige stappen hebben gedaan, we zullen voor dit geval het 64-bits pakket kiezen.

VERGROTEN

4- Zodra het vorige bestand is verkregen, gaan we het uitpakken in een map en de bijbehorende installatie uitvoeren.
5- Eindelijk moeten we het certificaat installeren SSL, deze stap is erg belangrijk en we moeten deze niet overslaan, hiervoor gaan we naar de volgende webpagina, eenmaal daar gaan we het bestand downloaden cacert.pem en we gaan het kopiëren waar we installeren Krul in de vorige stap hebben we het uiteindelijk hernoemd naar curl-ca-bundle.crt.
6- We openen een console met cmd en we gaan naar de map waar we hebben Krul en het vorige certificaat en we voeren uit curl.exe --help om de verschillende beschikbare commando's te zien. Hiermee hebben we al Krul geïnstalleerd op onze computer.
Onze eerste verbinding met CouchDB tot stand brengen
Omdat we de communicatietool met de service hebben en in theorie moeten we ons hebben voorbereid BankDB, nu gaan we testen of we verbinding kunnen maken, hiervoor in de console waar we hebben Krul we gaan het volgende uitvoeren:

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

De eerste optie werkt voor ons Linux en de tweede in ramen, aangezien het enige dat verandert de .exe aan het einde van de opdracht en aangezien we de zelfstudie onder Windows bouwen, gaan we de tweede behouden voor de rest van de voorbeelden. Bij het uitvoeren van de vorige instructie de server BankDB U moet reageren door ons een bericht te tonen met de versie ervan.

Dit geeft aan dat we al toegang hebben tot: BankDB en we kunnen beginnen met het manipuleren van de verschillende verzamelingen documenten die we hebben of nieuwe maken als we dat willen.
Een database maken
Volgens de filosofie van diensten RUST UIT het maken van elementen valt onder de methode HTTP-PUT, daarom hoeven we, als we een database willen maken, alleen een PUT-verzoek te sturen van Krul en zo kunnen we het doel bereiken, hiervoor kunnen we het volgende uitvoeren:

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

Wat staat er na het adres van? BankDB is de naam die onze Database dit zou ons een resultaat moeten geven zoals het volgende:

We hebben een probleem, omdat onze installatie een beheerder heeft, kunnen we geen vrije toegang hebben, maar dit is geen probleem, we hoeven alleen de gebruikersnaam en het wachtwoord in de verbinding als volgt door te geven:

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

Nadat we dit weten, gaan we verder met het herhalen van de opdracht met de nodige instellingen:

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

Nu zien we dat als we een ok-bericht hebben, dit betekent dat de bewerking correct is voltooid:

Als we de actie proberen te herhalen, krijgen we een foutmelding omdat BankDB zal valideren dat de database al bestaat:

Als we de inhoud van onze Database we moeten alleen de methode van veranderen NEERZETTEN door KRIJGEN en we kunnen er belangrijke informatie over valideren:

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

Wat erg waardevol is om ons te informeren wat er gebeurt met onze database voor het geval we het niet zeker weten.
Een document maken in de database
Nu gaan we verder met het meest interessante deel van de tutorial, aangezien we onze database hebben, zullen we zeker geïnteresseerd zijn om er iets in op te slaan, hiervoor moeten we documenten invoegen. De documenten in BankDB zijn samengesteld onder de structuur JSON, dus het is op deze manier dat we de gegevens moeten verzenden zodat deze kunnen worden verwerkt.
In Krul We hoeven alleen de kop van het verzoek dat we verzenden vast te stellen en aan te geven dat het is JSON, dan geven we je de route van onze Database die we hebben gemaakt, maar in dit geval met behulp van de methode NA, en tot slot geven we u de inhoud van ons nieuwe document door.
Laten we eens kijken naar de volgende code die ons toestaat een document toevoegen naar de database die we in de vorige oefening hebben gemaakt:

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

Merk op dat we escape-balken hebben geplaatst voor de dubbele aanhalingstekens in de JSON, dit zou ons een ok-bericht geven, net zoals toen we onze database maakten:

Als we het antwoord van ok hebben opgemerkt, kwam het niet alleen, het bracht ons ook andere velden binnen de JSON een komt overeen met Gaan van het document binnen de Database en nog een voor de recensie.
Raadplegen door id
De laatste alinea van het vorige voorbeeld brengt ons bij deze nieuwe oefening, namelijk het raadplegen van een document van onze Database, hiervoor hoeven we alleen maar een verzoek in te dienen KRIJGEN en geef het identificatienummer door achter de naam van de Database, bijvoorbeeld:

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

Laten we dat onthouden Gaan zijn verschillend in elk team, omdat het een hasj uniek, dus ze moeten de id invoeren die overeenkomt met hun eigen zoekopdracht. Dit geeft ons uiteindelijk het volgende resultaat, zoals we kunnen zien in de volgende afbeelding:

De database verwijderen
De laatste methode die we niet hebben gezien is die van VERWIJDEREN, dit zoals de naam aangeeft, stelt het ons in staat om bronnen te elimineren, het is zeer krachtig omdat het van onze server zal extraheren wat overeenkomt met de zoekparameter van hetzelfde.
Laten we de . wissen Database die we hebben gemaakt om te laten zien hoe we het kunnen gebruiken, moeten we gewoon de volgende opdracht gebruiken:

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

Dit zal elimineren Database Samen met al uw documenten, dus we moeten voorzichtig zijn bij het gebruik van deze methode, laten we eens kijken hoe het resultaat is:

Als we de zoekopdracht herhalen via KRIJGEN Op dezelfde manier die we in de eerste oefening van de tutorial hebben gebruikt, zullen we zien dat we gewoon geen resultaat zullen hebben BankDB Het zal ons vertellen dat het de bron niet kan vinden zoals we zien in de volgende afbeelding:

Hiermee sluiten we deze tutorial af, we hebben gezien hoe we de tool kunnen installeren Krul en daarmee directe interacties maken met onze server BankDB, helpt dit type behandeling ons meer te begrijpen over het proces achter deze geweldige motor van Database, en het laat ons ook zien dat we de console kunnen gebruiken zonder een bepaalde programmeertaal te hoeven gebruiken.Vond je deze Tutorial leuk en heb je eraan geholpen?Je kunt de auteur belonen door op deze knop te drukken om hem een ​​positief punt te geven