Altova MapForce 2023 Enterprise Edition

Este ejemplo explica paso a paso cómo se puede generar una aplicación Java con MapForce y cómo se puede compilar con el entorno Eclipse y Apache Ant. Cuando termine de seguir los pasos del ejemplo, obtendrá una aplicación Java completa compilada que ejecuta una de las asignaciones de muestra que vienen con MapForce.

Si ya sabe compilar aplicaciones Java con Eclipse y Ant, debe saber que para este ejemplo no hay ningún requisito especial aparte de estos:

•Debe tener instalado en su sistema un Java Development Kit (JDK), Eclipse y Ant. Eclipse suele incluir una versión de Ant, pero también puede instalar Ant por separado (véase también Compilar el proyecto con Ant).

•Para ejecutar Eclipse con OpenJDK, la variable de entorno PATH suele necesitar que incluya la ruta al directorio bin del JDK (por ejemplo, C:\Java\jdk-11.0.1\bin).

•Si ejecuta una versión independiente de Apache Anta, como en este ejemplo, la variable de entorno PATH también debería incluir la ruta al directorio bin de Ant (por ejemplo, C:\apache-ant-1.10.5\bin) para que pueda ejecutar Ant sin tener que escribir toda la ruta de acceso al ejecutable en la línea de comandos.

Para este ejemplo se usó esta configuración:

•MapForce de 64 bits

•OpenJDK 11.0.1 de 64 bits

•Eclipse IDE para desarrolladores de Java, versión 2019-03 (4.11.0), de 64 bits

•Apache Ant 1.10.6 (instalado como versión independiente) y Apache Ant 1.10.5 (versión incluida en Eclipse)

Paso 1: Generar código Java

Para generar el código Java en MapForce:

1.En el menú Archivo haga clic en el comando Abrir y navegue hasta la asignación de datos CompletePO.mfd del directorio <Documentos>\Altova\MapForce2023\MapForceExamples\.

2.En el menú Resultados haga clic en el comando Java. Esto activa el lenguaje de transformación Java.

3.En el menú Archivo haga clic en el comando Generar código en | Java. Cuando la aplicación lo solicite, navegue hasta el directorio donde se debe guardar el proyecto Java (p. ej en el espacio de trabajo predeterminado de Eclipse). Para nuestro ejemplo usaremos el directorio de trabajo C:\codegen\java\CompletePO. Necesitaremos hacer referencia a este directorio más adelante.

Paso 2: importar el proyecto en Eclipse

Para importar el proyecto en Eclipse:

1.Si todavía no lo ha hecho, ejecute Eclipse y cambie a la perspectiva Java predeterminada (con el comando de menú Window | Open Perspective).

2.En el menú File haga clic en el comando Import y después seleccione Existing Projects into Workspace (proyectos actuales al espacio de trabajo).

3.Haga clic en Next para continuar.

4.Navegue hasta la carpeta donde guardó el código generado y después haga clic en Finish para finalizar. El proyecto Java creado con MapForce aparece ya en la vista del explorador de paquetes Package Explorer. Si no puede ver la vista Package Explorer, puede activarla con el comando de menú Window | Show View | Package Explorer.

Paso 3: Ejecutar el proyecto Java como aplicación de interfaz gráfica

Para ejecutar el proyecto Java como aplicación de interfaz gráfica:

1.En la vista Package Explorer de Eclipse seleccione el archivo MappingApplication.java situado en el paquete com.mapforce.

2.En el menú de ejecución Run haga clic en el comando Run As | Java application para ejecutar el archivo como aplicación Java.

3.En la ventana de la aplicación MapForce que aparece haga clic en Start para iniciar la ejecución de la asignación de datos.

Si Eclipse detecta errores de configuración del sistema o de tiempo de ejecución, recibirá un mensaje de Eclipse (véase Control de referencias JDBC). Si no se encuentran errores, la aplicación Java ejecuta la transformación de asignación de datos y genera el archivo CompletePO.xml en la ruta de acceso de salida (en nuestro ejemplo: C:\workspace\CompletePO\CompletePO.xml).

Paso 4: ejecutar el proyecto como aplicación de consola

Para ejecutar el proyecto como aplicación de consola:

1.En la vista del explorador de paquetes Package Explorer de Eclipse seleccione el archivo MappingConsole.java situado en el paquete com.mapforce.

2.En el menú de ejecución Run haga clic en el comando Run As | Java application para ejecutar el archivo como aplicación Java.

Si Eclipse detecta errores de configuración del sistema o de tiempo de ejecución, recibirá un mensaje de Eclipse (véase Control de referencias JDBC). Si no se encuentran errores, la aplicación Java ejecuta la transformación de asignación de datos y genera el archivo CompletePO.xml en la ruta de acceso de salida (en nuestro ejemplo: C:\workspace\CompletePO\CompletePO.xml).

Paso 5: generar el archivo JAR

Si Apache Ant viene incluido con Eclipe puede generar el archivo JAR directamente desde el entorno de desarrollo integrado Eclipse. De lo contrario, para generar el archivo JAR en la linea de comandos fuera de Eclipse, debe instalar Apache Ant por separado.

Para generar el archivo .jar con Ant en Eclipse:

1.En la vista Package Explorer de Eclipse, haga clic con el botón derecho en el archivo build.xml y apunte al menú Run As. En este menú se muestran dos opciones de ejecutar el archivo de generación de Ant.Si elige la primera, Eclipse inicia la generación con las opciones predeterminadas. Si elige la segunda opción, puede cambiar las opciones antes de iniciar la generación. Elija la segunda opción.

2.Haga clic en los componentes de destino que quiere incluir en la generación de Ant. En este ejemplo hemos seleccionado test y jar.

3.Haga clic en Run (ejecutar). Eclipse ejecuta el archivo de generación de Ant y muestra el resultado en la vista Console.

Para generar el archivo JAR en la línea de comando:

1.Asegúrese de que el directorio en el que está instalado Apache Ant (por ejemplo, C:\apache-ant-1.10.5\bin) se añade a la variable de entorno PATH.

2.Abra la ventana de la línea de comandos y cambie el directorio actual por aquel en el que quiere generar el código Java (en este ejemplo, C:\codegen\java\CompletePO). Este es también el directorio en el que se genera el archivo build.xml.

3.En la línea de comandos, escriba:

Ant ejecuta los destinos "clean" y "jar" del archivo build.xml (y destinos dependientes) y muestra el resultado en la línea de comandos: