myappgen Usted Construye la aplicación mientras la ejecuta

Transcripción

1 myappgen Usted Construye la aplicación mientras la ejecuta

2 Tutorial 1 Conexión con la Base de Datos Establecer la conexión con la base de datos no suele ser muy simple, ya que tenemos que instalar varios softwares y configurarlos para que todos funcionen integradamente. Para evitar estas dificultades, al instalar myappgen, también se instala una versión de desarrollo de la base de datos MySql con su driver JDBC, totalmente configurado. Ver la siguiente Figura. Si es necesario, puede utilizar la misma interface para modificar la conexión o crear otras conexiones con otras bases de datos (MySql, Oracle, Db2, Informix, SqlServer, etc). De hecho, el diccionario puede tener varias conexiones activas, incluso con distintas bases de datos. Para establecer la conexión, además de tener la base de datos instalada y funcionando, se debe definir los parámetros de conexión: Host: Es el nombre del servidor donde está funcionando la base de datos. Port: Es el puerto donde la base de datos escucha los pedidos de información. Database: Es el nombre de una Database y/o Schema definido en la base de datos. User: Es un usuario definido en la base de datos. Password: Es el password del usuario creado en la base de datos. Driver JDBC: Para conectarse con la base de datos es imprescindible contar con el driver correspondiente. El driver es un archivo con extensión jar y es proporcionado por el fabricante de la base de datos. En este Tutorial le presentaremos una serie de ejemplos de conexión a las bases de datos MySql, Oracle, SqlServer, Db2, Informix. Para cada base de datos le indicaremos brevemente las instalaciones y pasos previos que se suelen realizar: Instalación de la base de datos. Instalación de interfaces gráficas de la base de datos, como Administrator, Query Browser, etc. Instalación del driver de la base de datos. Iniciar el servicio de la base de datos.

3 MySQL Instalaciones y Pasos Previos Antes de configurar el Database Driver para acceder a MySQL se debe: Instalar la base de datos, en nuestro caso tenemos instalado el MySQL Server 5.0. Instalar las interfaces gráficas disponibles para el manejo de la base de datos, normalmente son dos el MySQL Administrator y el MySQL Query Browser. Instalar el Driver: Para conectarse a la base de datos es imprescindible contar con el driver correspondiente. El driver es un archivo con extensión jar y es proporcionado por el fabricante de la base de datos. Normalmente, se encuentra disponible al instalar la base de datos en alguna subcarpeta relacionada a java o jdbc. Si no lo encuentra puede hacer download del sitio del fabricante. En nuestro caso, utilizaremos el archivo: mysql-connector-java bin.jar. Para Instalar el driver, simplemente se copia este archivo en alguna carpeta donde JAVA lo pueda encontrar, puede ser un path específico de su aplicación (entonces estará disponible sólo en su aplicación) o en el path de Java (entonces estará disponible en todas las aplicaciones ejecutadas con Java) En nuestro caso instalaremos el driver en todas las carpetas: Carpeta de myappgen: myappgen/rt/lib/ext/mysql-connector-java bin.jar Carpeta de Java: Java tiene dos carpetas, una de desarrollo y otra de ejecución: Java de desarrollo:.../java/jsdk xxx/jre/lib/ext/mysql-connector-java bin.jar Java de ejecución:.../java/jre/lib/ext/ mysql-connector-java bin.jar Iniciar el servicio de MySQL. Cuando se instala MySQL, normalmente queda configurado para que se inicie automáticamente el servicio de la base de datos al iniciar el sistema operativo. Para verificar si el servicio de MySQL esta funcionando, seleccione panel de control, herramientas administrativas, servicios, dentro de Servicios seleccione MySQL, en caso de que necesite iniciar MySQL presione clic sobre Iniciar el servicio.

4 Para detener el servicio de MySQL siga los mismos pasos, pero elija la opción Detener el servicio. Configurar el Database Driver A continuación le mostraremos como configurar el database driver cuando se utiliza la base de datos instalada por myappgen y cuando se utiliza una base de datos local o de algún servidor. Configurar el Database Driver - Base de datos instalada por myappgen Habíamos dicho que al instalar myappgen también se instala una versión de desarrollo de la base de datos MySql con su driver JDBC, totalmente configurado. Al ejecutar myappgen verifica si existe alguna instancia de MySql funcionando, si no es así, entonces inicia el servicio de MySql instalada por myappgen. Para hacer esta prueba, primero debemos parar cualquier otro servicio de MySql y luego ejecutar myappgen. Si esta ejecutando myappgen, cierre la aplicación y luego asegúrese de detener cualquier otro servicio de MySQL activo en su estación.

5 Ejecute el myappgen, como no existe ninguna instancia de MySql funcionando, entonces se iniciará el servicio de la base de datos local de myappgen. Observe en el Administrador de tareas del Sistema Operativo que el proceso de MySQL (local iniciado por myappgen) se está ejecutando. Ahora crearemos el diccionario que usaremos en el trascurso de este Tutorial, este diccionario trabaja con la base de datos local instalada por myappgen. Desde la pantalla principal de myappgen presione el botón New, a continuación abra en forma sucesiva las carpetas: Tutorials, Tutor y Tutorial 1 Connection with the Database. Luego escriba el nombre del diccionario y confirme la operación. Al crear el diccionario ya trae definida y totalmente configurada la conexión con la base de datos. Para verificar el funcionamiento simplemente presione el botón Change y luego Test connection

6 Para finalizar, puede grabar el diccionario Save y luego salir de la aplicación Exit. Al cerrar myappgen, también se cierra el servicio de MySql que había sido instanciado por myappgen. Observe el Administrador de tareas del Sistema Operativo. Observación: A continuación mostraremos como conectarse a una base de datos MySql local o de algún servidor. No obstante es importante que para los otros Tutoriales utilice siempre la base de datos MySQL instalada por myappgen. Configurar el Database Driver - Base de datos local o de algún servidor A continuación explicaremos detalladamente cómo crear un nuevo Database Driver, para conectarse a una base de datos MySQL local o de algún servidor. Asegúrese que MySQL está funcionando en el servidor o su propio equipo. Puede iniciar su servicio desde el administrador de servicios. Ejecute myappgen, presione, el botón Open, a continuación abra en forma sucesiva las carpetas de Tutorials, Tutor, y Tutorial 1 Connection with the Database. En la carpeta Tutorial 1 Connection with the Database ubíquese sobre el diccionario Connections.Dct y confirme la operación con el botón Abrir. Observe en la siguiente Figura que no existe ningún proceso de MySQL en el Administrador de tareas del Sistema Operativo.

7 Antes de crear el nuevo driver, vea cual base de datos puede utilizar. En nuestro ejemplo usamos app_gen_db que está creada en la base de datos MySQL local. Para crear el nuevo Database Driver siga los siguientes pasos. 1. Presione el botón Set Database Driver que se encuentra en la pantalla principal del myappgen. 2. En la Lista Used Database Drivers presione Add. 3. Desde el formulario Database Driver presione clic sobre List Drivers records.

8 4. En la Lista Database Driver seleccione MySQL (MM.MySQL driver) y confirme con Select row. Para las Bases de Datos (mysql, Oracle, SqlServer, DB2, Informix), podemos seleccionar el driver de la lista de la Figura de la derecha. Ella nos propone los valores estándar de los parámetros de conexión, pero lastimosamente, esto no garantiza que se pueda establecer la conexión, ya que el valor de estos parámetros depende de lo que fue especificado en el momento de instalación de la base de datos. 5. Complete el nombre del driver, el Usuario y el Password. 6. Verifique la conexión presionando Test connection. 7. Agregue el database driver con el botón. Como se observa en la Figura de este ejemplo, el usuario jperez tiene acceso a la base de datos APP_GEN_DB. El usuario y password debe existir en la base de datos. Si no consigue establecer la conexión, asegúrese de que el driver esté copiado en las carpetas que le hemos indicado, lea la documentación del driver y asegúrese que está utilizando los parámetros correctos: Driver, Host, Port, Database, Url, User, Password. El Template Url, puede ser modificado presionando ; además, usted puede escribir en forma genérica utilizando las etiquetas <HOST>, <PORT>, <DB> como variables de sustitución.

9 Oracle Instalaciones y Pasos Previos Antes de configurar el Database Driver para acceder a Oracle se debe: Instalar la base de datos, en nuestro caso tenemos instalado la versión para desarrolladores Oracle 10g Express Edition. Instalar el cliente, en nuestro caso tenemos instalado la versión para desarrolladores Oracle Client 10g Express Edition. Al instalar la base de datos se instala también una interface gráfica para el manejo de la base de datos. Ejecute esta interface presionando doble clic en Database_homepage. En Oracle se debe crear un usuario por cada Database/Schema, vea la siguiente Figura.

10 Desde el Explorador de Objetos puede ver todas las tablas asociadas al usuario creado, en nuestro ejemplo el usuario es APP_GEN_DB. Copiar el driver de Oracle de nombre ojdbc6.jar en las siguientes carpetas. Carpeta de myappgen:.../myappgen/rt/lib/ext/ojdbc6.jar Carpeta de Java: Java tiene dos carpetas, una de desarrollo y otra de ejecución: Java de desarrollo:.../java/jsdk xxx/jre/lib/ext/ojdbc6.jar Java de ejecución:.../java/jre/lib/ext/ojdbc6.jar Como se observa en la siguiente Figura, OracleServiceXE y OracleXETNSListener son los servicios iniciados cuando se levanta la base de datos Oracle. Si necesita iniciar Oracle desde el sistema operativo inicie los servicios citados. Configurar el Database Driver Para crear un nuevo Database Driver para Oracle siga los mismos pasos que le hemos indicado en Configurar el Database Driver de MySQL.

11 En este ejemplo elegimos Oracle thin en la Lista de Drivers y luego hicimos las siguientes correcciones: En el caso de Oracle, SID es el System ID que se definió al instalar el cliente oracle en la estación de trabajo; en este Tutorial usamos XE que es el valor de SID que se sugiere al instalar Oracle Express Edition, y utilizamos LocalHost porque la base de datos está funcionando en la estación de trabajo y se comporta como servidor y cliente. Consulte con el Administrador de Oracle para definir el Usuario y Password puede usar.

12 SQL Server Instalaciones y Pasos Previos Antes de configurar el Database Driver para acceder a SQL Server se debe: Instalar la base de datos, en nuestro caso tenemos instalado la versión para desarrolladores Microsoft SQL Server Al instalar la base de datos se instala también una interface gráfica para el manejo de la base de datos de nombre Microsoft SQL Server Management Studio Express. Observe en el siguiente ejemplo que la base de datos FACTURA tiene dos esquemas que son APP_GEN_DB y BASICO; en SQL Server la conexión se debe realizar con la base de datos y no con los esquemas. Copiar el driver de SQL Server de nombre sqljdbc4.jar en las siguientes carpetas. Carpeta de myappgen:.../myappgen/rt/lib/ext/sqljdbc4.jar Carpeta de Java: Java tiene dos carpetas, una de desarrollo y otra de ejecución: Java de desarrollo:.../java/jsdk xxx/jre/lib/ext/sqljdbc4.jar Java de ejecución:.../java/jre/lib/ext/sqljdbc4.jar Para iniciar SQL Server, desde el sistema operativo debe abrir Servicios ; luego debe iniciar los servicios de SQL Server (SQLEXPRESS) y de SQL Server Browser.

13 Configurar el Database Driver Para registrar el Database Driver de acceso a SQL Server, en este ejemplo elegimos Microsoft SQL Server EXPRESS en la Lista de Drivers y luego hicimos las siguientes correcciones. Recuerde que en SQL Server una base de datos puede tener varios esquemas, usted debe establecer la conexión con la base de datos, sin embargo cuando en el siguiente Tutorial le mostremos como crear el modelo lógico, en el mismo debe usar los esquemas que necesite la aplicación. Ejemplo la base de datos FACTURA tiene los esquemas APP_GEN_DB y BASICO.

14 IBM DB2 Instalaciones y Pasos Previos Antes de configurar el Database Driver para acceder a DB2 se debe: Instalar la base de datos, en nuestro caso tenemos instalado la versión para desarrolladores DB2 Versión 9.5. Al instalar la base de datos se instala también una interface gráfica para el manejo de la base de datos de nombre Centro de control. Podemos observar en la siguiente Figura que en DB2 las bases de datos tienen internamente esquemas en los cuales se encuentran definidos los datos. Ejemplo la base de datos TESTDB2 tiene los esquemas APP_GEN_DB y BASICO. Copiar los drivers de DB2 de nombres db2jcc.jar y db2jcc4.jar en las siguientes carpetas. Carpeta de myappgen:.../myappgen/rt/lib/ext/ Carpeta de Java: Java tiene dos carpetas, una de desarrollo y otra de ejecución: Java de desarrollo:.../java/jsdk xxx/jre/lib/ext/ Java de ejecución:.../java/jre/lib/ext/ Para iniciar DB2, desde el sistema operativo debe abrir Servicios ; luego debe iniciar los servicios de DB2 DB2COPY1 DB2 y de DB2DAS DB2DAS00.

15 Configurar el Database Driver Para registrar el Database Driver de acceso a DB2 del siguiente ejemplo, en la Lista de Drivers elegimos IBM DB2 (local) y luego hicimos las siguientes modificaciones. Le hemos indicado anteriormente que en DB2 la base de datos contiene esquemas, asegúrese de utilizar la base de datos para realizar la conexión. En nuestro ejemplo la base de datos es TESTDB2.

16 IBM Informix Instalaciones y Pasos Previos Antes de configurar el Database Driver para acceder a Informix se debe: Instalar la base de datos, en nuestro caso tenemos instalado la versión para desarrolladores Informix Dynamic Server Instalar el cliente, en nuestro caso tenemos instalado la versión para desarrolladores Informix Client SDK Al instalar la base de datos de desarrollo no se disponibiliza una interface gráfica para el manejo de la base de datos. Si usted trabaja con herramientas tales como NetBeans IDE puede realizar esta tarea desde Databases que se encuentra en el Tab Runtime. La instalación del driver de Informix incluye los siguientes archivos: ifxjdbc.jar, ifxjdbcx.jar, ifxlang.jar, ifxlsupp.jar, ifxsqlj.jar y ifxtools.jar. Copie estos archivos en las siguientes carpetas. Carpeta de myappgen:.../myappgen/rt/lib/ext/ Carpeta de Java: Java tiene dos carpetas, una de desarrollo y otra de ejecución: Java de desarrollo:.../java/jsdk xxx/jre/lib/ext/ Java de ejecución:.../java/jre/lib/ext/ Para iniciar Informix, desde el sistema operativo debe abrir Servicios ; luego debe iniciar los servicios de IBM Informix Dynamic Server Message Service y de Informix IDS ol_ids_1150_1.

17 Configurar el Database Driver Para registrar el Database Driver de acceso a Informix, en este ejemplo elegimos Informix Dynamic Server en la Lista de Drivers y luego hicimos los siguientes cambios. En la versión de Informix que estamos utilizando existe una base de datos de nombre sysadmin, la cual se utiliza para efectos de la conexión. Las aplicaciones que usted desarrolle posteriormente no utilizaran esta u otras bases de datos en su modelo de datos, sino que usaran esquemas como : APP_GEN_DB, BASICO, MOVIM, etc. Un caso particular que se presenta en este ejemplo, es que usted debe presionar el botón Lock Template Url y reemplazar <SERVER_NAME> por su valor respectivo, en nuestro caso se reemplazó por ol_ids_1150_1.

18 En la Figura de abajo observamos el diccionario que creamos en este Tutorial con las conexiones a todas estas bases de datos. Así podemos construir aplicaciones que funcionen con tablas de varias bases de datos a la vez. Sin embargo, es recomendable que la aplicación actualice tablas de una sola base de datos ya que no se cuenta con procesamiento de transacciones entre distintas bases de datos. Con esto hemos terminado lo referente a conexiones con las bases de datos, sin embargo, sobre este tema existe muchísima información disponible en los foros especializados y en los sitios de los fabricantes de las bases de datos.