< Anterior | Siguiente >

Lección 4: Crear componentes para acceder a una base de datos

En esta lección creará los componentes lógicos y de datos que permiten acceder a la base de datos de ejemplo.
El asistente Aplicación de acceso a datos EGL crea el código EGL necesario para acceder a una base de datos. Aunque puede personalizar el código cuando se ejecuta el asistente, normalmente el asistente crea los componentes EGL siguientes:

Crear componentes a partir de la conexión de base de datos

En la lección anterior, creó una conexión con la base de datos. A partir de esa conexión, EGL puede crear los componentes necesarios para acceder a la base de datos:

  1. Pulse Archivo > Nuevo > Otros. Se abre la ventana Nuevo.
  2. Expanda EGL y pulse Aplicación de acceso a datos.
  3. Pulse Siguiente.
  4. En la ventana Definir valores de proyecto, asegúrese de que EGLWeb aparece en la lista Nombre de proyecto.
  5. En la lista Conexión de base de datos, seleccione la conexión EGLDerbyDB que creó en la lección anterior. Es posible que se le pida un ID de usuario y una contraseña para la base de datos. En tal caso, especifique un nombre y una contraseña; no se necesita una contraseña para la base de datos, pero las herramientas de datos del entorno de trabajo pueden esperar que se proporcione una. Ha establecido una conexión con la base de datos. 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.
  6. Bajo Seleccionar tablas, marque sólo 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:
    Imagen de la ventana Aplicación de acceso a datos EGL con las seis tablas seleccionadas
  7. Asegúrese de que el recuadro de selección Crear páginas web este deseleccionado. Si este recuadro de selección está seleccionado, EGL crea páginas web directamente desde las tablas de base de datos. Esta característica puede ahorrar tiempo creando una aplicación de acceso a datos simple, pero eso anularía el objetivo de esta guía de aprendizaje.
    Nota: No pulse aún Finalizar. Debe cambiar un valor más en este asistente.
  8. 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.
  9. Vuelva a pulsar Siguiente para pasar a la página Definir opciones de creación de proyecto.
  10. En la página Definir opciones de creación de proyecto, marque el recuadro de selección Calificar nombres de tabla con esquema.
  11. Pulse Finalizar.

Punto de comprobación de lección

El asistente Aplicación de acceso a datos ha creado varios artefactos EGL en el proyecto EGLWeb.

En primer lugar, hay varios paquetes EGL nuevos en la carpeta EGLSource del proyecto EGLWeb, incluyendo eglderbydb.data, eglderbydb.access y eglderbydb.primitivetypes.data. Los paquetes funcionan como carpetas: contienen los archivos de código fuente y los organizan en grupos significativos. En este caso, el paquete eglderbydb.data alberga los registros, el paquete eglderbydb.access alberga las bibliotecas y el paquete eglderbydb.primitivetypes.data alberga los DataItems.

Estos son algunos de los archivos que resultan útiles para esta guía de aprendizaje:
eglderbydb.primitivetypes.data.DataDefinitions.egl
Este archivo lista todos los DataItems que configuran los componentes Record en los otros archivos. Por ejemplo, el número de ID de cliente dado a cada registro de cliente de la base de datos está representado por un DataItem llamado CUSTOMER_ID:
dataitem CustomerId INT end
En este caso, el campo de número de ID está basado en el tipo primitivo entero. El DataItem puede tener otras propiedades para especificar detalles como por ejemplo el intervalo de valores válido correspondiente y cómo debe formatearse en la interfaz de usuario.
eglderbydb.data.Customer.egl
Este archivo contiene uno de los registros creados a partir de las tablas de base de datos, en este caso la tabla Customer. Este registro contiene campos para albergar información acerca de un cliente, como por ejemplo el nombre y el apellido del cliente, su dirección, su número de teléfono y su número de ID. La definición del registro tiene el aspecto siguiente:
record Customer type sqlRecord { 
        tablenames=[["EGL.CUSTOMER"]],
        fieldsMatchColumns = yes,
        keyItems=[CUSTOMERID]
    }  

  CUSTOMERID CUSTOMERID {column="CUSTOMERID"};
  FIRSTNAME FIRSTNAME {column="FIRSTNAME", sqlVariableLen=yes, maxLen=30, isSqlNullable=yes};
  LASTNAME LASTNAME {column="LASTNAME", sqlVariableLen=yes, maxLen=30, isSqlNullable=yes};
  ...
end
eglderbydb.access.CustomerLib.egl
Este archivo contiene una biblioteca de funciones generada automáticamente que puede utilizar para acceder a la tabla Customers de la base de datos. Por ejemplo, la primera función es AddCustomer que añade un registro nuevo a la base de datos. Hay otras funciones de esta biblioteca que recuperan, actualizan y suprimen registros en la base de datos y cada tabla tiene funciones similares en una biblioteca aparte. Estas funciones se utilizarán más adelante, en la guía de aprendizaje.
< Anterior | Siguiente >

Comentarios