À propos de l'interface Java
L’API consiste en un fichier JAR (StyleVisionServer.jar) et en un fichier JNI (StyleVisionServer.dll). Ces deux fichiers, de même que d’autres fichiers API associés, sont disponibles dans le dossier bin du dossier d’installation StyleVision Server. Vous pouvez soit référencer le fichier depuis leur emplacement d'origine soit les copier à un autre emplacement si cela convient à votre configuration de projet. (Sur les systèmes Windows, vous aurez besoin de droits administratifs pour exécuter le programme depuis son emplacement original.)
| Note : | Si vous avez installé StyleVision Server 64-bit, alors les fichiers de version 32-bit de StyleVisionServer.jar et (StyleVisionServer.dll seront situés dans le dossier bin\API_32bit du dossier d’installation StyleVision Server . Vous allez avoir besoin de ces fichiers si vous utilisez une version Java 32-bit. De la même manière, si vous avez installé StyleVision Server 32-bit, alors les fichiers de version 64-bit de StyleVisionServer.jar et (StyleVisionServer.dll seront situés dans le dossier bin\API_64bit. Vous allez avoir besoin de l’utilisation de ces fichiers si vous utilisez une version Java 64-bit. |
Pour accéder à l'API StyleVision Server depuis le code Java, ajouter les références suivantes au fichier .classpath de votre projet Java.
StyleVisionServer.jar La bibliothèque qui communique avecStyleVision Server
StyleVisionServer_JavaDoc.zip Documentation de l’API StyleVision Server
En plus, les besoins java.library.path doivent inclure le dossier où le fichier bibliothèque JNI (StyleVisionServer.dll) est situé.
Si vous déployer votre projet à un serveur d’application, assurez-vous que StyleVisionServer.jar et StyleVisionServer.dll sont correctement configurés avec Java sur l’appareil de serveur.
Pour un exemple comment utiliser les fichiers bibliothèque d’API, voir l’exemple de fichier batch buildAndRun.bat (listed below), qui est situé dans le dossier etc\Examples\Java du dossier d’installation StyleVision Server.
Construire et exécuter un programme Java pour utiliser l’API
Pour voir comment construire et exécuter un programme Java qui utilise l’API StyleVision Server, voir l’exemple de fichier batch buildAndRun.bat. Vous pouvez réutiliser ce fichier à exécuter vos propres programmes Java en le modifiant, les cas échéant.
Démarrer le fichier dans une interface de ligne de commande avec la commande suivante :
buildAndRun "path_to_Java_bin_folder"
| Note : | Pour vérifier si Java est dans votre classpath, vous pouvez exécuter la commande java --version. Si Java n’est pas dans votre classpath, alors vous devez fournir le chemin comme paramètre de la commande buildAndRun. Si le chemin contient des espaces, alors utiliser des guillemets autour du chemin. |
@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\StyleVisionServer2024\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 |
Ajouter des bibliothèques dans Eclipse
Dans Eclipse, vous pouvez ajouter les références classpath en éditant les propriétés du projet Java. Les exemples d’instructions ci-dessous s’appliquent à Eclipse 4.4.
1.Avec le projet ouvert dans Eclipse, dans le menu Projet, cliquez sur les Propriétés, puis sélectionnez Java Build Path.
2.Dans l'onglet Bibliothèques, cliquez sur Add External JARs, puis chercher dans le fichier StyleVisionServer.jar situé dans le dossier d'installation de StyleVision Server.
3.Sous JARs and class folders on the build path, agrandir StyleVisionServer.jar, puis double-cliquer Javadoc location : enregistrement (None).
4.S'assurer que les options Javadoc in archive et External file sont sélectionnées, puis chercher le fichier StyleVisionServer_JavaDoc.zip situé dans le dossier d'installation StyleVision Server.
5.Cliquez sur OK. La référence à la bibliothèque StyleVision Server et l'archive Javadoc est maintenant .classpath ajoutée au fichier.