Interfaz Java
La API consiste en un archivo JAR (MapForceServer.jar) y un archivo JNI (MapForceServer.dll). Estos dos archivos, así como otros archivos relacionados con la API, están disponibles en la carpeta bin de la carpeta de instalación de MapForce Server. Puede hacer referencia a esos archivos desde su ubicación original o copiarlos a otra ubicación si eso encaja en su configuración del proyecto. (En sistemas Windows necesitará derechos de administrador para ejecutar el programa desde su ubicación original.)
| Nota: | si instaló una versión de 64 bits de MapForce Server, los archivos de la versión de 32 bits de MapForceServer.jar y (MapForceServer.dll estarán en la carpeta bin\API_32bit de la carpeta de instalación de MapForce Server. Necesitará estos archivos si está usando una versión de 32 bits. Ocurre igual al contrario, si instaló una versión de 32 bits de MapForce Server, los archivos de la versión de 64 bits de APPNAME-UL%>.jar y (MapForceServer.dll estarán en la carpeta bin\API_64bit. Necesitará estos archivos si está usando una versión de 64 bits. |
Para acceder al código Java de la API de MapForce Server agregue estas referencias al archivo .classpath de su proyecto Java.
MapForceServer.jar La biblioteca que se comunica con MapForce Server
MapForceServer_JavaDoc.zip Documentación de la API de MapForce Server
Además, java.library.path debe incluir la carpeta en la que se encuentra el archivo de biblioteca JNI (MapForceServer.dll).
Si implementa su proyecto en una aplicación de servidor, asegúrese de que MapForceServer.jar y MapForceServer.dll están configurados correctamente con Java en el equipo servidor.
Para ver un ejemplo de cómo usar los archivos de biblioteca de la API consulte el archivo buildAndRun.bat (véase más abajo), que se encuentra en la carpeta etc\Examples\Java de la carpeta de instalación de MapForce Server.
Generar y ejecutar un programa Java con la API
Para aprender a generar y ejecutar un programa Java que use la API de MapForce Server consulte el archivo de ejemplo buildAndRun.bat. Puede reutilizar este archivo para ejecutar sus propios programas de Java; para ello modifíquelo como necesite.
Inicie el archivo de lote en una interfaz de la línea de comandos con este comando:
buildAndRun "path_to_Java_bin_folder"
| Nota: | para comprobar si Java es su classpath puede ejecutar el comando java --version. Si Java no es su classpath debe proporcionar la ruta de acceso relevante como parámetro del comando buildAndRun. Si la ruta contiene espacios debe usar comillas entorno a la ruta. |
@echo off if %1.==. goto error
REM The location of the JAVA API binaries, the JAR file and the JNI library. REM Adapt to your needs. SETLOCAL Set JavaAPIBinPath=%PROGRAMFILES%\Altova\MapForceServer2023\bin
REM Compile sample java REM The -cp option (classpath) needs to point to the installed jar file (here, in its original location) REM "Program.java" is the Java program you want to compile %1\javac.exe -cp "%JavaAPIBinPath%\MapForceServer.jar" Program.java
REM Run sample java REM The -cp option (classpath) needs to point to the MapForceServer.jar file REM The java.library.path needs to include the folder where the JNI library MapForceServer.dll is located. %1\java.exe -cp "%JavaAPIBinPath%\MapForceServer.jar;." -Djava.library.path="%JavaAPIBinPath%" Program
@echo off goto end
:error echo Usage: buildAndRun "<path_to_java_bin_folder>"
:end |
Para añadir las referencias de la biblioteca de MapForce Server en Eclipse
Si está usando Eclipse como entorno de desarrollo Java, puede agregar las referencias a la biblioteca que necesite a CLASSPATH editando las propiedades del proyecto Java, como explicamos a continuación. También puede adjuntar documentación en formato JavaDoc a la biblioteca .jar. Puede encontrar el JavaDoc en la carpeta bin de la carpeta de instalación de MapForce Server; a continuación explicamos cómo hacer que el JavaDoc sea visible desde Eclipse.
1.Abra el proyecto en Eclipse y haga clic en Project | Properties.
2.Haga clic en Java Build Path.
3.En la pestaña Libraries de bibliotecas haga clic en el botón Add External JARs para añadir archivos JAR externos y navegue hasta el archivo MapForceServer.jar (situado en la carpeta de instalación de MapForce Server).
4.En el panel JARs and class folders on the build path, expanda el nodo MapForceServer.jar y después haga doble clic en el registro Javadoc location: (None).
5.Compruebe que están marcadas las opciones Javadoc in archive y External file y en el campo Archive path seleccione el archivo MapForceServer_JavaDoc.zip (situado en la carpeta de instalación de MapForce Server).
6.Haga clic en OK para terminar. La referencia a la biblioteca de MapForce Server y el archivo de almacenamiento Javadoc se añade ahora al archivo .classpath del proyecto.
A continuación puede ver un ejemplo de archivo .classpath que hace referencia a los archivos de la carpeta de instalación en un sistema operativo de 64 bits que ejecuta la versión de 32 bits de MapForce Server (las líneas relevantes están resaltadas en amarillo):
<?xml version="1.0" encoding="UTF-8"?> |