Aplicación de ejemplo de SQLite
Descripción general
La aplicación de ejemplo de la base de datos SQLite demuestra cómo crear una base de datos relacional constante almacenada en el dispositivo BlackBerry y cómo cambiar las entradas en la base de datos.
La base de datos contiene dos tablas llamadas Category y DirectoryItems. La tabla DirectoryItems contiene elementos que simulan las entradas en una lista de directorio de negocios. Cada entrada de DirectoryItem también contiene un campo CategoryID que debe coincidir con una entrada category_id en la tabla Category (por ejemplo Category.category_id es una clave externa para DirectoryItem.categoryID).
La aplicación de ejemplo muestra las entradas en las tablas como una estructura de árbol que se puede contraer con entradas de Category como nodos padre y entradas de DirectoryItem como nodos hijo de los nodos Category a los que se asociaron. La aplicación de ejemplo ofrece elementos del menú para añadir una nueva categoría o elemento de directorio y para cambiar o eliminar el elemento de directorio.
Esta aplicación de ejemplo utiliza API diseñadas para ser seguros. La aplicación debe firmarse antes de poder ejecutarla. Para obtener más información acerca dela firma de código, consulte la Guía de administración de BlackBerry Signing Authority Tool.
Archivos en la aplicación de ejemplo
Interfaces destacadas
net.rim.device.api.Database
La interfaz Database representa la base de datos. Esta interfaz ofrece los métodos para cambiar una base de datos en el dispositivo BlackBerry, incluidos los métodos para crear declaraciones SQL para añadir, eliminar o actualizar registros en la base de datos y métodos para confirmar y cancelar transacciones en la base de datos. Esta interfaz también ofrece métodos para configurar y recuperar los metadatos de la base de datos.
Para crear la base de datos, puede utilizar uno de los métodos de la clase DatabaseFactory.
La aplicación de ejemplo utiliza esta interfaz para crear las declaraciones e insertar, eliminar y actualizar registros en la base de datos.
net.rim.device.api.Statement
La interfaz Statement representa una declaración de SQL. Puede utilizar la interfazde Statement para recuperar, añadir, eliminar o cambiar las entradas en la base de datos.
net.rim.device.api.Cursor
La interfaz Cursor ofrece métodos para recorrer un conjunto de resultados recuperado mediante el objeto Statement. Un objeto Statement crea el objeto Cursor mediante el método Statement.getCursor() como parte de su proceso de consulta. Por lo tanto, un Cursor siempre se asocia a una consulta específica.
Clases destacadas
net.rim.device.api.database.Row
La clase Row representa una fila en un conjunto de los resultados devueltos por una consulta SELECT.
Esta clase ofrece los métodos para recuperar los índices de columnas en el objeto Row y los valores almacenaron en las columnas del objeto Row.
Esta clase se crea mediante el método Cursor.getRow().
net.rim.device.api.database.DatabaseFactory
La clase DatabaseFactory ofrece métodos para crear, abrir, configurar y eliminar un Database existente o nuevo. Las opciones de configuración incluyen cifrado y almacenamiento constante o no constante.
Para crear una base de datos nueva, debe utilizar el método DatabaseFactory.openOrCreate() o el método DatabaseFactory.create() . Si ya ha creado la base de datos, el método DatabaseFactory.openOrCreate() devuelve una referencia a la base de datos.
Cree la base de datos en una tarjeta de memoria en vez de en la memoria de dispositivo. Sólo determinados dispositivos BlackBerry admiten el almacenamiento de una base de datos de SQLite en la memoria del dispositivo.
Instalar la aplicación de ejemplo
- En Eclipse, en el menú File, haga clic en Import. .
- En el cuadro de diálogo Import, amplíe la carpeta BlackBerry.
- Haga clic en Import BlackBerry Samples.
- Haga clic en Next.
- Lleve a cabo una de las siguientes acciones:
- En la sección BlackBerry Projects, haga clic en Deselect All.
- Seleccione la casilla de verificación situada junto al proyecto SQLiteDemo.
- Haga clic en Finish.
Ejecutar la aplicación de ejemplo
- En Eclipse, en el panel Navigator, haga clic con el botón derecho en la carpeta SQLiteDemo.
- Haga clic en Run As > BlackBerry Simulator.
- Si BlackBerry Smartphone Simulator no muestra el mensaje "Media card inserted", debe Simular una tarjeta de memoria.
- Si es necesario, en la pantalla de inicio de BlackBerry Smartphone Simulator, haga clic en la carpeta Downloads.
- Haga clic en el icono SQLite Demo.
¿Le ha resultado útil esta información? Envíenos sus comentarios.