Gestion des données avec SQLite sous Android

Transcription

1 Gestion des données avec SQLite sous Android La base de données SQLite SQLite est une base de données Open Source embarquée dans le système Android. SQLite supporte les types suivants : NULL : valeur non définie TEXT : équivalent à String en Java INTEGER : équivalent à Long en Java REAL : équivalent à Double en Java BLOB : la donnée est enregistrée comme elle a été donnée Les autres types doivent être convertis dans un de ces types définis ci-dessus avant l'insertion en base. SQLite n'offre pas de support concernant la validation de ces types lors de l'insertion. SQLite est disponible sur n'importe quel terminal sous Android. Utiliser une base SQLite ne requiert aucune étape d'administration ou de paramétrage préalable. Il suffit simplement d'écrire les requêtes SQL permettant de créér ou de mettre à jour la base de données. Celle-ci est ensuite gérée automatiquement par la plateforme Android. Accéder à une base de données SQLite implique en fait d'accéder à un fichier stocké quelque part sur le système de fichier. Cette opération peut être plus ou moins longue. Il est donc recommandé de réaliser toutes les opérations sur la base de données de manière asynchrone, par exemple via la classe AsyncTask de l'api Android. Par défaut, la base de données est sauvegardée dans l'espace réservé à l'application : /data/data/<package de l'application>/databases/<nom de la base de données> Le sous package android.database.sqlite contient les classes spécifiques à SQLite. La classe SQLiteDatabase est la classe principale permettant de travailler avec les bases de données SQLite. Elle offre plusieurs méthodes pour accéder à la base de données, exécuter des requêtes pour récupérer un ensemble de données ou pour mettre à jour la base et fermer la base de données : insert*() : méthodes pour insérer une donnée dans une table execsql() : exécuter une requête SQL qui ne retourne pas ou ne modifie pas ou ne supprime pas des données query*() : retourne un Cursor sur les données en fonction de paramètres donnés rawquery() : retourne un Cursor en prenant en entrée directement une requête SQL update*() : méthodes pour mettre à jour un ensemble de données delete() : méthode pour supprimer un ensemble de données Les méthodes insert*() et update*() utilisent en paramètre la classe ContentValues qui décrit sous forme de clé / valeur la donnée à insérer en base. Objet Cursor Les méthodes query*() et rawquery() retournent un objet Cursor. Cet objet représente le résultat de la requête exécutée et pointe généralement sur un élément de la liste du résultat. Ce principe permet d'éviter de devoir tout charger en mémoire. La classe Cursor offre les méthodes nécessaires pour naviguer dans la liste des éléments du résultat de la requête : getcount() : retourne le nombre d'éléments du résultat de la requête move*() : méthodes permettant de déplacer le curseur dans le résultat isafterlast() : permet de déterminer si on a atteint la fin de la liste du résultat get*(int columnindex) : ensemble de méthodes permettant de retourner la valeur typée d'une colonne donnée selon son index. Exemple : getlong() ou getstring() getcolumnindex() : retourne l'index correspondant au nom de la colonne ou retourne -1 si le nom de la colonne n'existe pas getcolumnindexorthrow() : retourne l'index correspondant au nom de la colonne ou lève une exception si le nom de la colonne n'existe pas Page 1 sur 5

2 Exemple avec une classe Article Elle va être utilisée pour le passage ou la récupération de paramètres depuis ou vers la base de données. public class Article { protected String reference; protected String designation; protected String prixunitht; protected String quantite; public Article(String unereference, String unedesignation, String unprixunitht) public String getreference() public void setreference(string reference) public String getdesignation() public void setdesignation(string designation) public String getprixunitht() public void setprixunitht(string prixunitht) public String getquantite() public void setquantite(string quantite) Il faut créer une nouvelle classe CreateBdArticle.class et qui hérite de SQLiteOpenHelper. Cette classe va permettre de définir la table qui sera produite lors de l instanciation de celle-ci. public class CreateBdArticle extends SQLiteOpenHelper { private static final String TABLE_ARTICLES = "table_articles"; static final String COL_ID = "_id"; private static final String COL_REF = "REF"; private static final String COL_DES = "DES"; private static final String COL_PU = "PU"; private static final String COL_QTE = "QTE"; private static final String CREATE_BDD = "CREATE TABLE " + TABLE_ARTICLES + " ("+COL_ID+" INTEGER PRIMARY KEY AUTOINCREMENT," + COL_REF + " TEXT NOT NULL, " + COL_DES + " TEXT NOT NULL, " + COL_PU + " TEXT NOT NULL," + COL_QTE + " TEXT NOT NULL);"; public CreateBdArticle(Context context, String name, CursorFactory factory, int version) { super(context, name, factory, version); // TODO Auto-generated constructor public void oncreate(sqlitedatabase db) { // appelée lorsqu aucune base n existe et que la classe utilitaire doit en créer une //on créé la table à partir de la requête écrite dans la variable CREATE_BDD // appelée si la version de la base a changé public void onupgrade(sqlitedatabase db, int oldversion, int newversion) { //On peut supprimer la table et de la recréer db.execsql("drop TABLE " + TABLE_ARTICLES + ";"); oncreate(db); Ensuite il faut créer une nouvelle classe utilitaire BdAdapter.java. Elle va nous permettre de gérer l insertion, la suppression, la modification de articles dans la Base De Données ainsi que de faire des requêtes pour récupérer un article contenu dans la base de données. Page 2 sur 5

3 public class BdAdapter { static final int VERSION_BDD = 1; private static final String NOM_BDD = "articles.db"; static final String TABLE_ARTICLES = "table_articles"; static final String COL_ID = "_id"; static final int NUM_COL_ID = 0; static final String COL_REF = "REF"; static final int NUM_COL_REF = 1; static final String COL_DES = "DES"; static final int NUM_COL_DES = 2; static final String COL_PU = "PU"; static final int NUM_COL_PU = 3; static final String COL_QTE = "QTE"; static final int NUM_COL_QTE = 4; private CreateBdArticle bdarticles; private Contextcontext; private SQLiteDatabase db; public BdAdapter (Context context){ this.context = context; bdarticles = new CreateBdArticle(context, NOM_BDD, null, VERSION_BDD); //si la base n existe pas, l objet SQLiteOpenHelper exécute la méthode oncreate // si la version de la bse a changé, la méthode onupgrade sera lancée // dans les 2 cas l appel à getwritabledatabase ou getreadabledatabase renverra la base // de données en cache, nouvellement ouverte, nouvellement créée ou mise à jour public BdAdapter open (){ db = bdarticles.getwritabledatabase(); return this; public BdAdapter close (){ db.close(); return null; public long insererarticle (Article unarticle){ //Création d'un ContentValues (fonctionne comme une HashMap) ContentValues values = new ContentValues(); //on lui ajoute une valeur associé à une clé (qui est le nom de la colonne où on veut mettre la valeur) values.put(col_ref, unarticle.getreference()); values.put(col_des, unarticle.getdesignation()); values.put(col_pu, unarticle.getprixunitht()); values.put(col_qte, unarticle.getquantite()); //on insère l'objet dans la BDD via le ContentValues return db.insert(table_articles, null, values); private Article cursortoarticle(cursor c){ //Cette méthode permet de convertir un cursor en un article //si aucun élément n'a été retourné dans la requête, on renvoie null if (c.getcount() == 0) return null; //Sinon c.movetofirst(); //on se place sur le premier élément Article unarticle = new Article(); //On créé un article //on lui affecte toutes les infos grâce aux infos contenues dans le Cursor unarticle.setreference(c.getstring(num_col_ref)); unarticle.setdesignation(c.getstring(num_col_des)); unarticle.setprixunitht(c.getstring(num_col_pu)); unarticle.setquantite(c.getstring(num_col_qte)); c.close(); //On ferme le cursor Page 3 sur 5

4 return unarticle; //On retourne l'article public Article getarticlewithdesignation(string designation){ //Récupère dans un Cursor les valeurs correspondant à un article grâce à sa designation) Cursor c = db.query(table_articles, new String[] {COL_ID,COL_REF, COL_DES, COL_PU, COL_QTE, COL_DES + " LIKE \"" + designation +"\"", null, null, null, null); return cursortoarticle(c); public int updatearticle(string ref, Article unarticle){ //La mise à jour d'un article dans la BDD fonctionne plus ou moins comme une insertion //il faut simple préciser quel article on doit mettre à jour grâce à sa référence ContentValues values = new ContentValues(); values.put(col_des, unarticle.getdesignation()); values.put(col_pu, unarticle.getprixunitht()); values.put(col_qte, unarticle.getquantite()); return db.update(table_articles, values, COL_REF + " = \"" +ref+"\"", null); public int removearticlewithref(string ref){ //Suppression d'un article de la BDD grâce à sa référence return db.delete(table_articles, COL_REF + " = \"" +ref+"\"", null); public Cursor getdata(){ return db.rawquery("select * FROM TABLE_ARTICLES", null); Pour tester ces 2 nouvelles classes, il suffit de rajouter la méthode suivante dans la classe MainActivity.java et l appeler juste avant la gestion des boutons. protected void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); setcontentview(r.layout.activity_main); // test de la BD testbd(); public void testbd(){ //Création d'une instance de la classe unarticlesbdd articlebdd = new BdAdapter(this); //Création d'un Article Article unarticle = new Article("ref1", "des1", "10.0","3"); //On ouvre la base de données pour écrire dedans articlebdd.open(); //On insère l'article que l'on vient de créer articlebdd.insererarticle(unarticle); System.out.println("insertion article"); //Pour vérifier que l'on a bien créé un Article dans la BDD //on extrait l article de la BDD grâce à la désignation de l'article que l'on a créé précédemment Article unarticlefrombdd = articlebdd.getarticlewithdesignation("des1"); //Si un unarticle est retourné (donc si le unarticle à bien été ajouté à la BDD) if(unarticlefrombdd!= null){ //On affiche les infos de l Article dans un Toast Toast.makeText(this, unarticlefrombdd.getdesignation(), Toast.LENGTH_LONG).show(); //On modifie le titre de l Article Page 4 sur 5

5 unarticlefrombdd.setdesignation("des2"); //Puis on met à jour la BDD articlebdd.updatearticle(unarticlefrombdd.getreference(), unarticlefrombdd); else { Toast.makeText(this, "Article non trouvé", Toast.LENGTH_LONG).show(); //On extrait l Article de la BDD grâce à sa nouvelle désignation unarticlefrombdd = articlebdd.getarticlewithdesignation("des2"); //S'il existe un Article possédant cette désignation dans la BDD if(unarticlefrombdd!= null){ //On affiche les nouvelles info de l Article pour vérifié que la désignation de l Article a bien été maj Toast.makeText(this, unarticlefrombdd.getdesignation(), Toast.LENGTH_LONG).show(); //on supprime le unarticle de la BDD grâce à son ID articlebdd.removearticlewithref(unarticlefrombdd.getreference()); //On essait d'extraire de nouveau l Article de la BDD toujours grâce à sa nouvelle désignation unarticlefrombdd = articlebdd.getarticlewithdesignation("des2"); //Si aucun unarticle n'est retourné if(unarticlefrombdd == null){ //On affiche un message indiquant que l Article n'existe pas dans la BDD Toast.makeText(this, "Cet article n'existe pas dans la BDD", Toast.LENGTH_LONG).show(); else{ //Si l'article existe (mais normalement il ne devrait pas) //on affiche un message indiquant que l Article existe dans la BDD Toast.makeText(this, "Cet article existe dans la BDD", Toast.LENGTH_LONG).show(); articlebdd.close(); création de quelques enregistrements Dans la classe MainActivity.java on peut rajouter le code suivant pour créer quelques enregistrements dans la base de données. //Création d'une instance de la classe unarticlesbdd articlebdd = new BdAdapter(this); //On ouvre la base de données pour écrire dedans articlebdd.open(); //On insère DES ARTICLES DANS LA BD articlebdd.insererarticle(new Article("ref1", "des1", "10.0","3")); articlebdd.insererarticle(new Article("ref2", "des2", "12.0","6")); articlebdd.insererarticle(new Article("ref3", "des3", "15.0","10")); articlebdd.insererarticle(new Article("ref4", "des4", "11.0","5")); articlebdd.close(); Une fois les enregistrements créés, le code suivant permet de vérifier s ils sont bien présents dans la base de données : Cursor c = articlebdd.getdata(); Toast.makeText(getApplicationContext(), "il y a "+String.valueOf(c.getCount())+" articles dans la BD", Toast.LENGTH_LONG).show(); Ce code permet de récupérer le contenu de la base de données dans un curseur, puis une fenêtre popup affiche le nombre d enregistrements trouvé dans le curseur. Page 5 sur 5