Operazioni in CouchDB usando cURL

Interagisci con CouchDB è molto facile una volta che abbiamo accesso a Futon e attraverso l'interfaccia grafica possiamo iniziare a creare documenti e raccolte, tuttavia questo è funzionale solo quando abbiamo un accesso all'interfaccia grafica o web. In altri ambienti avremo sicuramente bisogno di un'interfaccia tramite a servizio web per poter costruire le strutture di cui avremo bisogno.
Un modo molto semplice per connettersi in modo "non grafico" è attraverso arricciare poiché con questo strumento possiamo inviare richieste con diversi metodi HTTP cosa supporta CouchDB e possiamo anche usarlo per scopi diversi dall'uso di CouchDB.
Requisiti
1- Abbiamo bisogno di avere un'installazione funzionale di CouchDBPer i primi passi in questo strumento puoi inserire il seguente link, se abbiamo stabilito l'utente amministratore dobbiamo avere il tuo nome utente e password.
2- È necessaria una connessione Internet per scaricare i requisiti per l'installazione di arricciare.
3- Avremo anche bisogno di avere i permessi per installare le applicazioni, poiché in caso di non avere arricciare devi installarlo.
Installazione di cURL su Linux
Se utilizziamo sistemi basati su Linux Che cosa Ubuntu o LinuxMint L'installazione di arricciare È semplice come usare il seguente comando dalla console:

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

Questo ci darà tutti gli strumenti necessari per essere in grado di eseguire arricciare dalla nostra riga di comando e quindi essere in grado di interagire con CouchDB.
Installazione de cURL su Windows
Nel finestre purtroppo il processo è un po' più complesso per poter realizzare l'installazione di arricciareTuttavia, non è un compito impossibile, descriveremo i passaggi necessari per raggiungere questo obiettivo prima di interagire con CouchDB.
1- Installa i file Visual C++ 2008 sì 2010 chiamata ridistribuibiliPossiamo ottenerli gratuitamente e per piattaforme a 32 e 64 bit. Nel nostro caso utilizzeremo la piattaforma a 64 bit al seguente link.

INGRANDIRE

2- Il prossimo atto dobbiamo installare la versione di Apri SSL corrispondente al nostro sistema, per questo possiamo visitare il seguente sito Web dove otterremo il pacchetto in base al nostro sistema a 64 bit o 32 bit.

3- Una volta installati i prerequisiti, ora procederemo al download e all'installazione arricciare Per fare ciò, andremo al seguente link e otterremo il pacchetto generico per la nostra versione, come abbiamo fatto nei passaggi precedenti, sceglieremo il pacchetto a 64 bit per questo caso.

INGRANDIRE

4- Una volta ottenuto il file precedente, lo decomprimeremo in una cartella e faremo l'installazione corrispondente.
5- Infine dobbiamo installare il certificato SSL, questo passaggio è molto importante e non dovremmo saltarlo, per questo andiamo alla seguente pagina web, una volta lì scaricheremo il file cacert.pem e lo copieremo dove installiamo arricciare nel passaggio precedente, l'abbiamo finalmente rinominato in curl-ca-bundle.crt.
6- Apriamo una console con cmd e andiamo nella cartella dove abbiamo arricciare e il certificato precedente ed eseguiamo curl.exe --help per vedere i diversi comandi disponibili. Con questo avremo già arricciare installato sul nostro computer.
Stabilire la nostra prima connessione con CouchDB
Dato che abbiamo lo strumento di comunicazione con il servizio e in teoria dobbiamo aver preparato CouchDB, ora testeremo che possiamo connetterci, per questo nella console dove abbiamo arricciare eseguiremo quanto segue:

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

La prima opzione funziona per noi Linux e il secondo in finestre, poiché l'unica cosa che cambia è il .EXE alla fine del comando e poiché stiamo costruendo il tutorial sotto Windows, manterremo il secondo per il resto degli esempi. Durante l'esecuzione dell'istruzione precedente il server CouchDB Devi rispondere mostrandoci un messaggio con la versione di esso.

Questo indica che abbiamo già accesso a CouchDB e possiamo iniziare a manipolare le diverse raccolte di documenti che abbiamo o crearne di nuove se lo desideriamo.
Crea un database
Seguendo la filosofia dei servizi RIPOSO la creazione dell'elemento dipende dal metodo HTTP PUT, ecco perché se vogliamo creare un Database dobbiamo solo inviare una richiesta PUT da arricciare e quindi possiamo raggiungere l'obiettivo, per questo possiamo eseguire quanto segue:

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

Cosa c'è dopo l'indirizzo di CouchDB è il nome che il nostro Banca dati questo dovrebbe darci un risultato come il seguente:

Abbiamo un problema, poiché la nostra installazione ha un utente amministratore, non possiamo avere accesso gratuito, ma questo non è un problema, dobbiamo solo passare il nome utente e la password nella connessione come segue:

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

Dopo averlo saputo, procederemo a ripetere il comando con le impostazioni necessarie:

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

Ora vediamo che se abbiamo un messaggio ok, significa che l'operazione è stata completata correttamente:

Se proviamo a ripetere l'azione otterremo un errore poiché CouchDB convaliderà che il database esiste già:

Se vogliamo consultare il contenuto del nostro Banca dati dobbiamo solo cambiare il metodo di METTERE di OTTENERE e possiamo convalidare importanti informazioni a riguardo:

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

Il che è davvero prezioso per informarci su cosa sta succedendo con il nostro database nel caso in cui non fossimo sicuri.
Crea un documento all'interno del Database
Passiamo ora alla parte più interessante del tutorial, dato che abbiamo il nostro Database, sicuramente saremo interessati a memorizzare qualcosa al suo interno, per questo dobbiamo inserire dei documenti. I documenti in CouchDB sono composti sotto la struttura JSON, quindi è in questo modo che dobbiamo inviare i dati affinché possano essere elaborati.
Nel arricciare Dobbiamo solo stabilire l'intestazione della richiesta che stiamo inviando e indicare che lo è JSON, poi vi diamo il percorso del nostro Banca dati che abbiamo creato ma in questo caso utilizzando il metodo INVIARE, e infine vi passiamo il contenuto del nostro nuovo documento.
Vediamo il seguente codice che ci permette aggiungi un documento al Database che abbiamo creato nell'esercizio precedente:

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

Nota che abbiamo inserito le barre di escape per le virgolette all'interno di JSON, questo ci darebbe un messaggio di ok proprio come quando abbiamo creato il nostro database:

Se abbiamo notato la risposta di ok non è arrivata da sola, ci ha portato anche altri campi all'interno del JSON uno corrisponde a andare del documento all'interno del Banca dati e un altro alla recensione.
Consulta per ID
L'ultimo paragrafo dell'esempio precedente ci porta a questo nuovo esercizio, che consiste nel consultare un nostro documento Banca dati, per questo dobbiamo semplicemente fare una richiesta OTTENERE e passare il numero identificativo dopo il nome del Database, ad esempio:

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

Ricordiamolo andare sono diversi in ogni squadra poiché è un hash univoco, quindi devono inserire l'id corrispondente alla propria query. Questo alla fine ci darà il seguente risultato come possiamo vedere nell'immagine seguente:

Elimina il database
L'ultimo metodo che non abbiamo visto è quello di ELIMINA, questo come indica il nome ci permette di eliminare risorse, è molto potente poiché estrarrà dal nostro server ciò che corrisponde al parametro di ricerca dello stesso.
Cancelliamo il Banca dati che abbiamo creato per dimostrare come possiamo usarlo, dobbiamo semplicemente usare il seguente comando:

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

Questo eliminerà Banca dati Insieme a tutti i tuoi documenti, quindi dobbiamo stare attenti quando utilizziamo questo metodo, vediamo come è il risultato:

Se ripetiamo la ricerca tramite OTTENERE Allo stesso modo che abbiamo usato nel primo esercizio del tutorial vedremo che non avremo un risultato, semplicemente CouchDB Ci dirà che non riesce a trovare la risorsa come vediamo nell'immagine seguente:

Con questo finiamo questo tutorial, abbiamo visto come possiamo installare lo strumento arricciare e con esso effettuare interazioni dirette con il nostro server CouchDB, questo tipo di gestione ci aiuta a capire di più sul processo alla base di questo grande motore di Banca dati, e ci mostra anche che possiamo usare la console senza dover gestire un particolare linguaggio di programmazione.Ti è piaciuto e hai aiutato questo Tutorial?Puoi premiare l'autore premendo questo pulsante per dargli un punto positivo