Guide de développement

Local Navigation

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

Nom du fichier

Description

SQLiteDemo.java

  • Ce fichier contient le point d'entrée de l'application.
  • Ce fichier contient le constructeur de l'application, qui crée une base de données cryptée sur la carte multimédia du terminal BlackBerry si présente, ou bien dans la mémoire du périphérique. En l'absence de carte multimédia et si le terminal BlackBerry prend en charge le stockage de base de données dans sa mémoire interne, la base de données cryptée est créée dans la mémoire du terminal.
  • Ce fichier crée et affiche une instance de SQLiteDemoScreen.

SQLiteDemoScreen.java

  • Ce fichier contient l'écran principal de l'application, qui affiche la base de données dans une arborescence développable, avec des entrées Category comme nœuds parents et les nœuds enfants DirectoryItems associés.
  • Ce fichier contient des méthodes d'assistance pour remplir l'arborescence à l'initialisation de l'écran.
  • Ce fichier contient des éléments de menu pour l'ajout, la mise à jour et la suppression de catégories et d'éléments du répertoire.

SQLManager.java

Ce fichier contient toutes les méthodes pour l'ajout, la mise à jour et la suppression de catégories et d'éléments du répertoire ; par exemple, toutes les méthodes de manipulation de la base de données.

ItemScreen.java

Ce fichier contient l'écran, qui présente des champs pour l'ajout et la modification de catégories et d'éléments du répertoire.

Category.java

  • Ce fichier définit les entrées Category dans la base de données.
  • Ce fichier fournit les méthodes accessor des champs Category.

DirectoryItems.java

  • Ce fichier définit les entrées DirectoryItems dans la base de données.
  • Ce fichier fournit les méthodes accessor des champs DirectoryItems.

SQLiteDemoDirectory

  • Ce fichier contient la base de données.
  • Ce fichier est fourni pré-renseigné avec des exemples d'entrées.

Installer l'exemple d'application

  1. Dans Eclipse, sous le menu File, cliquez sur Import. .
  2. Dans la boîte de dialogue Import, développez le dossier BlackBerry.
  3. Cliquez sur Import BlackBerry Samples.
  4. Cliquez sur Next.
  5. Effectuez l'une des opérations suivantes :
    • Pour indiquer un JRE précis, sélectionnez l'option Use a project specific JRE.
    • Pour indiquer le JRE par défaut dans l'espace de travail, sélectionnez l'option Use default JRE.
  6. Dans la section BlackBerry Projects (Projets BlackBerry), cliquez sur Deselect All.
  7. Cochez la case en regard du projet SQLiteDemo.
  8. Cliquez sur Finish.

Exécuter l'exemple d'application

  1. Dans Eclipse, dans le volet Navigator, cliquez avec le bouton droit sur le dossier SQLiteDemo.
  2. Cliquez sur Run As > BlackBerry Simulator.
  3. Si BlackBerry Smartphone Simulator n'affiche pas le message "Media card inserted", vous devez Simuler une carte multimédia.
  4. Le cas échéant, sur l'écran d'accueil de BlackBerry Smartphone Simulator, cliquez sur le dossier Downloads.
  5. Cliquez sur l'icône SQLite Demo.

Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.