Exemple d'application SQLite
Présentation
L'exemple d'application de base de données SQLite montre comment créer une base de données relationnelle persistante, stockée sur le terminal BlackBerry et comment modifier les entrées de la base de données.
La base de données contient deux tableaux appelés Category et DirectoryItems. Le tableau DirectoryItems contient des éléments qui simulent les entrées d'un annuaire d'entreprise. Chaque entrée DirectoryItem contient également un champ CategoryID devant correspondre à une entrée category_id dans le tableau Category (par exemple, Category.category_id est une clé étrangère pour DirectoryItem.categoryID).
L'exemple d'application affiche les entrées dans les tableaux sous forme d'arborescence développable, avec les entrées Category comme nœuds parents et les entrées DirectoryItem comme nœuds enfants des nœuds Category auxquels ils sont associés. L'exemple d'application fournit des éléments de menu pour l'ajout d'une nouvelle catégorie ou d'un élément de répertoire et pour la modification ou la suppression de l'élément du répertoire.
Cet exemple d'application utilise des API conçues pour être utilisées en toute sécurité. L'application doit être signée avant de pouvoir être exécutée. Pour plus d'informations à propos de la signature de code, reportez-vous au Guide d'administration de BlackBerry Signing Authority Tool.
Fichiers de l'exemple d'application
Interfaces proposées
net.rim.device.api.Database
L'interface Database représente la base de données. Cette interface fournit des méthodes de modification d'une base de données sur le terminal BlackBerry, y compris des méthodes de création d'instructions SQL pour ajouter, supprimer ou mettre à jour des enregistrements dans la base de données et des méthodes de validation et d'annulation de transactions dans la base de données. Cette interface fournit également des méthodes de configuration et de récupération des métadonnées de la base de données.
Pour créer la base de données, vous pouvez utiliser l'une des méthodes de la classe DatabaseFactory.
L'exemple d'application utilise cette interface pour créer des instructions afin d'insérer, de supprimer et de mettre à jour des enregistrements dans la base de données.
net.rim.device.api.Statement
L'interface Statement représente une instruction SQL. Vous pouvez utiliser l'interface Statement pour récupérer, ajouter, supprimer ou modifier des entrées dans la base de données.
net.rim.device.api.Cursor
L'interface Cursor fournit des méthodes permettant de parcourir un ensemble de résultats récupéré à l'aide de l'objet Statement. Un objet Statement crée l'objet Cursor à l'aide de la méthode Statement.getCursor() dans le cadre de son processus de requête. Par conséquent, un objet Cursor est toujours associé à une requête spécifique.
Classes présentées
net.rim.device.api.database.Row
La classe Row représente une ligne dans un ensemble de résultats qu'une requête SELECT renvoie.
Cette classe fournit des méthodes de récupération d'indices de colonne dans l'objet Row et des valeurs stockées dans les colonnes de l'objet Row.
Vous créez cette classe à l'aide de la méthode Cursor.getRow().
net.rim.device.api.database.DatabaseFactory
La classe DatabaseFactory fournit des méthodes de création, d'ouverture, de configuration et de suppression d'un objet Database nouveau ou existant. Les options de configuration incluent le stockage, persistant ou non, et le cryptage.
Pour créer une base de données, vous devez utiliser la méthode DatabaseFactory.openOrCreate() ou la méthode DatabaseFactory.create() . Si vous avez déjà créé la base de données, la méthode DatabaseFactory.openOrCreate() renvoie une référence à la base de données.
Créez la base de données sur une carte multimédia et non dans la mémoire du terminal. Seuls quelques terminaux BlackBerry prennent en charge le stockage d'une base de données SQLite dans leur mémoire interne.
Installer l'exemple d'application
- Dans Eclipse, sous le menu File, cliquez sur Import. .
- Dans la boîte de dialogue Import, développez le dossier BlackBerry.
- Cliquez sur Import BlackBerry Samples.
- Cliquez sur Next.
- Effectuez l'une des opérations suivantes :
- Dans la section BlackBerry Projects (Projets BlackBerry), cliquez sur Deselect All.
- Cochez la case en regard du projet SQLiteDemo.
- Cliquez sur Finish.
Exécuter l'exemple d'application
- Dans Eclipse, dans le volet Navigator, cliquez avec le bouton droit sur le dossier SQLiteDemo.
- Cliquez sur Run As > BlackBerry Simulator.
- Si BlackBerry Smartphone Simulator n'affiche pas le message "Media card inserted", vous devez Simuler une carte multimédia.
- Le cas échéant, sur l'écran d'accueil de BlackBerry Smartphone Simulator, cliquez sur le dossier Downloads.
- Cliquez sur l'icône SQLite Demo.
Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.