Innholdsfortegnelse
Gjør interaksjoner med SofaDB det er veldig enkelt når vi har tilgang til Futon og gjennom det grafiske grensesnittet kan vi begynne å lage dokumenter og samlinger, men dette er bare funksjonelt når vi har en grafisk eller webgrensesnitttilgang. I andre miljøer trenger vi sikkert et grensesnitt gjennom en nettjeneste for å kunne bygge strukturene vi trenger.En veldig enkel måte å koble til på en "ikke-grafisk" måte er gjennom cURL siden med dette verktøyet kan vi sende forespørsler under de forskjellige metodene HTTP hva støtter SofaDB og vi kan også bruke den til andre formål enn bruk av SofaDB.
Krav
1- Vi må ha en funksjonell installasjon av SofaDBFor de første trinnene i dette verktøyet kan du angi følgende lenke. Hvis vi har opprettet administratorbrukeren, må vi ha brukernavnet og passordet ditt.
2- En Internett -tilkobling er nødvendig for å laste ned kravene for installasjon av cURL.
3- Vi må også ha tillatelser til å installere applikasjoner, siden hvis vi ikke har det cURL du må installere den.
Installere cURL på Linux
Hvis vi bruker systemer basert på Linux Hva Ubuntu eller LinuxMint Installasjonen av cURL Det er så enkelt som bare å bruke følgende kommando fra konsollen:
sudo apt-get updatesudo apt-get install curl libcurl3 libcurl3-dev php5-curlDette vil gi oss alle de nødvendige verktøyene for å kunne utføre cURL fra kommandolinjen vår og dermed kunne samhandle med SofaDB.
Installasjon de cURL på Windows
I Windows dessverre er prosessen litt mer kompleks for å kunne oppnå installasjon av cURLImidlertid er det ikke en umulig oppgave, vi vil beskrive trinnene som er nødvendige for å nå dette målet før du interagerer med SofaDB.
1- Installer filene Visual C ++ 2008 Y 2010 kalt videredistribuerbareVi kan få disse gratis og for 32-biters og 64-biters plattformer. I vårt tilfelle vil vi bruke 64-biters plattform i følgende lenke.
FORSTØRRE
FORSTØRRE
5- Til slutt må vi installere sertifikatet SSL, dette trinnet er veldig viktig, og vi bør ikke hoppe over det, for dette går vi til følgende webside, når vi kommer til å laste ned filen cacert.pem og vi skal kopiere det der vi installerer cURL i forrige trinn endret vi navnet på det til curl-ca-bundle.crt.
6- Vi åpner en konsoll med cmd og vi går til mappen der vi har krøll og det forrige sertifikatet, og vi utfører curl.exe -hjelp for å se de forskjellige kommandoene som er tilgjengelige. Med dette vil vi allerede ha cURL installert på datamaskinen vår.
Etablere vår første forbindelse med CouchDB
Siden vi har kommunikasjonsverktøyet med tjenesten og i teorien må vi ha forberedt oss SofaDB, nå skal vi teste at vi kan koble til, for dette i konsollen der vi har krøll vi skal utføre følgende:
curl http: //127.0.0.1:5984curl.exe http: //127.0.0.1:5984Det første alternativet fungerer for oss Linux og den andre i Windows, siden det eneste som endres er .exe på slutten av kommandoen, og siden vi bygger opplæringen under Windows, skal vi beholde den andre for resten av eksemplene. Ved utførelse av forrige instruksjon serveren SofaDB Du må svare ved å vise oss en melding med versjonen av den.
Lag en database
Etter filosofien om tjenester HVILE elementskaping faller til metoden HTTP PUT, derfor må vi bare sende en PUT -forespørsel fra hvis vi vil opprette en database cURL og dermed kan vi nå målet, for dette kan vi utføre følgende:
curl.exe -X PUT http: //127.0.0.1:5984/test-bdHva er etter adressen til SofaDB er navnet som vår Database dette burde gi oss et resultat som følgende:
http: //user:[email protected]:5984/Etter å ha visst dette, fortsetter vi med å gjenta kommandoen med de nødvendige innstillingene:
curl.exe -X PUT http: //root:[email protected]:5984/db-testNå ser vi at hvis vi har en ok melding, betyr det at operasjonen ble fullført riktig:
curl.exe -X FÅ http: //root:[email protected]:5984/db-test
Lag et dokument i databasen
Nå skal vi gå videre til den mest interessante delen av opplæringen, siden vi har vår database, vil vi sikkert være interessert i å lagre noe i den, for dette må vi sette inn dokumenter. Dokumentene i SofaDB er komponert under strukturen JSON, så det er på denne måten vi må sende dataene slik at de kan behandles.
I cURL Vi trenger bare å etablere overskriften til forespørselen vi sender og angi at den er det JSON, så gir vi deg ruten vår Database som vi har opprettet, men i dette tilfellet ved hjelp av metoden POST, og til slutt sender vi deg innholdet i vårt nye dokument.
La oss se følgende kode som tillater oss legge til et dokument til databasen som vi opprettet i forrige øvelse:
curl.exe -H "Innholdstype: applikasjon /json" -X POST http: //root:[email protected]:5984/db-test -d \ "{\" title \ ": \" First Document \ "}"Vær oppmerksom på at vi har plassert fluktstenger for de doble anførselstegnene inne i JSON, dette ville gi oss en ok melding akkurat som da vi opprettet vår database:
Rådfør deg med id
Det siste avsnittet i det forrige eksemplet tar oss til denne nye øvelsen, som er å konsultere et dokument fra oss Database, for dette må vi ganske enkelt komme med en forespørsel FÅ og passerer identifikasjonsnummeret etter navnet på databasen, for eksempel:
curl.exe -X FÅ http: //root:[email protected]:5984/test-bd/90c25e76138e8341bfa1241a3700098eLa oss huske det gå er forskjellige i hvert lag siden det er en hash unik, så de må sette ID -en som tilsvarer deres egen spørring. Dette til slutt vil gi oss følgende resultat som vi kan se på følgende bilde:
Den siste metoden vi ikke har sett er den SLETT, dette som navnet indikerer at det lar oss eliminere ressurser, det er veldig kraftig siden det vil trekke ut fra serveren vår det som samsvarer med søkeparameteren til det samme.
La oss slette Database som vi har laget for å demonstrere hvordan vi kan bruke det, må vi ganske enkelt bruke følgende kommando:
curl.exe -X SLETT http: //root:[email protected]:5984/test-bdDette vil eliminere Database Sammen med alle dokumentene dine, så vi må være forsiktige når vi bruker denne metoden, la oss se hvordan resultatet er:
