Lección 1: Configurar la conexión de base de datos

Crear un proyecto EGL

En primer lugar, necesita un proyecto EGL nuevo para contener el código de acceso a datos.

Pase a la perspectiva EGL:
1. Pulse Ventana > Abrir perspectiva > Otras.
2. En la ventana Abrir perspectiva, pulse EGL. Si no visualiza EGL en la lista de perspectivas, marque el recuadro de selección Mostrar todo.
3. Pulse Aceptar.
Crear un proyecto EGL (no un proyecto Web EGL) denominado EGLSQL:
1. Pulse Archivo > Nuevo > Proyecto.
2. En la ventana Proyecto nuevo, expanda EGL y pulse Asistente Proyecto EGL.
3. Pulse Siguiente.
4. En el campo Nombre de proyecto, especifique EGLSQL.
5. Bajo Tipos de proyectos EGL, pulse Proyecto genérico. La ventana Proyecto EGL nuevo tiene el aspecto siguiente:
6. Pulse Siguiente.
7. En la segunda página, compruebe que Java esté seleccionado bajo Plataforma de entorno de ejecución destino y que Crear un descriptor de construcción esté seleccionado bajo Opciones de descriptor de construcción. Seleccione Mostrar valores avanzados. La ventana Proyecto EGL nuevo tiene el aspecto siguiente:
8. Pulse Siguiente.
9. Quite la marca del recuadro de selección correspondiente a Crear un descriptor de despliegue de servicio EGL y pulse Finalizar.
El proyecto nuevo se creará y aparecerá en la vista Explorador de proyectos.

Importar y conectar a la base de datos

Por qué y cuándo se efectúa esta tarea

En esta guía de aprendizaje se utiliza la base de datos de ejemplo Derby del la guía de aprendizaje Introducción a EGL. En estos pasos, extraerá otra copia de este base de datos en una ubicación del sistema. También utilizará el asistente Aplicación de acceso a datos para conectarse a la base de datos y crear componentes de datos y componentes lógicos en ella. Para obtener más información acerca de estos componentes, consulte la Introducción a EGL.

Pulse el enlace siguiente y descargue la base de datos de ejemplo a una carpeta temporal en su sistema, como por ejemplo el escritorio:
Base de datos de ejemplo

No importa dónde guarde la base de datos mientras pueda encontrarla después.
También puede encontrar esta base de datos de ejemplo en el directorio de instalación del producto en la ubicación siguiente:
```
recursos_compartidos/plugins/com.ibm.etools.egl.tutorial0001.doc_versión/resources/EGLDerbyDB.zip
```
recursos_compartidos

Directorio de recursos compartidos del producto, como C:\Program Files\IBM\SDP70Shared en un sistema Windows u /opt/IBM/SDP70Shared en un sistema Linux. Si ha instalado y conservado una versión anterior de un producto IBM que contenga EGL antes de instalar el producto actual, es posible que tenga que especificar el directorio de recursos compartidos configurado en la instalación anterior.

versión

Versión instalada del plugin, incluidos los tres números separados por puntos, un separador de series y la fecha y la hora de construcción del plugin; por ejemplo, 7.0.0.RFB_20070120_1300. Si hay más de una, utilice la que tenga el número de versión más reciente, a menos que le interese utilizar una versión más antigua.
Extraiga la base de datos en una ubicación del sistema, como por ejemplo C:\databases. No importa dónde coloca la base de datos mientras pueda encontrarla después.
Pulse Archivo > Nuevo > Otros. Se abrirá la ventana Nuevo.
Expanda EGL y pulse Aplicación de acceso a datos de EGL.
Pulse Siguiente.
En la página Definir valores del proyecto, seleccione EGLSQL en la lista Nombre de proyecto.
Expanda la lista Conexión de base de datos. Si anteriormente ha creado una conexión con la base de datos EGLDerbyDB en este espacio de trabajo (por ejemplo, en la guía de aprendizaje Introducción a EGL), debe visualizar ese nombre en la lista. Seleccione EGLDerbyDB y vaya al paso 10
Si no visualiza una conexión denominada EGLDerbyDB, pulse el botón Nuevo situado junto a la lista Conexión de base de datos.
En la ventana Conexión nueva, especifique la información siguiente:
1. Deje seleccionado Utilizar convenio de denominación predeterminado.
2. En Seleccionar un gestor de bases de datos, pulse Derby. EGL rellenará los demás campos con los valores predeterminados correspondientes a Derby.
3. En la pestaña General de Propiedades, pulse Examinar en el campo Ubicación de base de datos y seleccione la ubicación en la que ha extraído el archivo EGLDerbyDB.zip anteriormente. Por ejemplo, si ha extraído el archivo EGLDerbyDB.zip en C:\databases, el campo Ubicación de base de datos debe indicar C:\databases\EGLDerbyDB. No es necesario cambiar los campos ID de usuario ni Contraseña. EGL no debería necesitar más información para establecer la conexión. La ventana Conexión nueva tiene el aspecto siguiente, con la información y la ubicación de su propio espacio de trabajo en los campos Ubicación de base de datos y Ubicación de clase:
Pulse Probar conexión. Debe visualizar un recuadro de diálogo que indica que la conexión ha sido satisfactoria:
Pulse Finalizar. Ahora ha establecido una conexión con la base de datos. EGL visualizará la ventana Definir valores de proyecto. Todas las tablas de la base de datos se muestran bajo la lista Nombre de tabla en la parte superior del asistente. No creará componentes de datos para todas estas tablas, porque algunas solo contienen metadatos.
En el diálogo Definir valores de proyecto, bajo Seleccionar tablas, marque solo los recuadros de selección situados junto a las tablas siguientes:
- EGL.CUSTOMER
- EGL.ITEM
- EGL.ORDERITEM
- EGL.ORDERS
- EGL.SITEUSER
- EGL.STATETABLE
El asistente Aplicación de acceso a datos EGL tiene el aspecto siguiente:
Asegúrese de que el recuadro de selección Crear páginas web esté deseleccionado.
Asegúrese de que el proyecto EGLSQL aparece en el campo Nombre de proyecto.
Nota: ¡No pulse Finalizar todavía! Debe cambiar un valor más en este asistente.
Pulse Siguiente para pasar a la página Definir los campos. Esta página permite añadir campos de clave a las tablas de base de datos. No cambie ningún valor de esta página; la base de datos ya tiene un campo de clave en cada tabla.
Vuelva a pulsar Siguiente para pasar a la página Definir opciones de creación de proyecto.
En la página Definir opciones de creación de proyecto, marque el recuadro de selección Calificar nombres de tabla con esquema.
Pulse Finalizar. EGL crea diversos componentes de datos y componentes lógicos que puede utilizar para acceder a la base de datos. Utilizará ampliamente estos componentes en el resto de esta guía de aprendizaje.
Aún debe configurar el descriptor de construcción para utilizar esta conexión de base de datos en tiempo de ejecución.
Abra el descriptor de construcción predeterminado del proyecto, denominado EGLSQL/EGLSource/EGLSQL.eglbld. Efectúe una doble pulsación sobre este archivo para abrirlo en el editor de componentes de construcción de EGL.
En el editor de componentes de construcción de EGL, junto a Cargar opciones de BD utilizado conexión, seleccione el nombre de la conexión de base de datos que ha anotado en un paso anterior. Las opciones del descriptor de construcción se establecen en los valores necesarios para utilizar esa conexión:
Guarde y cierre el descriptor de construcción.
Añada el controlador Derby a la vía de acceso de construcción Java del proyecto:
1. Pulse el proyecto EGLSQL con el botón derecho y pulse Propiedades.
2. En la ventana Propiedades, pulse Vía de acceso de construcción Java.
3. En la página Vía de acceso de construcción Java, pulse la pestaña Biblioteca.
4. En la pestaña Bibliotecas, pulse Añadir JAR externos.
5. En la ventana Selección de JAR, localice el archivo Derby.jar y pulse Abrir. Busque el archivo Derby.jar en las ubicaciones siguientes:
  - El directorio de instalación de WebSphere Application Server, si utiliza ese producto
  - El directorio de instalación del producto EGL
  - El sitio Web de Derby: http://db.apache.org/derby/
6. Pulse Finalizar.
7. Pulse Aceptar.

Ejecutar un programa de prueba

Para asegurarse de que la conexión de base de datos está en funcionamiento, siga estos pasos para ejecutar un programa de ejemplo y visualizar las filas de la base de datos en la consola.

Pulse Archivo > Nuevo > Programa.
En la ventana Programa EGL nuevo, especifique programs en el campo Paquete.
Especifique databaseTest en el campo Nombre de archivo fuente EGL. La ventana Componente de programa EGL nuevo tiene el aspecto siguiente:
Pulse Finalizar. El programa nuevo se creará y se abrirá en el editor.

Sustituya todo el código del programa nuevo por este código:

package programs;

import EGLDerbyDB.data.Customer;

program databaseTest type BasicProgram {}
  
  function main()
    customer Customer;
    open allResults for customer;
    
    SysLib.writeStdout("#"::" Nombre de cliente");
    forEach (customer)
      SysLib.writeStdout(customer.CustomerId::" "
        ::customer.FirstName::" "::customer.LastName);
    end
    
  end
  
end

Guarde el programa.
Genere todo el proyecto pulsando el programa EGLSQL con el botón derecho del ratón en la vista Explorador de proyectos y pulsando Generar.
Para poder ejecutar el programa, debe desconectar las herramientas de base de datos de la base de datos. Derby sólo permite una conexión simultánea, y las herramientas EGL utilizadas para crear los componentes de datos y para establecer los valores del descriptor de construcción permanecerán conectadas hasta que cierre la conexión.
Cierre la conexión de base de datos para que la base de datos quede disponible para el programa en tiempo de ejecución:
1. Abra la vista Explorador de proyectos pulsando Ventana > Mostrar vista > Otras, seleccionando Gestión de datos > Explorador de orígenes de datos en la lista de vistas y finalmente pulsando Aceptar.
2. En la vista Explorador de bases de datos, expanda Conexiones de base de datos. La conexión de base de datos figurará en la lista Conexiones de base de datos con el mismo nombre que ha seleccionado en el descriptor de construcción de EGL, por ejemplo EGLDerbyDB.
3. Pulse la conexión de base de datos con el botón derecho del ratón y pulse Desconectar.
4. Cierre la vista Explorador de bases de datos. Más adelante, en esta guía de aprendizaje aprenderá más cosas acerca de las herramientas de datos, incluida esta vista.
Ejecute el programa de prueba:
1. Expanda EGLSQL/JavaSource/programs. La carpeta JavaSource contiene la salida generada de los programas.
2. Pulse el archivo databaseTest.java con el botón derecho del ratón y luego pulse Ejecutar como > Aplicación Java.

Resultados

Cuando ejecute el programa de prueba, debe visualizar el contenido de la tabla CUSTOMER de la base de datos en la vista Consola:

Salida del programa de prueba en la vista Consola

Si observa un mensaje de error en lugar de la salida en la vista Consola, consulte la sección Resolución de problemas.

< Anterior | Siguiente >

Comentarios