Información sobre la interfaz Java
La API consiste en un archivo JAR (StyleVisionServer.jar) y un archivo JNI (StyleVisionServer.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 StyleVision 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 StyleVision Server, los archivos de la versión de 32 bits de StyleVisionServer.jar y (StyleVisionServer.dll estarán en la carpeta bin\API_32bit de la carpeta de instalación de StyleVision 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 StyleVision Server, los archivos de la versión de 64 bits de APPNAME-UL%>.jar y (StyleVisionServer.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 StyleVision Server agregue estas referencias al archivo .classpath de su proyecto Java.
StyleVisionServer.jar La biblioteca que se comunica con StyleVision Server
StyleVisionServer_JavaDoc.zip Documentación de la API de StyleVision Server
Además, java.library.path debe incluir la carpeta en la que se encuentra el archivo de biblioteca JNI (StyleVisionServer.dll).
Si implementa su proyecto en una aplicación de servidor, asegúrese de que StyleVisionServer.jar y StyleVisionServer.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 StyleVision Server.
Generar y ejecutar un programa Java con la API
Para aprender a generar y ejecutar un programa Java que use la API de StyleVision 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\StyleVisionServer2023\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%\StyleVisionServer.jar" Program.java
REM Run sample java REM The -cp option (classpath) needs to point to the StyleVisionServer.jar file REM The java.library.path needs to include the folder where the JNI library StyleVisionServer.dll is located. %1\java.exe -cp "%JavaAPIBinPath%\StyleVisionServer.jar;." -Djava.library.path="%JavaAPIBinPath%" Program
@echo off goto end
:error echo Usage: buildAndRun "<path_to_java_bin_folder>"
:end |
Añadir las referencias de la biblioteca de StyleVision Server en Eclipse
En Eclipse puede añadir las referencias editando las propiedades del proyecto Java, tal y como se explica en las siguientes instrucciones (solo relevantes para Eclipse 4.4).
1.Abra el proyecto en Eclipse, haga clic en Project | Properties y después seleccione Java Build Path.
2.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 StyleVisionServer.jar (situado en la carpeta de instalación de StyleVision Server).
3.En el panel JARs and class folders on the build path, expanda el nodo StyleVisionServer.jar y después haga doble clic en el registro Javadoc location: (None).ç
4.Compruebe que están marcadas las opciones Javadoc in archive y External file y en el campo Archive path seleccione el archivo StyleVisionServer_JavaDoc.zip (situado en la carpeta de instalación de StyleVision Server).
5.Haga clic en OK para terminar. La referencia a la biblioteca de StyleVision Server y el archivo de almacenamiento Javadoc se añade ahora al archivo .classpath del proyecto.