Créer une appli Android Partie 4 : SQLite

Transcription

1 Créer une appli Android Partie 4 : SQLite Java Android Hervé PHILIPPE Promotion

2 Plan SQLite Cursor Présentation DAO Gérer la création/mise à jour de la base de données (SQLiteOpenHelper) Manipuler la BD Parcourir les données Récupérer des données CursorAdapter Optimisations Transactions Prepared Statements Autres optimisations possibles Pour aller plus loin Cursor (->CursorFactory) ContentProvider

3 SQLite Présentation Base de données embarquée qui s inspire de MySQL Syntaxe similaire Plus simple Plus léger mais avec des limitations Pas de serveur Dans le même processus que l application -> peut facilement être intégré dans les mobiles (Android, ios )

4 SQLite DAO Data Access Object : objet d'accès aux données Table dans SQLite Objet en mémoire

5 SQLite DAO Sous Android: DAL = classe dérivée de SQLiteOpenHelper (qui crée l objet SQLiteDatabase) SQLite DAL Data Access Layer

6 SQLite DAO Sous Android: DAL = classe dérivée de SQLiteOpenHelper (qui crée l objet SQLiteDatabase) DAO = classe qui stocke L objet DAL (classe dérivée de SQLiteOpenHelper) L objet «database» (classe SQLiteDatabase) SQLite DAL Data Access Layer DAO Data Access Object

7 SQLite DAO Sous Android: DAL = classe dérivée de SQLiteOpenHelper (qui crée l objet SQLiteDatabase) DAO = classe qui stocke les objets DAL et database Classes métiers SQLite DAL Data Access Layer DAO Data Access Object BLL Business Logic Layer (couche métier)

8 SQLite - DAL Création/maj de la base de données Classe dérivée de SQLiteOpenHelper Méthodes à redéfinir : Constructeur oncreate onupgrade (et éventuellement ondowngrade)

9 SQLite - DAL Création/maj de la base de données Classe dérivée de SQLiteOpenHelper Méthodes à redéfinir : Constructeur public SQLiteOpenHelper(Context context, String name, CursorFactory factory, int version) context : contexte (ou activité) name : nom de la base de données factory : null ou CursorFactory (pour permettre la création d un Cursor personnalisé) version : version de la base de données (paramètre optionnel : DatabaseErrorHandler errorhandler)

10 SQLite - DAL Création/maj de la base de données Classe dérivée de SQLiteOpenHelper Méthodes à redéfinir : Constructeur oncreate public abstract void oncreate(sqlitedatabase db); La base de données est stockée dans un fichier -> appel à oncreate uniquement si le fichier n existe pas Paramètre db : objet base de données qui correspond à un objet cache (en mémoire) du fichier But de oncreate : créer les tables de la base de donnée Commande pour appeler une commande SQL : «execsql(string sql)» sql : commande SQL (dans ce cas, pour créer une table) Remarque : une bonne pratique est de créer des constantes pour toutes les requêtes SQL

11 SQLite - DAL Rappel SQL : CREATE/DROP TABLE Pour créer une table CREATE TABLE nom_de_la_table ( nom_du_champ_1 type {contraintes}, nom_du_champ_2 type {contraintes}, ); Types possibles : NULL pour les données NULL INTEGER pour les entiers (sans virgule) REAL pour les nombres réels (avec virgule) TEXT pour les chaînes de caractères BLOB pour les données brutes Contraintes possibles : PRIMARY KEY {AUTOINCREMENT} pour désigner la clé primaire sur un attribut NOT NULL pour indiquer que cet attribut ne peut valoir NULL CHECK afin de vérifier que la valeur de cet attribut est cohérente DEFAULT sert à préciser une valeur par défaut. Pour supprimer une table DROP TABLE IF EXISTS nom de la table;

12 SQLite - DAL Création/maj de la base de données Classe dérivée de SQLiteOpenHelper Méthodes à redéfinir : Constructeur oncreate onupgrade (et éventuellement ondowngrade) Appel à onupgrade si la version du fichier est inférieure à la version actuelle public abstract void onupgrade(sqlitedatabase db, int oldversion, int newversion); Appel à ondowngrade si la version du fichier est supérieure à la version actuelle public void ondowngrade(sqlitedatabase db, int oldversion, int newversion); But : détruire les tables avec la commande «execsql(string sql)»

13 SQLite - DAO Manipuler la BD Classe DAO Données principales : Les constantes éventuelles pour les requêtes (comme pour la classe DAL) L objet «base de données» (en privé) L objet de la DAL (en privé) Méthodes principales : Constructeur : créer l objet de la DAL open : créer l objet «base de données» close : fermer l objet «base de données» Méthodes pour : lire, mettre à jour, supprimer des données

14 SQLite - DAO Manipuler la BD Classe DAO Données principales : Les constantes éventuelles pour les requêtes (comme pour la classe DAL) L objet «base de données» (en privé), avec un «getter» L objet de la DAL (en privé) Méthodes principales : Constructeur : créer l objet de la DAL Instancier l objet issu de la classe héritant de SQLiteOpenHelper

15 SQLite - DAO Manipuler la BD Classe DAO Données principales : Les constantes éventuelles pour les requêtes (comme pour la classe DAL) L objet «base de données» (en privé) L objet de la DAL (en privé) Méthodes principales : Constructeur : créer l objet de la DAL open : créer l objet «base de données» Instancier l objet «base de données» (c est un «cache», qui doit être toujours mis à jour) Pour être sûr d avoir le fichier ouvert en écriture Méthode «getwritabledatabase» définie dans la classe SQLiteOpenHelper Pour ouvrir la base en écriture, ou lecture s il y a un souci Méthode «getreadabledatabase» définie dans la classe SQLiteOpenHelper

16 SQLite - DAO Manipuler la BD Classe DAO Données principales : Les constantes éventuelles pour les requêtes (comme pour la classe DAL) L objet «base de données» (en privé) L objet de la DAL (en privé) Méthodes principales : Constructeur : créer l objet de la DAL open : créer l objet «base de données» close : fermer l objet «base de données» Appel à la méthode close de l objet «base de données» Remarque : l appel à «getwritabledatabase» ou «getreadabledatabase» entraîne également l appel à la méthode close de l objet «base de données»

17 SQLite - DAO Manipuler la BD Classe DAO Données principales : Les constantes éventuelles pour les requêtes (comme pour la classe DAL) L objet «base de données» (en privé) L objet de la DAL (en privé) Méthodes principales : Constructeur : créer l objet de la DAL open : créer l objet «base de données» close : fermer l objet «base de données» Méthodes pour : ajouter, mettre à jour, supprimer, lire des données

18 SQLite - DAO Ajouter/mettre à jour/supprimer, lire des données Ajouter un élément dans une table Ajouter ou mettre à jour un élément dans une table Mettre à jour un ou plusieurs élément(s) dans une table Supprimer un ou plusieurs élément(s) dans une table Récupérer un ou plusieurs éléments dans une table (méthode rawquery) Récupérer un ou plusieurs éléments dans une table (méthode query)

19 SQLite - DAO Ajouter/mettre à jour/supprimer, lire des données Ajouter un élément dans une table Méthode insert de l objet «base de données» public long insert(string table, String nullcolumnhack, ContentValues values) Exemple : table : nom de la table où la donnée sera ajoutée nullcolumnhack : nom d'une colonne (ou null) à utiliser dans la cas où la donnée à insérer est vide values : dictionnaire contenant les listes de clés/valeurs correspondant aux valeurs des colonnes Retourne l ID de l élément inséré ContentValues value = new ContentValues(); value.put("titre", "Le Hobbit"); value.put("nb_pages", 350); mdb.insert("livres", null, value);

20 SQLite - DAO Ajouter/mettre à jour/supprimer, lire des données Ajouter un élément dans une table Ajouter ou mettre à jour un élément dans une table Méthode replace de l objet «base de données» public long replace(string table, String nullcolumnhack, ContentValues values) table : nom de la table où la donnée sera ajoutée/remplacée nullcolumnhack : nom d'une colonne (ou null) à utiliser dans la cas où la donnée à remplacer est vide values : dictionnaire contenant les listes de clés/valeurs correspondant aux valeurs des colonnes Retourne l ID de l élément ajouté/remplacé Exemple : ContentValues value = new ContentValues(); value.put("titre", "Le Hobbit"); value.put("nb_pages", 350); mdb.replace("livres", null, value);

21 SQLite - DAO Ajouter/mettre à jour/supprimer, lire des données Ajouter un élément dans une table Ajouter ou mettre à jour un élément dans une table Mettre à jour un ou plusieurs élément(s) dans une table Méthode update de l objet «base de données» public int update(string table, ContentValues values, String whereclause, String[] whereargs) table : nom de la table où la donnée sera ajoutée values : dictionnaire contenant les listes de clés/valeurs correspondant aux valeurs des colonnes whereclause : chaîne de caractères contenant les conditions de la clause «WHERE» de la requête SQL Si les valeurs sont des «?», elle seront remplacées par les chaînes contenues dans whereargs whereargs : tableau de valeurs utilisées pour remplacer les «?» dans whereclause Retourne le nombre de lignes mises à jour Exemple : ContentValues value = new ContentValues(); value.put(salaire, m.getsalaire()); mdb.update(table_name, value, KEY + " =?", new String[] {String.valueOf(m.getId())});

22 SQLite - DAO Ajouter/mettre à jour/supprimer, lire des données Ajouter un élément dans une table Ajouter ou mettre à jour un élément dans une table Mettre à jour un ou plusieurs élément(s) dans une table Supprimer un ou plusieurs élément(s) dans une table Méthode delete de l objet «base de données» public int delete(string table, String whereclause, String[] whereargs) table : nom de la table où la donnée sera ajoutée whereclause : chaîne de caractères contenant les conditions de la clause «WHERE» de la requête SQL Si les valeurs sont des «?», elle seront remplacées par les chaînes contenues dans whereargs whereargs : tableau de valeurs utilisées pour remplacer les «?» dans whereclause Retourne le nombre de lignes mises à jour Exemple : public void supprimer(long id) { mdb.delete(table_name, KEY + " =?", new String[] {String.valueOf(id)}); }

23 SQLite - DAO Ajouter/mettre à jour/supprimer, lire des données Ajouter un élément dans une table Ajouter ou mettre à jour un élément dans une table Mettre à jour un ou plusieurs élément(s) dans une table Supprimer un ou plusieurs élément(s) dans une table Récupérer un ou plusieurs éléments dans une table (méthode rawquery) Méthode rawquery de l objet «base de données» public Cursor rawquery(string sql, String[] selectionargs) sql : requête SQL complète Si les valeurs sont des «?», elle seront remplacées par les chaînes contenues dans selectionargs selectionargs : tableau de valeurs utilisé pour remplacer les «?» dans sql Retourne le «Cursor»

24 SQLite - DAO Ajouter/mettre à jour/supprimer, lire des données Ajouter un élément dans une table Ajouter ou mettre à jour un élément dans une table Mettre à jour un ou plusieurs élément(s) dans une table Supprimer un ou plusieurs élément(s) dans une table Récupérer un ou plusieurs éléments dans une table (méthode rawquery) Récupérer un ou plusieurs éléments dans une table (méthode query) public Cursor query( boolean distinct, String table, String[] columns, String selection, String[] selectionargs, String groupby, String having, String orderby, String limit) // retourne un Cursor // si vous ne voulez pas de résultats en double. // identifiant de la table // colonnes à afficher // comme whereclause // comme whereargs // pour grouper les résultats // pour filtrer parmi les groupes // trier les résultats (avec «ASC» ou «DESC») // pour fixer un nombre maximal de résultats voulus

25 Cursor Parcourir les lignes d un curseur Les curseurs sont des objets qui contiennent les résultats d'une recherche dans une base de données Permet d accéder, ligne par ligne, à toutes les valeurs des colonnes Fonctionne un peu comme un iterator Méthodes pour parcourir les lignes : int getcount() pour récupérer les nombre de lignes boolean movetofirst() pour aller à la première ligne boolean movetolast() pour aller à la dernière ligne boolean movetoposition(int position) pour aller à la position voulue boolean movetonext() pour aller à la ligne suivante boolean movetoprevious() pour aller à la ligne précédente close() pour fermer le curseur

26 Cursor Récupérer les informations Les méthodes pour récupérer les valeurs des colonnes sont de la forme gettype où Type est un type de données simple (ex: getstring) Exemple : while (cursor.movetonext()) { long id = cursor.getlong(0); String intitule = cursor.getstring(1); double salaire = cursor.getdouble(2); Metier m = new Metier (id, intitule, salaire); } cursor.close();

27 Cursor CursorAdapter Pour afficher les informations d un Cursor (par exemple avec une ListView), on utilise une classe héritant : de CursorAdapter ou de ResourceCursorAdapter (qui hérite lui-même de CursorAdapter) SimpleCursorAdapter (héritant de ResourceCursorAdapter) permet de se passer de créer sa propre classe Constructeur : SimpleCursorAdapter (Context context, int layout, Cursor c, String[] from, int[] to)

28 Cursor SimpleCursorAdapter Constructeur : SimpleCursorAdapter (Context context, int layout, Cursor c, String[] from, int[] to) Exemple : context : contexte layout : identifiant de la mise en page des vues dans l'adapterview c : curseur après l exécution de la requête from : indique une liste de noms des colonnes afin de lier les données au layout to : contient les TextView qui afficheront les colonnes contenues dans from SimpleCursorAdapter adapter = new SimpleCursorAdapter (context, R.layout.cursor_row, cursor, new String[]{MetierDAO.Intitule, MetierDAO.Salaire}, new int[]{r.id.intitule, R.id.salaire})

29 Cursor CursorAdapter Classe qui hérite de CursorAdapter : Constructeur public CursorAdapter(Context context, Cursor c, int flags) newview : pour créer l affichage d un élément public abstract View newview(context context, Cursor cursor, ViewGroup parent) bindview : pour remplir les données d un élément public abstract void bindview(view view, Context context, Cursor cursor) Classe qui hérite de ResourceCursorAdapter : Constructeur public ResourceCursorAdapter(Context context, int layout, Cursor c, int flags) bindview : même méthode que pour CursorAdapter

30 Optimisations Transactions Le fonctionnement par défaut de SQLite, c est de faire un «commit» après chaque action sur la base de données (auto-commit) Chaque «commit» a un coût important au niveau des performances (la base de donnée est un fichier) On peut aussi choisir de faire le «commit» après un groupe de commandes db.begintransaction() : avant le début des commandes db.settransactionsuccessful() : pour faire le «commit», après l exécution des commandes db.endtransaction() : juste après settransactionsuccessful

31 Optimisations Prepared Statements On peut aussi ajouter des «prepared statements» pour accélérer la formation des requêtes Exemple : String sql = "INSERT INTO " + tablename + " ( name, description ) VALUES (?,? )"; db.begintransaction(); SQLiteStatement stmt = db.compilestatement(sql); for(int x=1; x<=insertcount; x++){ stmt.bindstring(1, "Name # " + x); stmt.bindstring(2, "Description # " + x); stmt.execute(); stmt.clearbindings(); } db.settransactionsuccessful(); db.endtransaction();

32 Optimisations Autres optimisations possibles Créer un «index» dans la base de données SQL Permet d accélérer certaines requêtes basées toujours sur la même colonne (si cette colonne est indexée) Asynchrone Rendre la base de données asynchrone db.execsql("pragma synchronous=off"); Utiliser un CursorLoader pour envoyer une requête de façon asynchrone

33 Pour aller plus loin Cursor / CursorFactory On peut créer son propre type dérivé de Cursor, pour personnaliser finalement le traitement des résultats des requêtes CursorFactory permet de construire l objet personnalisé dérivant de Cursor ContentProvider Il est possible de partager une base de données entre plusieurs applications, grâce au ContentProvider

34 A vous de jouer! Continuer l application pour : Utiliser SQLite pour stocker les données Utiliser un adapter basée sur un «Cursor»