Obsah
Provádějte interakce s CouchDB je to velmi snadné, jakmile k nim máme přístup Futon a prostřednictvím grafického rozhraní můžeme začít vytvářet dokumenty a kolekce, ale to je funkční pouze tehdy, když máme přístup k grafickému nebo webovému rozhraní. V jiných prostředích budeme určitě potřebovat rozhraní přes webová služba abychom mohli budovat struktury, které budeme potřebovat.Velmi jednoduchý způsob připojení „negrafickým“ způsobem je skrz kučera protože pomocí tohoto nástroje můžeme odesílat žádosti různými způsoby HTTP co podporuje CouchDB a můžeme jej také použít k jiným účelům než k použití CouchDB.
Požadavky
1- Potřebujeme funkční instalaci CouchDBPro první kroky v tomto nástroji můžete zadat následující odkaz, pokud jsme stanovili uživatele správce, musíme znát vaše uživatelské jméno a heslo.
2- Ke stažení požadavků na instalaci je nutné připojení k internetu kučera.
3- Budeme také muset mít oprávnění k instalaci aplikací, protože v případě, že nemáte kučera musíte to nainstalovat.
Instalace cURL na Linux
Pokud používáme systémy založené na Linux Co Ubuntu nebo LinuxMint Instalace kučera Je to tak jednoduché, že jednoduše použijete následující příkaz z konzoly:
sudo apt-get updatesudo apt-get install curl libcurl3 libcurl3-dev php5-curlTo nám poskytne všechny potřebné nástroje, které můžeme provést kučera z našeho příkazového řádku, a tak s ním můžete komunikovat CouchDB.
Instalace de cURL ve Windows
v Okna bohužel je proces o něco složitější, aby bylo možné dosáhnout instalace kučeraNení to však nemožný úkol, před interakcí s ním popíšeme kroky nutné k dosažení tohoto cíle CouchDB.
1- Nainstalujte soubory Visual C ++ 2008 Y 2010 volala redistribuovatelnéMůžeme je získat zdarma a pro 32bitové a 64bitové platformy. V našem případě použijeme 64bitovou platformu v následujícím odkazu.
ZVĚTŠIT
ZVĚTŠIT
5- Nakonec musíme nainstalovat certifikát SSL„Tento krok je velmi důležitý a neměli bychom jej přeskočit, proto přejdeme na následující webovou stránku, jakmile tam soubor stáhneme cacert.pem a my jej zkopírujeme tam, kde instalujeme kučera v předchozím kroku jsme jej nakonec přejmenovali na curl-ca-bundle.crt.
6- Otevřeme konzolu pomocí cmd a jdeme do složky, kde máme kučera a předchozí certifikát a provedeme curl.exe -pomoc abyste viděli různé dostupné příkazy. S tím už budeme mít kučera nainstalované v našem počítači.
Navazujeme naše první spojení s CouchDB
Protože máme komunikační nástroj se službou a teoreticky jsme se museli připravit CouchDB, teď budeme testovat, že se můžeme připojit, a to v konzole, kde máme kučera provedeme následující:
curl http: //127.0.0.1:5984curl.exe http: //127.0.0.1:5984U nás funguje první možnost Linux a druhý v Okna, protože jediná věc, která se mění, je .exe na konci příkazu a protože vytváříme výukový program pod Windows, ponecháme si ten druhý pro zbytek příkladů. Při provádění předchozí instrukce server CouchDB Musíte odpovědět tak, že nám ukážete zprávu s její verzí.
Vytvořte databázi
V návaznosti na filozofii služeb ZBYTEK vytváření prvků spadá do metody HTTP PUT, proto pokud chceme vytvořit databázi, musíme pouze odeslat požadavek PUT z kučera a tak můžeme splnit cíl, za tímto účelem můžeme provést následující:
curl.exe -X VLOŽIT http: //127.0.0.1:5984/test-bdCo je za adresou CouchDB je jméno, které náš Databáze to by nám mělo dát výsledek jako následující:
http: //user:[email protected]:5984/Poté, co jsme to věděli, přistoupíme k opakování příkazu s potřebným nastavením:
curl.exe -X VLOŽIT http: //root:[email protected]:5984/db-testNyní vidíme, že pokud máme zprávu ok, znamená to, že operace byla dokončena správně:
curl.exe -X ZÍSKAT http: //root:[email protected]:5984/db-test
Vytvořte dokument v databázi
Nyní přejdeme k nejzajímavější části tutoriálu, protože máme naši databázi, určitě nás bude zajímat něco do ní uložit, proto musíme vložit dokumenty. Dokumenty v CouchDB jsou složeny pod strukturou JSON, proto musíme data odeslat, aby je bylo možné zpracovat.
v kučera Musíme pouze stanovit záhlaví požadavku, který odesíláme, a uvést, že je JSON, pak vám dáme naši trasu Databáze které jsme vytvořili, ale v tomto případě pomocí metody POŠTA, a nakonec vám předáme obsah našeho nového dokumentu.
Podívejme se na následující kód, který nám to umožňuje přidat dokument do databáze, kterou jsme vytvořili v předchozím cvičení:
curl.exe -H „Content -type: application /json“ -X POST http: //root:[email protected]:5984/db-test -d \ „{\" title \ ": \" První dokument \ "}"Všimněte si toho, že jsme do uvozovek umístili únikové lišty pro uvozovky JSON, to by nám dalo dobrou zprávu, stejně jako když jsme vytvořili naši databázi:
Poraďte se podle id
Poslední odstavec předchozího příkladu nás zavádí k tomuto novému cvičení, kterým je nahlédnout do našeho dokumentu DatabázeK tomu musíme jednoduše požádat DOSTAT a předejte číslo identifikátoru za název databáze, například:
curl.exe -X ZÍSKAT http: //root:[email protected]:5984/test-bd/90c25e76138e8341bfa1241a3700098ePamatujme si to jít se v každém týmu liší, protože jde o a hash jedinečné, takže musí zadat ID odpovídající jejich vlastnímu dotazu. To nám nakonec poskytne následující výsledek, jak můžeme vidět na následujícím obrázku:
Poslední metodou, kterou jsme neviděli, je metoda VYMAZATJak to naznačuje jeho název, umožňuje nám to eliminovat zdroje, je to velmi silné, protože z našeho serveru extrahuje to, co odpovídá stejnému vyhledávacímu parametru.
Vymažeme Databáze kterou jsme vytvořili, abychom ukázali, jak ji můžeme použít, musíme jednoduše použít následující příkaz:
curl.exe -X ODSTRANIT http: //root:[email protected]:5984/test-bdTím se odstraní Databáze Spolu se všemi vašimi dokumenty, takže musíme být při používání této metody opatrní, podívejme se, jaký je výsledek: