SQLite

Introduzione a SQLite Oltre alla possibilità di memorizzare informazioni persistenti attraverso Preferences e files, Android mette a disposizione un vero e proprio DBMS relazionale: SQLite. SQLite è un database engine transazionale estremamente flessibile e veloce, che occupa una quantità molto ridotta di spazio su disco: tutte queste caratteristiche lo rendono perfetto per essere utilizzato in un contesto di tipo mobile. Al contrario della maggior parte dei DBMS, non possiede un processo server separato, ma legge e scrive le informazioni direttamente su file. Difatti un database SQLite non è altro che un file, pertanto può essere copiato o spostato in un altro sistema ed il tutto continuerà a funzionare regolarmente. Per permetterci di gestire al meglio i nostri db, Android ci mette a disposizione una serie di API apposite.

SQLiteOpenHelper Una delle classi principali messe a nostra disposizione dalla piattaforma è SQLiteOpenHelper. Estendendo tale classe, è possibile ridefinire i metodi che ci consentono di effettuare le principali operazioni per la gestione del db (creazione e aggiornamento). Tali metodi sono:

SQLiteDatabase La classe SQLiteDatabase rappresenta un’astrazione del db, e fornisce i metodi necessari ad effettuare le principali operazioni di gestione di un database. Generalmente, per ottenere un’istanza di tale classe, si fa riferimento a due metodi esposti dall’helper visto nella precedente slide: getReadableDatabase() e getWritableDatabase(). Tali metodi restituiscono un’istanza di tipo SQLiteDatabase, che consente l’accesso rispettivamente in lettura ed in scrittura al db. Nelle successive slide esamineremo i principali metodi esposti da tale classe.

ExecSQL Tale metodo consente l’esecuzione di qualsiasi comando SQL che non sia di tipo query (quindi che non preveda la restituzione di informazioni da parte del db). Prevede due overload; il primo richiede semplicemente il codice SQL da eseguire, mentre il secondo ci fornisce di passare dei parametri per l’esecuzione dei cosiddetti prepared statements. public void delete(String sql); public void delete(String sql, Object[] bindArgs);

Operazioni comuni Nonostante sia possibile effettuare molte operazioni utilizzando il comando ExecSQL appena descritto, la piattaforma ci offre supporto nativo per le più comuni operazioni che possono essere effettuate sulle varie tabelle. Fra questi: Delete per eliminare delle righe dalla tabella Insert per aggiungere delle nuove righe alla tabella Update per aggiornare le informazioni di una riga Query per eseguire una query generica sul db

Delete L’operazione che ci consente di eliminare uno o più record da una specifica tabella public int delete(String table, String whereClause, String[] whereArgs); Il primo parametro rappresenta il nome della tabella interessata, il secondo la stringa contenente la condizione, mentre l’ultimo gli eventuali parametri per effettuare il bind con la condizione specificata. Il valore di ritorno indica invece il numero di record eliminati (o -1 in caso di errore).

Insert Operazione che ci consente di inserire un nuovo record. public long insert(String table, String nullColumnHack, ContentValues values); Il parametro nullColumnHack rappresenta una colonna il cui valore può essere NULL. Tale colonna sarà utilizzata nel caso in cui volessimo inserire un record con tutti valori NULL oppure di default. L’istruzione “INSERT INTO NomeTabella;” non è ammessa in SQLite, l’unica alternativa è quella di utilizzare la seguente sintassi: “INSERT INTO NomeTabella(nullColumn) VALUES(NULL);” Il parametro ContentValues rappresenta semplicemente una sorta di Map che ci consente di inserire coppie chiave/valore. Il valore di ritorno contiene l’id del record appena inserito.

Query Si differenzia dalle operazioni precedenti in quanto permette di estrarre informazioni dal database. public Cursor query(boolean distinct, String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy, String limit); Distinct ci consente di indicare se vogliamo effettuare una SELECT oppure una SELECT DISTINCT. Table nome delle tabella Columns nomi delle colonne che vorremo selezionare. Selection condizioni per la select (WHERE.. AND..) SelectionArgs array di parametri per il bind. I nomi dei rimanenti parametri rendono semplice comprendere il loro scopo ai fini della query. Il valore di ritorno è un cursore che ci consentirà di ottenere i vari valori delle singole colonne.

Cursor Il valore di ritorno dell’operazione di query è di tipo Cursor. Un’istanza di tale classe rappresenta un cursore, cioè un oggetto in grado di iterare fra i vari record appartenenti al set di risultati restituito. Essa pertanto avrà un puntatore che farà riferimento al record corrente ed una serie di metodi che consentiranno di spostarlo e di ottenere la sua posizione attuale. Tra i più utilizzati: public int getPosition(), restituisce la posizione corrente. public boolean move(int offset), moveToNext(), moveToLast(), moveToFirst(), moveToPrevious, moveToPosition(int position), sono tutti metodi che consentono di spostare il cursore. Il valore di ritorno indica l’eventuale disponibilità di nuove informazioni. public boolean isFirst(), isLast() indica se la posizione del cursore è sul primo valore oppure sull’ultimo

Cursor I metodi principali sono quelli che consentono di accedere ai dati: public int getInt(int columnIndex); public double getDouble(int columnIndex); public String getString(int columnIndex); public byte[] getBlob(int columnIndex); Un metodo di utilità che restituisce l’indice della colonna di nome specificato: public int getColumnIndex(String columnName)

Cursor e query