Tutorial 22 - Il componente TinyDB per il salvataggio dei dati

Rieccoci con un nuovo tutorial! Questa volta parleremo del componente TinyDB che si trova nella palette Basic di App Inventor.

Questo componente (di tipo non visibile, ovvero non viene visualizzato nell'interfaccia utente) viene utilizzato tutte le volte che vogliamo memorizzare in maniera "permanente" dei dati nella nostra app.


Come avrete infatti notato con gli altri tutorial, tutti i dati inseriti dall'utente (come ad esempio il testo inserito in una textbox) vengono persi non appena l'applicazione viene chiusa (attenzione, per come gestisce la memoria Android potrete aver visto che anche dopo aver chiuso e riaperto un app creata con AI, l'applicazione è ripartita dall'esatto punto dove l'avevate lasciata, ma questo non vi deve trarre in inganno, se il telefono avesse avuto bisogno di più memoria avrebbe chiuso definitivamente la vostra app ed avreste così perso i dati).

Bene, con questo componente possiamo invece salvare i nostri dati sul telefono in maniera sicura.
TinyDB permette il salvataggio sottoforma di coppie "tag" / "value".
Il tag è il nome con cui vogliamo identificare il nostro dato
mentre il value è ovviamente il valore stesso che vogliamo salvare.
Possiamo così salvare ad esempio l'high score di un nostro videogioco, oppure la textbox inserita precedentemente dall'utente oppure ancora le preferenze della nostra applicazione, insomma come avrete capito il campo di utilizzo è veramente sterminato (per esempio nella mia acqua alta app lo uso per salvare tutta la tabella coi dati di marea in modo da poter usare l'app anche off-line)

Nel nostro esempio vediamo come è possibile salvare il contenuto di una tabella formata da 2 colonne e 3 righe in cui l'utente inserisce un ipotetica nota spese.
L'esempio è volutamente semplice ma fa vedere come si utilizza il componente TinyDB per il salvataggio ed il successivo caricamento dei dati.

Il componente TinyWebDB funziona praticamente allo stesso modo ma salva i dati sul web e richiede un database TinyWeb creato dall'utente sul web (magari in futuro ne vedremo anche il suo utilizzo)

Per ora buona visione!

Per finire vediamo alcune note tecniche su TinyDB:

Proprietà

nessuna

Eventi

nessuno

Metodi

StoreValue(text tag, valueToStore)

Salva il valore dato sotto lo specifico tag. il Tag deve essere una stringa di testo, il valore può essere una stringa o una lista (array)

GetValue(text tag)

Recupera il valore che è stato salvato con il tag specificato. Se nessun valore è stato salvato ritorna una stringa vuota (empty)

I dati salvati possono essere eliminati usando la funzione di sistema di Android, andiamo in applicazioni - gestisci applicazioni - selezioniamo la nostra app. Quando selezioniamo cancella dati andremo a cancellare i dati memorizzati con TinyDB.
Per i più smaliziati, i dati salvati li trovate sotto questo path (è necessario un root explorer per visualizzare la cartella /data/)

/data/data/appinventor.ai_seblog2k.Tutorial_TinyDb/shared_prefs/TinyDB.xml

come vedete il file è un xml e può quindi essere letto e modificato agevolmente anche con altri editor.