Dropbox Datastore könyvjelző

Megjelent egy új szolgáltatás a Dropbox palettáján. Röviden összefoglalva adatbázisként is tudjuk használni mostantol. A legjobb, hogy JavaScript API kliens is jár hozzá, amivel később nagyon jól össze lehet hozni mondjuk az Angular.js-es alkalmazásukat.

Ez egy remek lépés volt tőlük, mert ha valaki ezt használja, mint fejlesztő, akkor rákényszeríti a felhasználóit, hogy rendelkezzenek Dropbox fiókkal. Most akkor készítsünk egy egyszerű könyvjelzőalkalmazást.

Első lépések

Miután persze már van egy Dropbox felhasználónk, létre kell hoznunk az alkalmazásunkat egy dedikált felületen, az App Console

Itt sok dolgunk nincsen. Kiválasztjuk a Dropbox API App lehetőséget, kiválasztjuk, hogy mihez szeretnénk hozzáférni. Jelenleg elég lesz a Datastore only opció is. Fájlokkal is lehet játszadozni, de azt most nem vizsgáljuk meg. Ha megvan, akkor adnunk kell egy nevet az alkalmazásnak. Jelen esetben ez a FolyamBookmark. Dropbox-ban egészen jól fejleszthető, mert csak https:// címeket fogad el, mint átirányítási cím. Ez alől csak a localhost kivétel. Tehát a legegyszerűbb, ha létrehozol egy fájlt (vagy letöltöd az itt elkészültet) és feltöltöd valami publikus könyvtárba Dropbox-on. Kapsz hozzá egy publikus címet és azt bemásolod mint Redirect URL. Egyedül a App key, amire szükségünk lesz egyelőre.

HTML

Gyorsan vázoljuk fel a html struktúránkat. Nem lesz sok nem kell félni 🙂

0

Nem hazudtam, mert tényleg nem sok 🙂 A lényeges pont a végén a JavaScript betöltés. Ez ugyanis a Datastores API kliens. Jelenleg még béta címkét kapott, de majd szépen átlendül ezen a fázison. Addig is nyugodtan lehet használni. Bár vigyázz, mert akinek nincs Dropbox fiókja az nem fogja tudnk használni, amíg nem csinál.

Alap JavaScript hozzá

1

Két lényeges pont látható. Jelen példánkban, ha valaki nincs bejelentkezve, akkor egy üres lapot lát maga előtt. Ez azért sem fájdalmas, mert gomb nélkül egyértelműen bejelentkeztetjük a felhasználót, mert most nem akarunk szívni mindenféle dekorációval.

A másik a kliens meghívásakor paraméterben átadott key. Ezt az előző lépésből jól megjegyeztük. Nem? Akkor lapozzunk oda, másoljuk át.

Ha sikeresen bejelentkezett a felhasználó, akkor kiírjuk, hogy ki is ő, nehogy véletlenül ne tudja. Milyen dolog lenne már?

Mielőtt továbbmennénk csináljunk neki valami arcot is. A <title> tag alá (de még a head zárótag főlé) másoljuk be a stílust.

2

A lényeg

Itt az ideje, hogy a már bejelentkezett felhasználónk érjük el az adatbázist. Nem olyan bonyolult ez, mint amilyennek hangzik. Mikor betöltődik az alkalmazás egyből megpróbáljuk azonosítani a látogatót. Ha sikerült, akkor betöltjük a felhasználó információit, majd kiiratjuk. Ezek után inicializáljuk az adatbázist és minden elemet kikérdezve beillesztünk egy li elemet minden linknek. Minden link mellé rakunk egy törlés gombot, hogy lehessen őket törölni. Az egész alatt egy beviteli mező ékeskedik és jelzi számunkra, hogy ide tudjuk beírni a kívánt címet. Ha itt egy entert ütünk, akkor elmentjuk adatbázisba, majd beillesztjük a li elemet.

3

Elnézést a simán csak összecsapott bemutatóért, de ezt most gyorsan le akartam rendezni, hogy +Robert Cartman ezzel kapcsolatos kívánsága mielőbb teljesülhessen.

A végeredmény használható formában elérhető Dropbox-on keresztül, amint átengedik a szűrőn. Publikáláshoz ki kell tölteni egy egyszerű formot, amiben megadod, hogy mi ez és hol érhető el. 🙂

Kapcsolódó cikkek:

URL rövidítő 3. rész

Ugye szeretnénk csinálni egy URL rövidítő alkalmazást. Nincs ezzel semmi baj, mert azt mindenki szeret csinálni. Leginkább azért, mert mindenki más ToDo alkalmazásokat csinál 🙂

Az első részben megtudtuk, hogyan működik az AngularJS. Ezek után, a második részben raktunk mögé egy Node.js-t, hogy erre tudjunk építkezni. Itt az ideje összekötni a kettőt. Amikor beküldünk egy linket, akkor a szerver állítson elő egy rövid címet hozzá. És itt jön a harmadik rész.

Szerver oldali rész

Természetesen mindenkinek ott figyel a gépén az eddigi kód. Akinek mégsem az eléri a Bitbucket tárólót és le bírja tölteni. Létrehoztunk egy /routes/index.js fájlt, amit nem használtunk. Legalábbis nem sok minden volt benne. A jelenlegi tartalma így néz ki:

4

Most akkor itt az ideje okosítani rajta. Ezt a függvényt békén is hagyjuk egyelőre, hogy a későbbiekben ne zavarjon meg minket az elnevezés. Hozzunk létre egy másik függvényt mondjuk addLink néven. Ezen kívül ugyebár hasznos lenne generálni is egyből egy rövid azonosítót neki. Tehát létrehozunk egy Link “Objektumot” is. Az, hogy most nem csak egyszerűen generálunk, később lesz hasznos, amikor majd adatbázisban tároljuk, mert akkor amúgy is ilyen formában fogjuk kezelni.

5

Az elején lévő sok kommentelt részt azért másoltam be, hogy látható legyen hova kell rakni. Az az 5 sor már most is ott van a kódban. Most tulajdonképpen megadtuk, hogy ha az alkalmazásunk kap egy POST kérést, aminek a célja a /link, akkor hívja meg a routes.addLink függvényt és majd az teszi a dolgát.

Ha készen van, akkor futtathatjuk az alkalmazást a jól megszokott node app.js parancssal. Tesztelni, hogy működik-e a legegyszerűbb, ha terminálból meghívjuk az url-t. Ebben nagy segítség tud lenni a curl nevű nagyszerű csomag.

6

Láthatóan szépen visszatért mind a rövid, mind pedig a hosszú linkkel, ha pedig nem adtunk meg linket, akkor a hibával.

Kliens oldali rész

Miután megcsináltuk, hogy a szerver tudjon mit kezdeni majd a kliens kéréseivel, jöhet a kliens. Ehhez nem kell más csinálnunk, csak megmondani az Angular.js-nek a /public/javascripts/app.js fájlban, hogy küldje fel a szerverre, majd az alapján írja ki a linket. Van most jelenleg egy ilyen szép controller-ünk:

7

Nah ezt kell kicsit megokosítani. Most ugyebár csak fixen beírjuk, hogy mik a link adatai és kész. Ezt kell megoldani, mert ez hoszú távon (más a második linknél) problémát okozhat.

8

Hosszúnak tűnik, de nem az csak telepakoltam hasznos kis kommentekkel. Tehát mi történik? Miután meghívódik az addLink függvény egyből elindítunk egy POST kérést. Az Angular.js $http modul függvényei nem paraméterként kérik be a callback-et, hanem úgynevezett ígérettel térnek vissza. Ennek az a logikája, hogy megígéri, hogy ott lesz adat és az ígéretnek van státusza, miszerint még nincs adat vagy van, eseteg hiba történt.

Jelen esetben, ha lefutott, akkor meghíva az általunk megadott callback függvényt, ami két paramétert vár (meg is fogja kapni), ami az adat és a válasz státusza. Egyből meg is nézzük, hogy mi a státusz és ha az nem 200, akkor hiba történt (például 500, 404). Ha nem volt hiba és 200-as kódot kaptunk, akkor megnézzük, hogy van-e error tulajdonsága a kapott adathalmaznak. Ha van, akkor a szervernek nem tetszett valami. Jelen esetben egy ilyen van, ha üres volt a link. Ha ilyen hiba előfordul, akkor szólunk a felhasználónak. Persze lehet kultúráltabban is, mint egy szép alert ablakot feldobatni, de most jó lesz ez is, lévén az oldal többi része se néz ki túl szépen. Ha készen van, akkor majd húzunk rá valami szép felületet is 🙂 Megígérem.

Ha nem volt hiba sehol, akkor a kapott adatokból a short értéket felölírjuk, mert most csak egy 7 karakter hosszú azonosítót tartalmaz, amiből valós linket kellene készíteni. Erre már ott van az App.utils.url.get függvényünk, azt nem is bántjuk most. Egyelőre. Ha megvan, akkor betoljuk a $scope.links tömbünk elejére, aminek hatására megjelenik az oldalon is.

Összefoglaló

Tudom, hogy megint nagyon sokat kellett várni a következő részre, de lassan megszokom, hogy buzgálkodjak ezzel is rendszeresebben. Míg egy “sima” cikk írása elsősorban kutatás, olvasás és írás, addig itt elő is kell állítanom közben a kódot.

Persze nem is arról szólt a cikk, hogy miért tartott ilyen sokáig. Az eddigi kliens és szerver oldali részt most összekötöttük. Persze még mindig nem mentettük el adatbázisba, meg úgy sehova sem az adatokat, de már legalább a két réteg beszélget egymással. Haladás.

Holnap vagy holnapután (tényleg) pedig rakunk bele egy MongoDB-t, amibe elmentjük az adatokat, persze előtte jól leteszteljük, hogy már létezik-e vagy sem.

Kapcsolódó linkek:

A forrás elérhető itt: https://bitbucket.org/folyam/url-r-vid-t

Demo: http://url-rovidito.folyam.info/

Kapcsolódó cikkek: