Uso de SQLite2 en Gambas2 Creación de un programa paso a paso

Transcripción

1 Uso de SQLite2 en Gambas2 Creación de un programa paso a paso Autor: Daniel Calleja Amaro Con el aporte de Razaaztk Pasado a texto: Julio Sanchez Berro Índice Un nuevo proyecto...3 Tabla y datos...5 El formulario principal...7 El sql...8 Comenzemos a codificar...8 Continuando con los datos...11 Agregar, editar, borrar...13 La rutina de búsqueda...16 Archivo fuente y unos pequeños cambios...19 Anexo 1: Enlaces para aprender SQL...19 Anexo 2: Agradecimientos...19 Página 1 De 19

2 Un nuevo proyecto Vamos a comenzar un nuevo proyecto, esta vez de bases de datos Empezaremos con algo sencillo, una miniagenda teléfonica para anotar los teléfonos de nuestros amigos. Usaremos una base de datos local (o sea en nuestro Pc), ya que se trata de una base de pequeño tamaño y el formato de datos será sqlite2. La idea es almacenar en ella nombre, apellido, teléfonos fijo y móvil, además de la fecha del cumpleaños. Luego crearemos las funciones para agregar y borrar datos, buscar y ordenar. El código fuente estará disponible recién al finalizar, ya que voy subiendo el proyecto a medida que lo realizamos. Primero que nada, abrimos Gambas y creamos un nuevo proyecto. al que le pondremos el nombre que queramos. Luego vamos a las propiedades del proyecto y marcamos los componentes gb.db, gb.db.sqlite2 y gb.db.form. Luego abrimos el gestor de bases de datos, nos abrirá un formulario donde poner la contraseña, elegimos una sencilla y presionamos continuar. ATENCIÓN! El formulario aparece minimizado en la barra de tareas, debes clickear en él para que se abra. A continuación nos aparece esta ventana donde con el botón derecho sobre servidor,elegimos nuevo. Página 2 De 19

3 En la siguiente elegimos de la lista desplegable sqlite2 y en la posteriornos pide elegir una ruta, presionando el botón elegir navegamos a la carpeta donde guardamos nuestro proyecto y damos ok. Hasta aquí tenemos creada la conexión, ahora botón derecho sobre el servidor creado y elegimos crear base, nos va a pedir un nombre, es este caso, mibase1. Página 3 De 19

4 Tenemos entonces el servidor de bases de datos y una base. En el próximo post vamos a crear una primera tabla y agregarle algunos datos. Tabla y datos Pinchamos sobre la base recién creada con el botón derecho del ratón y en el menú contextual elegimos crear tabla. Nuevamente nos va a pedir un nombre, la llamaremos mitabla. Damos ok y listo. Ahora nos aparece una nueva ventana a la derecha de la anterior. Página 4 De 19

5 Como vemos tiene tres pestañas: Campos, índices y datos. En campos vamos a crear los que necesitemos para nuestra base. Vemos que ya aparece uno; id y cuyo tipo es integer. Esta va a ser la clave principal de nuestra base de datos y va a ser un número que no debe repetirse. Para ir agregando campos simplemente pinchamos en el ícono de la hoja en blanco que vemos antes de la papelera y agregamos uno a uno los nombres de los campos junto con su tipo. Este es el aspecto de la tabla luego de hacerlo. Los nombres de campo no llevan tildes ni espacios y tampoco aceptan la letra Ñ. Tres son del tipo string (cadena) y tres integer(entero). Click en el icono guardar para que no se pierdan los cambios. Pinchemos ahora en la pestaña datos y agreguemos algunos para tener algo que mostrar al inicializar la aplicación. Aquí el guardar es el que está enseguida de la pestaña, no debemos olvidarnos de hacerlo. Vea la siguiente imagen. Página 5 De 19

6 Ahora ya tenemos creada nuestra base de datos y una tabla para guardar los datos, en el próximo apartado crearemos la interfase para interactuar con ésta. El formulario principal Podemos minimizar ahora el gestor de base de datos y dirigirnos a fmain donde colocaremos- por el sistema ya conocido de arrastrar y dibujar sobre el mismo-un columview y dos botones a los que colocaremos el texto nuevo y salir respectivamente.(propiedad text).podemos, si así lo deseamos agregar un ícono a cada botón mediante su propiedad picture. Al columview lo llamaremos sencillamente tabla (Propiedad name) pues se asemeja mucho a cualquier tabla y estamos tratando de mantener este primer proyecto de base de datos lo más sencillo posible. Los botones ; btnnuevo y btnsalir. Al botón salir le asignamos el código para cerrar el formulario, PUBLIC SUB Btnsalir_Click() ME.Close Al ser éste el formulario principal también nos cierra la aplicación. Si presionamos f5 esto es lo que vemos. Página 6 De 19

7 Nada alentador, verdad? Pronto aprenderemos a llenarlo con los datos y definir sus propiedades, pero primero debemos dar una vuelta para conocer el lenguaje que nos permite trabajar con los datos, realizar búsquedas y otras funciones. Es el mismo lenguaje que utilizan las bases de datos más populares y cúanto más sepamos de él mejor podremos aprovechar su versatilidad y potencia.. Estamos hablando del Lenguaje Estandarizado de Consultas o SQL por sus siglas en inglés (Standar Query Languaje), del cual daremos apenas una breve reseña. El sql Traté de hacer un resumen de SQL, pero como tengo poco tiempo por estos días os dejo un enlace a la wikipedia que os recomiendo leer. Está muy bueno. SQL en wikipedia Comenzemos a codificar Vamos a comenzar a poner algo de código a nuestro programa, y lo iremos comentando. Lo primero en una base de datos es la conexión a la misma. Gambas nos provee para esto del objeto Connection. Veamos el código. Página 7 De 19

8 PRIVATE hconn AS Connection PRIVATE FUNCTION ConectarBase() AS Boolean IF hconn <> NULL THEN RETURN FALSE hconn = NEW Connection hconn.host = /home/daniel/bases hconn.name = mibase1 hconn.type = sqlite2 TRY hconn.open() IF ERROR THEN hconn = NULL Message.Error( error al conectar con la base ) RETURN TRUE IF RETURN FALSE Como siempre, declaramos primero las variables hconn y conectarbase. Aquí vemos que la segunda es una variable de tipo boolean, cuyos únicos valores son true(verdadero) o false(falso). Primero vemos que la conexión no esté abierta, luego la inicializamos con el método new y ponemos los paramétros host, que nos indica la ruta a nuestra base de datos, el name(nombre) de la base, en este caso mibase1 y el type(tipo), sqlite2(o puede ser mysql, postgresql, etc). Tratamos de abrir la conexión con hconn.open,si no lo conseguimos enviamos un mensaje de error y le damos el valor null a la conexión. Uno de los errores más comunes se da al indicar el path o ruta a la base de datos, ya que a veces podemos moverla por error, es importante prestar atención a escribirla correctamente. Veamos como cerrar la conexión. PUBLIC SUB cerrarconexion() IF hconn = NULL THEN RETURN hconn.close() hconn = NULL Primero vemos que ya no este cerrada, si no es así la cerramos con.close. Y ahora vamos a visualizar los datos en el columview,en el evento open de fmain. PUBLIC SUB Form_Open() DIM hresul AS Result DIM Clave AS String DIM filtro AS String tabla.clear IF ConectarBase() THEN RETURN Página 8 De 19

9 tabla.columns.count = 6 tabla.columns[0].text = id tabla.columns[0].width = 20 tabla.columns[0].alignment =Align.Center tabla.columns[1].text = Nombre tabla.columns[1].alignment = Align.Center tabla.columns[1].width = 120 tabla.columns[2].text = Apellido tabla.columns[2].alignment = Align.Center tabla.columns[2].width = 120 tabla.columns[3].text = telefono tabla.columns[3].alignment = Align.Center tabla.columns[3].width = 120 tabla.columns[4].text = movil tabla.columns[4].width = 120 tabla.columns[4].alignment = Align.Center tabla.columns[5].text = cumple tabla.columns[5].width = 120 tabla.columns[5].alignment = Align.Center hresul = hconn.exec( Select * from mitabla ) DO WHILE hresul.available Clave = hresul["id"] tabla.add(clave, Clave) tabla[clave][1] = hresul["nombre"] tabla[clave][2] = hresul["apellido"] tabla[clave][3] = hresul["telefono_fijo"] tabla[clave][4] = hresul["telefono_movil"] tabla[clave][5] = hresul["cumple"] hresul.movenext() LOOP cerrarconexion() Primero declaramos las variables y limpiamos el columview(tabla). Luego definimos las propiedades del mismo. El.count nos dice la cantidad de columnas,.text el título de la columna,.width el ancho de la columna en píxeles, y.alignment nos define como se alinearán los datos dentro de la columna. hresul = hconn.exec( Select * from mitabla ) Página 9 De 19

10 Con esta sentencia elegimos los datos a mostrar mediante la instrucción sql select* from, como queremos mostrar todos los datos no ponemos ninguna condición o filtro. Más adelante veremos como hacerlo. El resto del código va colocando los datos en su lugar correspondiente del columview. En el próximo apartado lo explico con más detalle. Veamos nuestra tabla ahora Continuando con los datos 1/2 Bien, habíamos quedado en explicar como se rellenan los datos. hresul = hconn.exec( Select * from mitabla ) Esta instrucción busca en la base de datos, si encuentra datos hace que que la variable hresul sea verdadera y por tanto esté disponible (Available) y mientras esto sea así recorrerá la tabla con un bucle do while, basándose en la clave(id) e irá rellenando la tabla con los datos. La pocisión de los mismos está dada por el número entre paréntesis. Es de hacer notar que los números entre paréntesis rectos mencionan la posición de los datos en la tabla, o sea a que columna pertenecen y entre paréntesis rectos junto a hresul está el campo equivalente en la base de datos. hresul.movenext() Página 10 De 19

11 LOOP La primera instrucción hace avanzar la búsqueda al siguiente dato, el LOOP vuelve a ejecutar las instrucciones dentro del bucle hasta que no haya más datos para mostrar. Luego cierra la conexión. Vamos a crear ahora un nuevo formulario para agregar y/o editar los datos de la tabla,algo fundamental para interactuar con la misma. En el árbol de la izquierda, botón derecho, nuevo formulario y le ponemos como nombre fdata y le agregamos 6 lael, 6 textbox y dos botones.este es el aspecto del mismo. Llamaremos a los textbox txtid, txtnombre, txtapellido, txttelefono, txtmovil y txtcumple y a los botones btnaceptar y btncancelar. Como siempre podemos agregar una imagen a los botones mediante su propiedad picture. Este formulario recibirá una referencia a un objeto del tipo conection, en nuestro caso hconn por tanto al principio de nuestro formulario fdata colocaremos el siguiente código: PRIVATE hconn as connection Página 11 De 19

12 Usará además el método runnew qué será llamado desde el formulario principal. la sintaxis es la siguiente: PUBLIC SUB runnew(data as connection) hconn=data ME.showmodal() El Me.showmodal nos obliga a interactuar con el formulario antes de cerrarlo, esto se entenderá mejor cuando veamos como llamamos a este formulario desde el principal. Agregar, editar, borrar Por su parte el botón de cancelación simplemente cierra el formulario, sin actuar sobre los datos. PUBLIC SUB btncancelar_click() Me.close End Insertamos los datos mediante el siguiente código en el evento click de btnaceptar: TRY hconn.exec ( insert into mitabla values (&1,&2,&3,&4,&5.&6), txtid,txtnombre,txtapellido,txttelefono,txtmovil,txtcumple) ME.close CATCH message.error( Imposible introducir los datos solicitados ) Le pedimos al objeto connection que inserte los datos en la tabla,mediante la instrucción insert intro nombre_de_la_tabla values,el &1 indica que toma el primer valor a continuación que es txid.text, el &2 el siguiente(txtnombre.text) y así sucesivamente. Si todo va bien el formulario se cierra, si hay un error se captura con catch y nos muestra el mensaje de error. Volvamos ahora al formulario principal y en el evento click de btnnuevo colocamos el siguiente código; PUBLIC SUB Btnnuevo_Click() IF ConectarBase() THEN RETURN fdata.runnew(hconn) cerrarconexion() Página 12 De 19

13 Form_Open() Programando en Gambas2: Programa Agenda Paso a Paso, usando SQL3 Primeros tratamos de conectarnos a nuestra base de datos, si no lo conseguimos nos salimos. Conseguida la conexión llamamos al método runnewde fdata. Como este formulario se muestra en forma modal, el presente código queda a la espera de que ingresemos datos en fdata o simolemente lo cerremos. A continuación cierra la conexión y llama al metodo form_open que se encarga de recargar los datos para mostrar los cambios realizados. Continuando con el formulario principal, vamos a codificar el método para borrar registros presionando la tecla suprimir. PUBLIC SUB tabla_keyrelease() IF Key.Code = Key.Delete THEN IF tabla.current = NULL THEN RETURN IF tabla.current.selected = FALSE THEN RETURN IF ConectarBase() THEN RETURN TRY hconn.exec( delete from mitabla where id=&1, tabla.current.key) IF ERROR THEN Message.Error( Imposible borrar el registro ) ELSE tabla.current.delete() IF IF Vemos primero si hay algún elemento en la tabla y si hay algo seleccionado, si no es así salimos del método. Si hay alguno seleccionado tratamos de abrir la conección y tras lograrlo, borramos de la base los datos del registro cuya clave coincida con la del registro seleccionado. Si hay un error sale el mensaje informativo, es caso contrario se borra el registro también en nuestro colunmview para reflejar el cambio en la base. Aquí vemos que la instrucción sql usada es condicional y la palabra marcada en negrita where antecede a la condición; TRY hconn.exec( delete from mitabla where id=&1, tabla.current.key) Ahora vamos a ver como hacemos para modificar un registro, por ejemplo si un amigo cambia el móvil, basta con editar ese campo. Vamos a aprovechar el evento activite de nuestro control colunmview(tabla) para agregar esta funcionalidad. Dicho evento se dispara al hacer doble click sobre alguna columna de la tabla. PUBLIC SUB tabla_activate() DIM hresul AS Result Página 13 De 19

14 IF tabla.current = NULL THEN RETURN IF ConectarBase() THEN RETURN hresul = hconn.edit( mitabla, id=&1, tabla.current.key) fdata.runedit(hresul) tabla.current[0] = hresul["id"] tabla.current[1] = hresul["nombre"] tabla.current[2] = hresul["apellido"] tabla.current[3] = hresul["telefono_fijo"] tabla.current[4] = hresul["telefono_movil"] tabla.current[5] = hresul["cumple"] cerrarconexion() La línea en negrita es la que llama al método runedit de fdata. Como aún no hemos creado este método si tratamos de ejecutarlo ahora no funcionará. Volvamos por tanto a fdata y coloquemos las siguientes variables al principio del formulario para que sean accesibles desde todo el formulario. PRIVATE hconn AS Connection PRIVATE hresul AS Result PRIVATE editando AS Boolean y agregamos el método runedit cuyo código es el siguiente: PUBLIC SUB runedit(data AS Result) hresul = data editando = TRUE txtid.text = hresul["id"] txtnombre.text = hresul["nombre"] txtapellido.text = hresul["apellido"] Txttelefono.text = hresul["telefono_fijo"] txtmovil.text = hresul["telefono_movil"] txtcumple.text = hresul["cumple"] ME.ShowModal Esto nos muestra fdata con los datos del registro seleccionado de modo que podamos editarlo.y nos pone la variable editando con el valor true. Esto es necesario para que mediante una instrucción condicional al hacer click en btnaceptar distinga entre altas y modificaciones. El nuevo código de btnaceptar es el siguiente. PUBLIC SUB btnaceptar_click() IF editando THEN Página 14 De 19

15 TRY hresul["id"] = txtid.text TRY hresul["nombre"] = txtnombre.text TRY hresul["apellido"] = txtapellido.text TRY hresul["telefono_fijo"] = Txttelefono.text TRY hresul["telefono_movil"] = txtmovil.text TRY hresul["cumple"] = txtcumple.text TRY hresul.update ELSE TRY hconn.exec( insert into mitabla values (&1,&2,&3,&4,&5,&6), txtid.text, txtnombre.text, txtapellido.text, Txttelefono.text, txtmovil.text, txtcumple.text) IF ME.Close() CATCH Message.Error( Imposible introducir los datos solicitados ) Si hay una modificación sitúa el valor de cada caja de texto con TRY y actualiza la base de datos con hresul.update, si hay un error lo captura con CATCH y muestra el mensaje de error. Si editando es false continúa con las intrucciones despúes de else que no es más que la instrucción insert into ya vista en agregar registros. La rutina de búsqueda Esta parte ha sido la que más trabajo me ha dado de realizar, no encontraba información clara y tuve que ir tanteando hasta lograrlo, pero valió la pena. Agregemos a fmain un botón btnbuscar y un textbox txtbuscar. Este es el nuevo aspecto de fmain. Página 15 De 19

16 La ubicación es a gusto de cada uno, lo que si el textbox de búsqueda debe estar al lado del botón buscar. A continuación el código: PUBLIC SUB btnbuscar_click() DIM hresul AS Result DIM Clave AS String DIM filtro AS String tabla.clear IF ConectarBase() THEN RETURN tabla.columns.count = 6 tabla.columns[0].text = id tabla.columns[0].width = 20 tabla.columns[0].alignment = Align.Center tabla.columns[1].text = Nombre tabla.columns[1].alignment = Align.Center tabla.columns[1].width = 120 tabla.columns[2].text = Apellido tabla.columns[2].alignment = Align.Center tabla.columns[2].width = 120 tabla.columns[3].text = telefono tabla.columns[3].alignment = Align.Center tabla.columns[3].width = 120 tabla.columns[4].text = movil tabla.columns[4].width = 120 tabla.columns[4].alignment = Align.Center tabla.columns[5].text = cumple tabla.columns[5].width = 120 tabla.columns[5].alignment = Align.Center filtro = Txtbuscar.Text hresul = hconn.exec( Select * from mitabla where nombre like & filtro & ) DO WHILE hresul.available Clave = hresul["id"] tabla.add(clave, Clave) tabla[clave][1] = hresul["nombre"] tabla[clave][2] = hresul["apellido"] tabla[clave][3] = hresul["telefono_fijo"] tabla[clave][4] = hresul["telefono_movil"] tabla[clave][5] = hresul["cumple"] hresul.movenext() Página 16 De 19

17 LOOP cerrarconexion() Es prácticamente el mismo código que carga el columview, en realidad es lo que hace, pero a diferencia del evento Form_open utiliza un filtro que condiciona la búsqueda de datos en la siguiente línea: filtro = Txtbuscar.Text hresul = hconn.exec( Select * from mitabla where nombre like & filtro & ) Asignamos a la variable filtro el valor de txt buscar y a su vez filtro lo ponemos como condición de la búsqueda. Nos muestra todos los campos que coincidan con el criterio utilizado. Pero; Qué pasa si no hay datos que coincidan? Vamos a incluir una sentencia if-then -else en nuestra rutina. filtro = Txtbuscar.Text hresul = hconn.exec( Select * from mitabla where nombre like & filtro & ) IF hresul.available = FALSE THEN Message.Info( No hay datos que coincidan con su búsqueda ) form_open ELSE DO WHILE hresul.available Clave = hresul["id"] tabla.add(clave, Clave) tabla[clave][1] = hresul["nombre"] tabla[clave][2] = hresul["apellido"] tabla[clave][3] = hresul["telefono_fijo"] tabla[clave][4] = hresul["telefono_movil"] tabla[clave][5] = hresul["cumple"] hresul.movenext() LOOP cerrarconexion() IF Lo que se agrega está en negrita. vemos si hresul.available es false, si es así mostramos el mensaje de error y con form_open recargamos los datos en el formulario.si en cambio es true, seguimos con la rutina anterior para mostrar los datos filtrados. Página 17 De 19

18 Archivo fuente y unos pequeños cambios. Gracias al aporte de un compañero del foro de gambas-es (AZTK) presento aquí el código fuente del visor mini agenda de contactos que hemos venido desarrollando. Uno de los cambios es en el host, donde usamos User.home (nuestra carpeta de usuario) y la carpeta visor que si no exista será creada y la base copiada allí. hconn.host = User.Home &/.visor El siguiente fragmento va en el evento open de fmain IF NOT Exist(User.Home &/.visor/mibase1 ) TRY MKDIR User.Home &/.visor COPY base/mibase1 TO User.Home &/.visor/mibase1 IF Primero comprueba si existe la base, si no es así crea el directorio en la carpeta de usuario y copia allí la base incluída en el código fuente. Código fuente Anexo 1: Enlaces para aprender SQL Anexo 2: Agradecimientos A mi familia por la paciencia y el tiempo robado A todos los compañeros del foro de Gambas-es, especialmente a los mencionados al comienzo A Campos y Redrejo por su excelente libro. Página 18 De 19

19 El presente documento se distribuye bajo licencia Creative Commons, usted es libre de copiarlo, modificarlo y distribuirlo siempre y cuando mencione el/los autores y respete sus derechos. Si crea obras derivadas de la misma deberá usar esta misma licencia. Si desea saber más sobre esta licencia visite" Página 19 De 19