myAppGen

Usted Construye la aplicacin

mientras la ejecuta
http://www.myAppGen.com
info@myAppGen.com
Tutorial 1 Conexin con la Base de Datos

Establecer la conexin 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, tambin se instala una versin 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 conexin 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 conexin, adems de tener la base de datos instalada y funcionando,
se debe definir los parmetros de conexin:

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 informacin.
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 extensin jar y es proporcionado
por el fabricante de la base de datos.

En este Tutorial le presentaremos una serie de ejemplos de conexin 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:
Instalacin de la base de datos.
Instalacin de interfaces grficas de la base de datos, como Administrator, Query
Browser, etc.
Instalacin del driver de la base de datos.
Iniciar el servicio de la base de datos.

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 grficas 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 extensin 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-5.1.12-bin.jar.
Para Instalar el driver, simplemente se copia este archivo en alguna carpeta donde
JAVA lo pueda encontrar, puede ser un path especfico de su aplicacin (entonces
estar disponible slo en su aplicacin) 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-5.1.12-bin.jar

Carpeta de Java: Java tiene dos carpetas, una de desarrollo y otra de ejecucin:
Java de desarrollo: .../java/jsdk xxx/jre/lib/ext/mysql-connector-java-5.1.12-bin.jar
Java de ejecucin: .../java/jre/lib/ext/ mysql-connector-java-5.1.12-bin.jar

Iniciar el servicio de MySQL. Cuando se instala MySQL, normalmente queda
configurado para que se inicie automticamente 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.




















Para detener el servicio de MySQL siga los mismos pasos, pero elija la opcin
Detener el servicio.








Configurar el Database Driver
A continuacin 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
algn servidor.

Configurar el Database Driver - Base de datos instalada por myAppGen
Habamos dicho que al instalar myAppGen tambin se instala una versin 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 aplicacin y luego asegrese de
detener cualquier otro servicio de
MySQL activo en su estacin.




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 botn New, a continuacin abra
en forma sucesiva las carpetas: Tutorials , Tutor y Tutorial 1 Connection with
the Database.
Luego escriba el nombre del diccionario y confirme la operacin.









Al crear el diccionario ya trae definida y totalmente configurada la conexin con la base
de datos. Para verificar el funcionamiento simplemente presione el botn Change y
luego Test connection

Para finalizar, puede grabar el diccionario Save y luego salir de la aplicacin Exit.

Al cerrar myAppGen, tambin se cierra el servicio de MySql que haba sido instanciado
por myAppGen. Observe el Administrador de tareas del Sistema Operativo.



Observacin: A continuacin mostraremos como conectarse a una base de datos MySql
local o de algn 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 algn servidor

A continuacin explicaremos detalladamente cmo crear un nuevo Database Driver,
para conectarse a una base de datos MySQL local o de algn servidor.

Asegrese que MySQL est funcionando en el servidor o su propio equipo. Puede
iniciar su servicio desde el administrador de servicios.









Ejecute myAppGen, presione, el botn Open, a continuacin 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 ubquese sobre el diccionario
Connections.Dct y confirme la operacin con el botn Abrir.









Observe en la siguiente Figura que no existe ningn proceso de MySQL en el
Administrador de tareas del Sistema Operativo.










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 botn 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.












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 estndar de los parmetros de conexin, pero
lastimosamente, esto no garantiza que se pueda
establecer la conexin, ya que el valor de estos
parmetros depende de lo que fue especificado en el
momento de instalacin de la base de datos.
5. Complete el nombre del driver, el Usuario y el
Password.
6. Verifique la conexin presionando Test connection.
7. Agregue el database driver con el botn .










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 conexin, asegrese de que el driver est copiado en las
carpetas que le hemos indicado, lea la documentacin del driver y asegrese que est
utilizando los parmetros correctos: Driver, Host, Port, Database, Url, User, Password.









El Template Url, puede ser modificado presionando ; adems, usted puede escribir en
forma genrica utilizando las etiquetas <HOST>, <PORT>, <DB> como variables de
sustitucin.

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 versin para
desarrolladores Oracle 10g Express Edition.
Instalar el cliente, en nuestro caso tenemos instalado la versin para desarrolladores
Oracle Client 10g Express Edition.
Al instalar la base de datos se instala tambin una interface grfica 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.
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 ejecucin:
Java de desarrollo: .../java/jsdk xxx/jre/lib/ext/ojdbc6.jar
Java de ejecucin: .../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.

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 estacin 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 estacin de trabajo y se comporta como servidor y cliente.

Consulte con el Administrador de Oracle para definir el Usuario y Password puede usar.

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 versin para
desarrolladores Microsoft SQL Server 2005.
Al instalar la base de datos se instala tambin una interface grfica 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 conexin 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 ejecucin:
Java de desarrollo: .../java/jsdk xxx/jre/lib/ext/sqljdbc4.jar
Java de ejecucin: .../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.







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 conexin con la base de datos, sin embargo cuando en el siguiente Tutorial
le mostremos como crear el modelo lgico, en el mismo debe usar los esquemas que
necesite la aplicacin. Ejemplo la base de datos FACTURA tiene los esquemas
APP_GEN_DB y BASICO.
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 versin para
desarrolladores DB2 Versin 9.5.
Al instalar la base de datos se instala tambin una interface grfica 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 ejecucin:
Java de desarrollo: .../java/jsdk xxx/jre/lib/ext/
Java de ejecucin: .../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.












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,
asegrese de utilizar la base de datos para realizar la conexin. En nuestro ejemplo la
base de datos es TESTDB2.
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 versin para
desarrolladores Informix Dynamic Server 11.50.
Instalar el cliente, en nuestro caso tenemos instalado la versin para desarrolladores
Informix Client SDK 3.50.
Al instalar la base de datos de desarrollo no se disponibiliza una interface grfica
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 instalacin 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 ejecucin:
Java de desarrollo: .../java/jsdk xxx/jre/lib/ext/
Java de ejecucin: .../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.

















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 versin de Informix que estamos utilizando existe una base de datos de nombre
sysadmin, la cual se utiliza para efectos de la conexin. 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 botn
Lock Template Url y reemplazar <SERVER_NAME> por su valor respectivo, en
nuestro caso se reemplaz por ol_ids_1150_1.

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 aplicacin 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 muchsima informacin disponible en los foros
especializados y en los sitios de los fabricantes de las bases de datos.