SQLite para Android: clases y métodos públicos

12/09/2014
Base de Datos, Nivel Medio-Avanzado, Premium

En esta serie de tutoriales trataremos más en profundidad las clases y métodos públicos que intervienen en el proceso de creación, actualización y almacenamiento de registros de una base de datos en Android con la API SQLite (se abordarán las más significativas). También se realizará una exposición de la perspectiva DDMS, deteniéndonos en cada una de las vistas que forman dicha perspectiva, y mostrando un ejemplo que permita poder visualizar los mensajes de registro personalizado usando la clase Log.

API SQLite

Package «android.database.sqlite«: contiene las clases de gestión de bases de datos SQLite que una aplicación podría utilizar para gestionar su propia base de datos privada.

Clases que implementa:

SQLiteOpenHelper (hereda de Object). Clase que ayuda en las tareas de creación y gestión de versiones de Base de Datos.

CONSTRUCTORES PÚBLICOS

SQLiteOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version)

Crear un objeto de ayuda para crear, abrir y / o administrar una base de datos.

SQLiteOpenHelper(Context, String name, SQLiteDatabase.CursorFactory factory, int version, DatabaseErrorHandler errorHandler)

Crear un objeto de ayuda para crear, abrir y / o administrar una base de datos.

MÉTODOS PÚBLICOS
VALOR QUE DEVUELVE	MÉTODOS
synchronized void	close()
	Cierre cualquier objeto de base de datos abierta.
String	getDatabaseName()
	Devuelva el nombre de la base de datos SQLite que se abre.
SQLiteDatabase	getReadableDatabase()
	Crear y / o abrir una base de datos.
SQLiteDatabase	getWritableDatabase()
	Crear y / o abrir una base de datos que se utilizará para lectura y escritura.
void	onConfigure(SQLiteDatabase db)
	Se llama cuando se está configurando la conexión de base de datos, para permitir las características tales como el registro de escritura anticipada o soporte de clave externa.
abstract void	onCreate(SQLiteDatabase db)
	Se llama cuando se crea la base de datos por primera vez.
void	onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion)
	Se llama cuando la base de datos necesita ser degradada.
void	onOpen(SQLiteDatabase db)
	Se llama cuando la base de datos ha sido abierta.
abstract void	onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)
	Se llama cuando la base de datos necesita ser actualizada.
void	setWriteAheadLoggingEnabled(boolean enabled)
	Activa o desactiva el uso del registro de escritura anticipada para la base de datos.

SQLiteDataBase (hereda de SQLiteClosable): contiene los métodos para crear, eliminar, ejecutar comandos SQL y realizar otras tareas de administración de base de datos común.
No define constructores públicos.

MÉTODOS PÚBLICOS
VALOR QUE DEVUELVE	MÉTODOS
int	delete(String table, String whereClause, String[] whereArgs)
	Método de conveniencia para eliminar filas en la base de datos.
static SQLiteDatabase	create(SQLiteDatabase.CursorFactory factory)
	Crea una base de datos SQLite respaldada en memoria.
void	execSQL(String sql)
	Ejecuta una sola sentencia SQL que no es una sentencia SELECT o cualquier otra sentencia SQL que devuelva datos.
void	setVersion(int version)
	Establece la versión de base de datos
int	getVersion()
	Obtiene la versión de base de datos.
long	insert(String table, String nullColumnHack, ContentValues values)
	Método de conveniencia para insertar una fila en la base de datos.
boolean	isOpen()
	Devuelve verdadero si la base de datos está actualmente abierta.
boolean	isReadOnly()
	Devuelve verdadero si se abre la base de datos como sólo lectura.
int	update(String table, ContentValues values, String whereClause, String[] whereArgs)
	Método de conveniencia para la actualización de las filas de la base de datos.
Cursor	query(String table, String[] columns, String selection, String[] selectionArgs, String groupBy, String having, String orderBy, String limit)
	Consulta la tabla dada, devolviendo un cursor sobre el conjunto de resultados.
void	setTransactionSuccessful()
	Marca la transacción actual como un éxito.

SQLiteQuery (hereda de SQLiteProgram): Representa una consulta que lee las filas resultantes dentro de SQLiteQuery.
Esta clase no es segura para subprocesos. No define constructores públicos.