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
2- Neste handling må vi installere versjonen av OpenSSL tilsvarende vårt system, for dette kan vi besøke følgende nettsted der vi vil få pakken i henhold til systemet vårt enten 64 bits eller 32 bits.3- Når vi har installert forutsetningene, fortsetter vi med å laste ned og installere cURL For å gjøre dette, går vi til følgende lenke og får den generiske pakken for vår versjon, slik vi har gjort i de foregående trinnene, vil vi velge 64-biters pakke for denne saken.
FORSTØRRE
4- Når den forrige filen er oppnådd, skal vi pakke den ut i en mappe og gjøre den tilsvarende installasjonen.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.
Dette indikerer at vi allerede har tilgang til SofaDB og vi kan begynne å manipulere de forskjellige samlingene av dokumenter vi har, eller lage nye hvis vi ønsker det.
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:
Vi har et problem, ettersom installasjonen vår har en administratorbruker, vi kan ikke ha gratis tilgang, men dette er ikke et problem, vi må bare sende brukernavn og passord i forbindelsen som følger:
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:
Hvis vi prøver å gjenta handlingen, får vi en feilmelding siden SofaDB vil bekrefte at databasen allerede eksisterer:
Hvis vi ønsker å konsultere innholdet i vår Database vi må bare endre metoden for SETTE av FÅ og vi kan validere viktig informasjon om det:
curl.exe -X FÅ http: //root:[email protected]:5984/db-test
Noe som virkelig er verdifullt for å informere oss om hva som skjer med databasen vår hvis vi ikke er sikre.
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:
Hvis vi har lagt merke til svaret på ok, kom det ikke alene, det brakte oss også andre felt innenfor JSON en tilsvarer gå av dokumentet i Database og en annen til anmeldelsen.
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:
Slett databasen
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:
Hvis vi gjentar søket via FÅ På samme måte som vi brukte i den første øvelsen av opplæringen, vil vi se at vi ikke får et resultat, rett og slett SofaDB Den vil fortelle oss at den ikke kan finne ressursen slik vi ser i følgende bilde:
Med dette fullfører vi denne opplæringen, vi har sett hvordan vi kan installere verktøyet cURL og med det gjøre direkte interaksjoner med serveren vår SofaDB, hjelper denne typen håndtering oss til å forstå mer om prosessen bak denne flotte motoren Database, og det viser oss også at vi kan bruke konsollen uten å måtte håndtere et bestemt programmeringsspråk.Likte og hjalp du denne opplæringen?Du kan belønne forfatteren ved å trykke på denne knappen for å gi ham et positivt poeng