Операции в CouchDB с помощта на cURL

Направете взаимодействие с CouchDB много е лесно, след като имаме достъп до Футон и чрез графичния интерфейс можем да започнем да създаваме документи и колекции, но това е функционално само когато имаме достъп до графичен или уеб интерфейс. В други среди със сигурност ще се нуждаем от интерфейс чрез a Уеб сервиз за да можем да изградим структурите, които ще ни трябват.
Много прост начин за свързване по "не графичен" начин е чрез къдрица тъй като с този инструмент можем да изпращаме заявки по различните методи HTTP какво поддържа CouchDB и можем да го използваме и за други цели, освен за CouchDB.
Изисквания
1- Трябва да имаме функционална инсталация на CouchDBЗа първите стъпки в този инструмент можете да въведете следната връзка, ако сме установили потребител на администратор, трябва да имаме вашето потребителско име и парола.
2- Необходима е интернет връзка, за да изтеглите изискванията за инсталирането на къдрица.
3- Също така ще трябва да имаме разрешения за инсталиране на приложения, тъй като в случай, че нямаме къдрица трябва да го инсталирате.
Инсталиране на cURL на Linux
Ако използваме системи, базирани на Linux Какво Ubuntu или LinuxMint Инсталирането на къдрица Това е толкова просто, колкото просто да използвате следната команда от конзолата:

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

Това ще ни даде всички необходими инструменти, за да можем да изпълним къдрица от нашия команден ред и по този начин да можете да взаимодействате с CouchDB.
Инсталиране de cURL в Windows
В Windows за съжаление процесът е малко по -сложен, за да може да се постигне инсталирането на къдрицаТова обаче не е невъзможна задача, ще опишем стъпките, необходими за постигане на тази цел, преди да си взаимодействаме CouchDB.
1- Инсталирайте файловете Visual C ++ 2008 Y 2010 Наречен преразпределимиМожем да ги получим безплатно и за 32-битови и 64-битови платформи. В нашия случай ще използваме 64-битовата платформа в следната връзка.

Увеличете

2- Следващото действие трябва да инсталираме версията на OpenSSL съответстващи на нашата система, за това можем да посетим следния уебсайт, където ще получим пакета според нашата система или 64 бита, или 32 бита.

3- След като сме инсталирали предпоставките, сега ще пристъпим към изтегляне и инсталиране къдрица За да направим това, ще отидем на следната връзка и ще получим общия пакет за нашата версия, както направихме в предишните стъпки, ще изберем 64-битовия пакет за този случай.

Увеличете

4- След като се получи предишният файл, ще го разархивираме в папка и ще извършим съответната инсталация.
5- Накрая трябва да инсталираме сертификата SSL, тази стъпка е много важна и не бива да я пропускаме, за това отиваме на следната уеб страница, след като там ще изтеглим файла cacert.pem и ще го копираме там, където инсталираме къдрица в предишната стъпка най -накрая го преименувахме на curl-ca-bundle.crt.
6- Отваряме конзола с cmd и отиваме в папката, където имаме къдрица и предишния сертификат и изпълняваме curl.exe --help за да видите различните налични команди. С това вече ще имаме къдрица инсталиран на нашия компютър.
Установяване на първата ни връзка с CouchDB
Тъй като имаме комуникационния инструмент с услугата и на теория трябва да сме се подготвили CouchDB, сега ще тестваме дали можем да се свържем, за това в конзолата, където имаме къдрица ще изпълним следното:

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

Първият вариант работи за нас Linux а вторият в Windows, тъй като единственото нещо, което се променя, е .exe в края на командата и тъй като изграждаме урока под Windows, ще запазим втория за останалите примери. При изпълнение на предишната инструкция сървърът CouchDB Трябва да отговорите, като ни покажете съобщение с неговата версия.

Това показва, че вече имаме достъп до CouchDB и можем да започнем да манипулираме различните колекции от документи, които имаме, или да създаваме нови, ако желаем.
Създайте база данни
Следвайки философията на услугите ПОЧИВКА създаването на елемент попада в метода HTTP PUT, затова, ако искаме да създадем база данни, трябва само да изпратим PUT заявка от къдрица и по този начин можем да постигнем целта, за това можем да изпълним следното:

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

Какво е след адреса на CouchDB е името, което е нашето База данни това трябва да ни даде резултат като следния:

Имаме проблем, тъй като нашата инсталация има потребител с администратор, не можем да имаме свободен достъп, но това не е проблем, трябва само да предадем потребителското име и паролата във връзката, както следва:

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

След като знаем това, ще продължим да повтаряме командата с необходимите настройки:

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

Сега виждаме, че ако имаме OK съобщение, това означава, че операцията е завършена правилно:

Ако се опитаме да повторим действието, ще получим грешка оттогава CouchDB ще потвърди, че базата данни вече съществува:

Ако искаме да се консултираме със съдържанието на нашата База данни просто трябва да променим метода на СЛАГАМ от ПОЛУЧАВАЙТЕ и можем да потвърдим важна информация за него:

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

Което е наистина ценно да ни информирате какво се случва с нашата база данни, в случай че не сме сигурни.
Създайте документ в базата данни
Сега ще преминем към най -интересната част от урока, тъй като имаме нашата база данни, със сигурност ще имаме интерес да съхраняваме нещо в нея, за това трябва да вмъкнем документи. Документите в CouchDB са съставени под структурата JSON, така че по този начин трябва да изпратим данните, за да могат да бъдат обработени.
В къдрица Трябва само да установим заглавката на искането, което изпращаме, и да посочим, че е така JSON, тогава ние ви предоставяме маршрута на нашия База данни които сме създали, но в този случай използваме метода POSTи накрая ви предоставяме съдържанието на нашия нов документ.
Нека да видим следния код, който ни позволява добавете документ към базата данни, която създадохме в предишното упражнение:

curl.exe -H “Тип съдържание: application /json” -X POST http: //root:[email protected]:5984/db-test -d \ “{\" заглавие \ ": \" Първи документ \ "}"

Обърнете внимание, че сме поставили евакуационни ленти за двойните кавички вътре в JSON, това ще ни даде добре съобщение, точно както когато създадохме нашата база данни:

Ако сме забелязали отговора на ok, той не дойде сам, той ни донесе и други полета в JSON едно съответства на отивам на документа в рамките на База данни и друга към прегледа.
Консултирайте се с id
Последният параграф от предишния пример ни отвежда до това ново упражнение, което е да се консултираме с наш документ База данни, за това просто трябва да направим заявка ПОЛУЧАВАЙТЕ и предайте номера на идентификатора след името на базата данни, например:

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

Нека си припомним това отивам са различни във всеки отбор, тъй като е a хеш уникални, така че те трябва да поставят идентификатора, съответстващ на собствената им заявка. Това в крайна сметка ще ни даде следния резултат, както можем да видим на следното изображение:

Изтрийте базата данни
Последният метод, който не сме виждали, е този на ИЗТРИЙ, това, както името му показва, че ни позволява да премахнем ресурсите, той е много мощен, тъй като ще извлече от нашия сървър това, което съответства на параметъра за търсене на същия.
Нека изтрием База данни което сме създали, за да демонстрираме как можем да го използваме, просто трябва да използваме следната команда:

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

Това ще премахне База данни Заедно с всички ваши документи, така че трябва да бъдем внимателни, когато използваме този метод, нека видим какъв е резултатът:

Ако повторим търсенето чрез ПОЛУЧАВАЙТЕ По същия начин, който използвахме в първото упражнение на урока, ще видим, че просто няма да имаме резултат CouchDB Той ще ни каже, че не може да намери ресурса, както виждаме на следното изображение:

С това приключваме този урок, видяхме как можем да инсталираме инструмента къдрица и с него осъществявайте директни взаимодействия с нашия сървър CouchDB, този вид манипулиране ни помага да разберем повече за процеса зад този страхотен двигател на База данни, и също така ни показва, че можем да използваме конзолата, без да се налага да боравим с определен език за програмиране.Хареса ли ви и помогнахте на този урок?Можете да възнаградите автора, като натиснете този бутон, за да му дадете положителна точка