En esta ocasión no veremos a detalle todo el código que involucra el sistema; sin embargo, puedes encontrar al final de esta entrada los archivos fuentes.
El sistema funciona de la siguiente manera:
- El usuario primero da de alta tipo de monedas en la Sección de Divisas (Su nombre y símbolo).
- Posteriormente el usuario puede dar de alta servicios en la Sección de Servicios (valga la redundancia). Estos servicios son opcionales y pueden seleccionarse cuando un usuario introduce un gasto en el sistema. Ejemplo de servicios: teléfono, gas, luz, educación, restaurantes, entretenimiento, etc.
- Dentro del sistema, el usuario puede dar de alta gastos e ingresos. Estos gastos o ingresos requieren de la fecha, cantidad y divisa con la cual se realizó la operación. De manera opcional se puede introducir un concepto (descripción) y se puede seleccionar un servicio (si se trata de un gasto).

Comenzaremos con el script de nuestra base de datos:

Del código anterior podemos observar que tenemos una tabla tbldivisa, en la cual almacenamos los tipos de moneda que utilizamos. Una tabla tblservicio donde guardamos los servicios ingresados; y una tabla tbloperacion en donde almacenamos las operaciones (gastos e ingresos). Las relaciones entre divisas y servicios con respecto a las operaciones están dadas por el ID de estas tablas (INTNUMDIVISA e INTNUMSERVICIO).

Ahora veremos el código PHP de nuestra que funcionará como servicio:

Los métodos que inician con guión bajo (_) son métodos privados y por lo tanto no podemos acceder a ellos desde Flex. Los otros métodos insertarDivisa, modificarDivisa, eliminarDivisa, obtenerDivisas, etc. son métodos públicos a los cuales accedemos desde Flex.
Observa cómo en los métodos obtenerXXX almacenamos los registros en un arreglo y lo regresamos a nuestra aplicación. Los queries en realidad son muy sencillos, por lo que no requieren explicación; solamente observa cómo en los métodos eliminarServicio y eliminarDivisa hacemos el borrado de los registros que involucran estos registros en la tabla tbloperacion. Esto es para evitar que haya inconsistencia en la base de datos.

Ahora veremos el código principal de nuestra aplicación en Flex.
Para poder hacer uso del AMFPHP necesitamos de las librerías NetConnection y Responder.

Para poder acceder a los servicios en AMFPHP debemos especificar la ruta en la cual se encuentra el archivo gateway.php de AMFPHP:

Al iniciar la aplicación debemos llamar a la función connect pasándole como parámetro el gateway:

Dentro del constructor de la clase Responder debemos especificar las funciones que se ejecutarán en caso de que la llamada haya sido sido exitosa y en caso de que haya existido un error. Para hacer la llamada al servicio utilizamos la función call; a la cual pasamos como parámetro el nombre de la función que queremos llamar y que se encuentra en la clase SistemaGastos.php, nuestro objeto de la clase Responder y los parámetros que debemos pasarle a la función:

Del código anterior podemos deducir que el nombre de nuestra clase en PHP es SistemaGastos y que tiene un método público llamado insertarOperacion.

En caso de que la llamada haya sido exitosa, se ejecutará el método insertarOperacionResult:

En caso contrario, si existiera algún error en la llamada al servicio, la función errorConsulta se ejecutará:

Nuestra forma de alta de operación (Gasto o Ingreso) será la siguiente:

De la imagen anterior puedes saber qué tipo de información estamos solicitando, cuál es la obligatoria (Fecha, Cantidad y Divisa), así como la forma en qué estamos mostrando al usuario las divisas y servicios dados de alta (por medio de ComboBox).

Las partes de código mostradas forman parte de la llamada a una función que se encarga de insertar un registro. El código no tendrá variación cuando se trate de modificar un registro; y cuando se trate de eliminar un registro solamente le pasaremos el ID del registro a eliminar. ¿Pero qué pasa cuando se trata de una consulta? ¿Cómo obtenemos los registros registros regresados por la base de datos? ¿Cómo mostramos esos registros?

Si leíste el tutorial sobre Componente DataGrid y las cuatro entregas del tutorial Sistema de Clientes en AIR sabrás que podemos recorrer cada uno de los registros obtenidos de la base de datos y almacenarlos en un arreglo por medio del método push; posteriormente ese arreglo es pasado al DataGrid como su proveedor de datos (dataProvider).

Primero hacemos la llamada al método realizarConsulta del servicio SistemaGastos:

Definimos el código de nuestra función realizarConsultaResult:

Del código anterior podemos decir que... primero verificamos que el resultado obtenido por el servicio sea distinto de nulo (es decir, que no esté vacío) ya que si no nos mostraría error. En la variable totalRegistros almacenamos el número de registros obtenidos mediante la propiedad length del arreglo. Recorremos el arreglo result por medio de un ciclo for y dentro de este ciclo hacemos las operaciones que requerimos con los valores obtenidos. Observa que para acceder a cada una de las columnas de nuestros registros lo hacemos de la forma result[i].STRNOMBRE, result[i].STRSIMBOLO, result[i].INTNUMDIVISA, etc. donde STRNOMBRE, STRSIMBOLO, ... son los nombres de nuestras columnas en la tabla tbloperacion de nuestra base de datos. Dentro del código de nuestro ciclo for estamos sumando (ingreso) o restando (si se trata de gasto) las cantidades pertenecientes a un mismo tipo de moneda; y así mostrar la cantidad ganada o gastada por tipo de moneda.

Dentro del archivo SistemaGastos.php observarás que el código de la función realizarConsulta es largo y está lleno de condicionales. Esto es porque las consultas las podemos realizar de acuerdo a los siguientes criterios:

Hemos llegado al final de este tutorial, no olvidemos revisar el ejemplo y bajar los archivos fuentes.

En esta ocasión veremos cómo realizar consultas de los registros en la base de datos; para esto crearemos una forma en la cual el usuario puede introducir el nombre, teléfono o correo del cliente que está buscando. Los resultados de esta consulta los escribiremos en un archivo HTML y lo mostraremos dentro del componente HTML (aprovechando el post que publiqué hace ya tiempo sobre cómo crear un archivo en AIR).

Parte 4: Consulta a la base de datos en SQLite con AIR

Recuerda que para mantener organizado el código de nuestro proyecto y para evitar que se pierdan con toda la información aquí mostrada, dividí el código del proyecto en archivos .as. Estos archivos estarán almacenados en la carpeta actionscript. La estructura de nuestro proyecto será la siguiente:

Imagen 1: Estructura de la aplicación

Todas las interfaces de este proyecto están incluidas en la carpeta componentes. La interfaz que en esta ocasión veremos es la del archivo ConsultaClientes.mxml. Esta interfaz funciona de la siguiente manera:

Imagen 2: Interfaz del usuario

Al seleccionar la opción "Consultar…" del menú, se mostrará una forma con tres campos de texto, en donde el usuario podrá introducir el nombre, teléfono y correo del cliente que está buscando. Además, en la forma tendremos el botón de Mostrarel cual ejecutará la búsqueda. Los resultados serán mostrados dentro del rectángulo que ves en la parte de abajo de la imagen anterior.

Una vez que el usuario ejecute al búsqueda, si no se encontraron registros que coincidan con los datos buscados, el sistema mostrará dentro del archivo HTML la leyenda "No se encontraron resultados". En caso contrario, el sistema mostrará los resultados de forma similar a la mostrada a continuación:

Imagen 2: Interfaz del usuario

Dicho lo anterior, comenzaremos mostrando la estructura y el código del archivo ConsultaClientes.mxml:

• El ID del TextInput Nombre es nombre_txt
• El ID del TextInput Correo es correo_txt
• El ID del TextInput Teléfono es teléfono_txt
• El ID del componente HTML es HTMLLoader

El código de este archivo es el siguiente:

Observa en el código anterior que el tag principal de este archivo es <mx:Canvas> y no <mx:WindowedApplication>, esto es porque todas las interfaces que están dentro del directorio componentes las desplegaremos dentro de la aplicación principal (Sistema_Clientes.mxml); a la propiedad show del Canvas le estamos especificando que llame a la función abreConexion() una vez que se haya terminado de mostrar el componente. También observa cómo estamos incluyendo el código de ConsultarCliente.as:

Dentro del código del botón Mostrar hacemos la llamada a la función generaConsulta una vez que el usuario haya hecho click en dicho botón. El código de esta función (generaConsulta) y de la función principal (abreConexion) se encuentra dentro del archivo ConsultarCliente.as:

Después de haber importado las librerías necesarias y de haber declarado nuestras variables, escribimos el código de la función abreConexion. Esta función la hemos estado utilizando en las entradas anteriores, por lo que su código no debería causarte ruido.

Antes de ver el código de la función generaConsulta, mostraré el código de la clase HTMLTags:

Como pudiste observar en el código anterior, esta clase lo único que hace es regresarnos los tags del documento HTML que vamos a generar. Por ejemplo, la función getFirstTags nos regresa los primeros elementos que debe llevar el archivo HTML (los tags <html>, <head>, <meta> y los estilos que usaremos <style>). La función getTitleTags la mandaremos a llamar cada vez que recorramos un nuevo registro, le pasaremos como parámetro un texto de tipo "Cliente N" donde N es el valor de un contador que pondremos en el código (Cliente #1, Cliente #2, etc.) y nos regresará un texto con los tags y estilo que debe llevar. A la función getTable1Tags le estamos pasando como parámetro el nombre y la dirección del cliente, y ésta a su vez nos está regresando la información en forma de tabla con el código en HTML. Lo mismo sucede con la función getTable2Tags. La función getRulerTag nos regresa el tag <hr> para mostrar una línea horizontal. Por último, la función getEndTags nos regresa un texto con los tags que nos faltaban por cerrar (</body> y </html>).

Ahora veremos el código de generaConsulta. Presta atención en los comentarios que se encuentran dentro del código:

Observa que al final estamos especificando al control HTML (cuyo ID es HTMLLoader) el archivo HTML que debe mostrar (ConsultaCliente.html dentro de la carpeta HTML).

Hemos llegado al final de esta cuarta parte y de todas las entregas, no olvides bajar los archivos que se encuentran más abajo.

Parte 3: Modificar y eliminar registros en SQLite con AIR

Recuerda que para mantener organizado el código de nuestro proyecto y para evitar que se pierdan con toda la información aquí mostrada, dividí el código del proyecto en archivos .as. Estos archivos estarán almacenados en la carpeta actionscript. La estructura de nuestro proyecto será la siguiente:

Imagen 1: Estructura de la aplicación

Todas las interfaces de este proyecto están incluidas en la carpeta componentes. La interfaz que en esta ocasión veremos es la del archivo EditarBorrarCliente.mxml. Esta interfaz funciona de la siguiente manera:

Imagen 2: Interfaz del usuario

Al seleccionar la opción "Editar/Eliminar…" del menú, se mostrará un DataGrid con todos los registros que tenemos dados de alta en nuestra base. En este ejemplo solamente tengo dos registros. Si el usuario hace click al botón de Modificar del primer registro, se mostrará lo siguiente:

Imagen 3: Opción Modificar Cliente

…Un Canvas con los datos de nuestro registro. Si el usuario lo desea, podrá modificar o actualizar los datos de este registro. Por el contrario, si el usuario le da click al botón de Eliminar del primer registro, se mostrará un mensaje de alerta pidiéndole que confirme si desea o no borrar el registro.

Imagen 4: Mensaje de confirmación

Explicado lo anterior, comenzaremos mostrando la estructura y el código del archivo EditarBorrarCliente.mxml:

• El ID del DataGrid donde mostraremos los registros es clientes_dg
• El ID de nuestro Canvas en donde mostraremos la información del registro que el usuario puede modificar es Modificar_Cliente
  • El botón de Cambiar que se encuentra dentro del Canvas tiene de ID guardarBtn
  • El botón con una X tiene de ID cerrarBtn
  • Los IDs de cada una de las áreas de texto son:
    • nombre_txt, direccion_txt (TextArea), telefono_txt, correo_txt
    • Además, tenemos tres etiquetas cuyo texto es (*) y con los cuales le indicaremos al usuario qué dato le faltó por llenar. Estas etiquetas tienen de ID: msj1, msj2, msj3 y msj4.

El código de este archivo es el siguiente:

Observa en el código anterior que el tag principal de este archivo es <mx:Canvas> y no <mx:WindowedApplication>, esto es porque todas las interfaces que están dentro del directorio componentes las desplegaremos dentro de la aplicación principal (Sistema_Clientes.mxml); a la propiedad show del Canvas le estamos especificando que llame a la función abreConexion() una vez que se haya terminado de mostrar el componente. También observa cómo estamos incluyendo el código de EditarBorrarCliente.as:

También presta atención en la forma en que estamos creando los renderers para las columnas.

Dentro de los tags <mx:itemRenderer> y </mx:itemRenderer> estamos usando como layout el HBox (HorizontalBox), aunque en realidad no afecta mucho ya que sólo estamos poniendo un componente por cada celda (en caso de que pongamos más elementos en esa celda, estos elementos se mostrarán uno tras otro de izquierda a derecha). El componente que estamos insertando en cada celda es un botón; este botón en el momento de hacer click sobre él llamará a la función editarCliente, el cual recibe como parámetros el ID, nombre, dirección, teléfono y correo del cliente en cuyo registro hicimos click. La palabra reservada outerDocument nos permite acceder a elementos que se encuentran fueran del alcance del item renderer. Además, al botón le estamos asignando el icono edit.png () que está dentro de nuestra carpeta images. Importante: Observa cómo a esta columna del DataGrid le estamos especificando que no se pueda ordenar (sortable = false). Esto es porque en realidad no le estamos asignando valor alguno a cada celda, por lo tanto si intentáramos ordenar los registros de acuerdo a esta columna, Flex nos desplegaría un error.

El código para la columna que llevará los botones de Eliminar es el siguiente:

El código es similar al mostrado más arriba, lo único que cambia es que en esta ocasión el botón mandará a llamar a la función borrarCliente, pasándole como parámetro el ID del cliente. Además, el icono para este botón es remove.png ().

Antes de ver el código de las funciones editarCliente y borrarCliente, veremos cómo mostrar los registros de nuestra base de datos en el DataGrid. Para eso, el código que pegaré a continuación forma parte del archivo EditarBorrarCliente.as.

Primero, importamos las clases y declaramos las variables que necesitamos. En el arreglo data_provider almacenaremos los datos obtenidos de nuestra consulta y lo asignaremos como dataProvider de nuestro DataGrid (clientes_dg). La variable id_selected nos servirá para almacenar el ID del registro seleccionado y posteriormente eliminarlo de la base de datos.

La primera función que es llamada en esta sección es abrirConexion:

Dentro de abreConexion llamamos a la función reseteaForma, la cual se encarga de borrar los datos de la forma para la modificación de los datos.

Después de llamar a la función reseteaForma, ocultamos el canvas Modificar_Cliente y llamamos a la función reiniciaVariables, la cual se encargará de resetear los arreglos para eliminar su contenido previo.

Posteriormente le asignamos al datagrid clientes_dg el listener del evento CHANGE. Este evento es lanzado cuando el usuario hace click en alguno de los registros del DataGrid. Cuando se genere este evento, el programa se encargará de esconder el cambas Modificar_Cliente (es posible que previamente el usuario le haya dado click al botón de Editar en alguno de los registros, es por eso que nos aseguramos de esconder el Canvas). Además, almacenamos en la vaiable id_selected el ID del registro seleccionado; y, por último, escondemos los posibles mensajes que se le mostraron al usuario para que, cuando vuelva a darle click al botón Editar, no se le muestren.

El resto del código de la función abreConexion ya lo conoces de las entradas anteriores.
Si no hubo ningún problema en la conexión a la base de datos, llamamos a la función getClientes para llenar el DataGrid con nuestros registros:

Dentro del código de getClientes haremos la consulta a la tabla cliente para obtener todos los registros de nuestra base. Nuestro query es muy sencillo, en él estamos seleccionando (SELECT) todas las columnas (*) de la tabla cliente y le estamos diciendo que lo ordene (ORDER BY) de forma ascendente (asc) de acuerdo a la columna nombre.

Una vez que ejecutamos la consulta (queryStatement.execute()) obtenemos el resultado con la función getResult. Comprobamos que el resultado no sea vacío (result.data!= null) y obtenemos el total de registros obtenidos por medio de la propiedad length. Como ya sabemos cuántos registros nos regresó la consulta, haremos un ciclo for para almacenar los registros en nuestro arreglo data_provider. Finalmente estamos asignando el arreglo data_provider a la propiedad dataProvider del DataGrid. Importante: Si no comprendes esta parte donde llenamos el arreglo y se lo asignamos al DataGrid te recomiendo visitar la entrada sobre el Componente DataGrid que publiqué anteriormente.

Hemos terminado la explicación de cómo realizar la consulta a la base de datos y mostrar los resultados en el DataGrid. Ahora veremos las funciones que habíamos dejado pendientes: editarCliente y borrarCliente.
Como lo mencioné anteriormente, cuando el usuario hace click en el botón de Editar de alguno de los registros, la función editarCliente es llamada:

Esta función recibe como parámetros el ID del cliente, su nombre, dirección, teléfono y correo, para posteriormente mostrarlo en el formulario del canvas Modificar_Cliente. Si el usuario hace click en el botón de Cambiar, la función es validaForma es ejecutada:

Esta función es similar a la que usamos en la entrada anterior, simplemente estamos verificando que todos los datos fueron llenados y, en caso positivo, llamamos a la función updateCliente.

Esta función recibe como parámetro el ID del registro seleccionado, crea el query para actualizar los datos del registro y los nuevos valores son pasados como parámetros a la sentencia SQL. Una vez que se ejecuta la sentencia llamamos nuevamente a la función abreConexion para que muestre todos los registros (incluyendo los nuevos) en el DataGrid.

La función borrarCliente es llamada cuando el usuario hace click en el botón de Eliminar:

Esta función recibe como parámetro el ID del registro seleccionado por el usuario. Además, muestra un mensaje de alerta pidiéndole al usuario que confirme si desea eliminar el registro. Observa que al método show le pasamos como parámetro el manejador de eventos que debe considerar (alertClickHandler). Este manejador de eventos revisa si la respuesta del usuario fue positiva o negativa. En caso de que el usuario haya hecho click en el botón de Sí, llamamos a la función delCliente pasándole como parámetro el ID del registro seleccionado.

La función delCliente se encarga de ejecutar el query para borrar el registro de la base de datos. A este query le estamos pasando el ID del registro que hay que eliminar. Después de ejecutar la sentencia llamamos nuevamente a la función abreConexion para mostrar todos los registros restantes de la base de datos en el DataGrid.

Hemos llegado al final de esta tercera parte; ya nada más nos queda pendiente la cuarta y última entrega.

Como lo comenté en el post anterior , aquí mostraré solamente la información más importante y sobre la cual trata el tema, sin embargo el archivo fuente del proyecto está completo y tiene integrado todo lo que se mostrará en esta entrada, la anterior y en las siguientes, para así formar un proyecto completo. Dicho lo anterior, a continuación iniciaré la explicación sobre cómo insertar registros en una base SQLite.

Parte 2: Insertar registros en SQLite con AIR

Recuerda que para mantener organizado el código de nuestro proyecto y para evitar que se pierdan con toda la información aquí mostrada, dividí el código del proyecto en archivos .as. Estos archivos estarán almacenados en la carpeta actionscript. La estructura de nuestro proyecto será la siguiente:

Imagen 1

Todas las interfaces de este proyecto están incluidas en la carpeta componentes. La interfaz para dar de alta un nuevo cliente está en el archivo AltaCliente.mxml. Esta interfaz será la siguiente:

Imagen 2

Los IDs de cada uno de estos elementos son:

• nombre_txt
• dirección_txt
• telefono_txt
• correo_txt

El código del archivo AltaCliente.mxml es el siguiente:

Observa en el código anterior que el tag principal de este archivo es <mx:Canvas> y no <mx:WindowedApplication>, esto es porque todas las interfaces que están dentro del directorio componentes las desplegaremos dentro de la aplicación principal (Sistema_Clientes.mxml); a la propiedad show del Canvas le estamos especificando que llame a la función abreConexion() una vez que se haya terminado de mostrar el componente. También observa cómo estamos incluyendo el código de AltaCliente.as:

Otro punto importante a destacar del código anterior es el botón que tiene de etiqueta “Aceptar”, cuando se produce un click en este botón llamaremos a la función validaForma() para asegurarnos que todos los datos requeridos sean llenados.

A continuación está la explicación del código del archivo AltaCliente.as:

Del código anterior, las seis primeras líneas no cambian en nada con respecto al código mostrado en el primer post. Cuando se llame la función abreConexion posicionaremos el cursor dentro del campo de texto nombre_txt, establecemos cuál es el archivo de la base de datos e intentamos abrirla; si existiera algún error es llamada la función dbErrorConexion; en caso contrario, es llamada la función dbErrorConexion.

En esta ocasión, la función abreConexion será llamada desde la intefaz que mostré más arriba (desde el archivo AltaCliente.mxml).

Como lo señalé más arriba, una vez que el usuario introduzca los datos y haga click en el botón de Aceptar, la función validaForma() será llamada, el código de esta función te lo presento a continuación:

Dentro del código de AltaCliente.mxml están unas etiquetas con IDs msj1, msj2, msj3, etc. y cuyo texto es (*); estas etiquetas nos permitirán mostrarle al usuario qué información le faltó por llenar. Como su nombre lo indica, la función escondeMensajes se encarga de "esconder" (visible = false) éstos mensajes y así mostrar solamente los que son necesarios.

En este ejemplo, tenemos cuatro sentencias if encargadas de verificar que la información en los campos de texto nombre_txt, dirección_txt, telefono_txt y correo_txt sean distintos de vacío. Además, nos aseguramos que el formato del correo electrónico sea correcto creando la función mail.

Finalmente, si ninguna de las cuatro condicionales if se cumple (es decir, toda la información requerida fue introducida) llamamos a la función compruebaCliente y verificar si el correo electrónico proporcionado ya existe en la base de datos.

A continuación, te muestro el código de las funciones escondeMensajes, mail y compruebaCliente:

Observa que dentro de la función compruebaCliente estamos declarando la variable correo y asignándole el valor del cuadro de texto correo_txt. Esta variable la pasaremos como parámetro a la consulta para verificar que esa cuenta de correo electrónico no exista en la base de datos. Con la función clearParameters de nuestro objeto SQLStatement estamos eliminando los posibles parámetros que hayamos asignado con anterioridad, de no hacer esto el programa generará un error indicándonos que la cantidad de parámetros establecidos en el query no concuerda con los parámetros del SQLStatement. A esta variable le indicamos a su propiedad text el query o la consulta que debe realizar. Además, le especificamos (dentro del query) que llevará el parámetro :correo y le asignamos a ese parámetro el valor de la variable correo.
Por último, realizamos la ejecución de la consulta y verificamos si el resultado obtenido es distinto de vacío (nulo – null). Si el resultado es distinto de vacío quiere decir que sí existe un registro con esa cuenta de correo y por lo tanto mostramos un mensaje de alerta informándole al usuario; en caso contrario, llamamos a la función insertaCliente():

Creamos la variable sql y le asignamos un string con nuestra consulta y los parámetros que recibirá (recuerda que los parámetros son especificados con dos puntos - : -). Llamamos a la función clearParameters y posteriormente le asignamos al SQLStatement los valores de los cuatro parámetros (estos valores son obtenidos de nuestros campos de texto). Ejecutamos la sentencia, le mostramos un mensaje al usuario informándole que sus datos han sido almacenados y por último llamamos a la función restableceForma para borrar la información de los campos de texto.

Hemos llegado al final de esta segunda parte. Si te perdiste la primera parte de este tutorial, te recuerdo que… como recomendación y para que te asegures de que tu base de datos, la tabla y el registro fueron creados, puedes bajar el complemento para Firefox llamado SQLite Manager, el cual es un pequeño y simple administrador de bases SQLite.

Parte 1: Crear Base de Datos en SQLite con AIR

Para mantener organizado el código de nuestro proyecto y para evitar que se pierdan con toda la información aquí mostrada, vamos a dividir el código del proyecto en archivos .as. Estos archivos estarán almacenados en la carpeta actionscript. La estructura de nuestro proyecto será la siguiente:

Imagen 1

Comenzamos con el archivo CrearBaseDatos.as:

Necesitamos de las siguientes librerías para poder tener acceso a los métodos de conexión con la base de datos, la ejecución de los queries, etc. Las clases que usaremos son SQLConnection, SQLErrorEvent y SQL Event:

Ahora vamos a crear los objetos de estas clases y las variables que requeriremos a lo largo de este archivo:

Para crear las sentencias de SQL, necesitamos de un objeto de la clase SQLStatement, a este objeto lo llamamos queryStatement.

La función abreConexion (que mostraremos a continuación) será llamada desde la aplicación principal, es decir desde el archivo Sistema_Clientes.mxml (recuerda que al crear un nuevo proyecto, Flex Builder construye automáticamente un archivo MXML con el nombre del proyecto y el cual es el punto de partida de nuestra aplicación). Esta función se encargará de verificar si existe la base de datos la cual la pasamos como parámetro del constructor de la clase File. Si no existiera la base de datos la aplicación se encargará de crearla. En caso contrario, se establecería la conexión con la base de datos. El nombre de nuestra base de datos será clientesDB.sqlite, presta atención a la primera línea de nuestra función:

Observa que al constructor de la clase File le estamos pasando como parámetro el URL de donde estará almacenada nuestra base de datos. Para construir este URL estamos usando la propiedad applicationStorageDirectory, la cual hace referencia al directorio privado donde se encuentra la aplicación. Además, estamos usando la propiedad nativePath la cual nos regresa la ruta completa de acuerdo al sistema operativo donde se encuentra el sistema. A grandes rasgos, esta línea crea un directorio con el nombre de la aplicación (en este caso el directorio se llama Sistema_Clientes) dentro de la carpeta de Application Data (Datos de programa). Esta carpeta es donde los programas que tenemos instalados guardan información o las preferencias del usuario de la computadora. En Windows Vista, el directorio donde está almacenada la base de datos es C:\Users\Nombre_Usuario\AppData\Roaming\Sistema_Clientes. En Windows XP, el directorio es: C:\Documents and Settings\Nombre_Usuario\Datos de programa\Sistema_Clientes.

Al hacer la llamada a la función open, la función dbAbrirConexion será llamada en caso de que no exista error; en caso contrario la función dbErrorConexion será llamada. El código de estas funciones se muestra a continuación:

Nuestra base de datos estará conformada por solamente una tabla (sólo para fines del ejercicio, ya que no es común que una base de datos esté formada por sólo una tabla). Nuestra tabla se llama cliente y sus elementos son los siguientes:

Imagen 2

De la imagen anterior podemos determinar que el query para crear esta tabla es:

Este query lo usaremos en la función createTBLCliente, el cual es llamado desde dbAbrirConexion.

Para crear las sentencias de SQL, necesitamos de un objeto de la clase SQLStatement, a este objeto lo llamamos queryStatement y lo declaramos al inicio del programa. Para asegurarnos de que no tengamos parámetros asignados a este SQLStatement, usamos la función clearParameters, de no hacer esto el programa generará un error indicándonos que la cantidad de parámetros establecidos en el query no concuerda con los parámetros del SQLStatement. Posteriormente declaramos una variable sql de tipo String que contiene el query de crear la tabla de cliente.
La propiedad text de la clase SQLStatement nos permite asignarle la sentencia SQL, por lo que le asignamos la variable sql.

Para poder "cachar" cualquier error que ocurra al ejecutar la sentencia, colocamos la llamada a la función execute dentro del bloque try. Cualquier error que ocurra será detectado y administrador en el bloque catch. En caso de que no exista ningún error al llamar a la función execute, llamaremos a la función insertDefaultData para insertar algunos registros por default.

A continuación pego el código de la función insertDefaultData:

Este código es similar al de la función createTBLCliente en cuanto a la creación de la variable del SQLStatement, la creación del query y su asignación a la propiedad text. Sin embargo, presta atención en la forma en cómo se le pasan los valores al query; esto es usando dos puntos seguidos de un nombre cualquiera que quieras asignarle. Posteriormente debes establecer el valor de estos parámetros usando la propiedad parameters la cual recibe un arreglo asociativo con los valores del parámetro especificado.

Como recomendación y para que te asegures de que tu base de datos, la tabla y el registro fueron creados, puedes bajar el complemento para Firefox llamado SQLite Manager, el cual es un pequeño y simple administrador de bases SQLite.