Informationen zur Java-Schnittstelle
Die API besteht aus einer JAR-Datei (StyleVisionServer.jar) und einer JNI-Datei (StyleVisionServer.dll). Beide Dateien sowie andere damit in Zusammenhang stehende API-Dateien befinden sich im Ordner bin des StyleVision Server Installationsordners. Sie können diese Dateien entweder über ihren Originalordner referenzieren oder sie in einen anderen Ordner kopieren, falls Ihr Projekt dies erfordert. (Auf Windows-Systemen benötigen Sie Administratorrechte, um das Programm von seinem Originalordner aus zu starten).
| Anmerkung: | Wenn Sie eine 64-Bit-Version von StyleVision Server installiert haben, so befinden sich die Dateien der 32-Bit-Version von StyleVisionServer.jar und StyleVisionServer.dll im Ordner bin\API_32bit des StyleVision Server Installationsverzeichnisses. Sie benötigen diese Dateien, wenn Sie eine 32-Bit-Java-Version verwenden. Ebenso, wenn Sie eine 32-Bit-Version von StyleVision Server installiert haben, so befinden sich die Dateien der 64-Bit-Version von StyleVisionServer.jar und StyleVisionServer.dll im Ordner bin\API_64bit. Sie benötigen diese Dateien, wenn Sie eine 64-Bit-Java-Version verwenden. |
Um die StyleVision Server API über Java-Code aufrufen zu können, fügen Sie die folgenden Referenzen zur .classpath-Datei Ihres Java-Projekts hinzu.
StyleVisionServer.jar Die Bibliothek, die mit StyleVision Server kommuniziert
StyleVisionServer_JavaDoc.zip Die Dokumentation zur StyleVision Server API
Des Weiteren muss der java.library.path den Ordner enthalten, in dem sich die JNI-Bibliotheksdatei (StyleVisionServer.dll) befindet.
Wenn Sie Ihr Projekt auf einem Applikationsserver bereitstellen, stellen Sie sicher, dass StyleVisionServer.jar und StyleVisionServer.dll auf dem Server korrekt mit Java konfiguriert sind.
Ein Beispiel dafür, wie die API-Bibliotheksdateien verwendet werden, sehen Sie in der Beispiel-Batch-Datei buildAndRun.bat (siehe unten), im Ordner etc\Examples\Java Ihres StyleVision Server-Installationsverzeichnisses.
Erstellen und Ausführen eines Java-Programms über die API
Ein Beispiel dafür, wie Sie ein Java-Programm, das die StyleVision Server-API verwendet, erstellen und ausführen können, finden Sie in der Beispiel-Batch-Datei buildAndRun.bat. Sie können diese Datei für Ihre eigenen Java-Programme anpassen und wiederverwenden.
Starten Sie die Batch-Datei mit dem folgenden Befehl über eine Befehlszeilenschnittstelle:
buildAndRun "path_to_Java_bin_folder"
| Anmerkung: | Um zu überprüfen, ob sich Java in Ihrem Classpath befindet, führen Sie den Befehl java --version aus. Wenn sich Java nicht in Ihrem Classpath befindet, müssen Sie den Pfad als Parameter des buildAndRun-Befehls angeben. Wenn der Pfad Leerzeichen enthält, setzen Sie ihn in Anführungszeichen. |
@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 |
Hinzufügen der Bibliotheksreferenzen in Eclipse
Sie können die classpath-Referenzen in Eclipse durch Bearbeiten der Eigenschaften des Java-Projekts hinzufügen. Die Beispielanleitung unten gilt für Eclipse 4.4.
1.Klicken Sie, während das Projekt in Eclipse geöffnet ist, auf das Menü Project, anschließend auf Properties und wählen Sie anschließend den Java Build Path aus.
2.Klicken Sie auf dem Register "Libraries" auf Add External JARs und navigieren Sie zur Datei StyleVisionServer.jar im StyleVision Server Installationsordner.
3.Erweitern Sie unter JARs and class folders on the build path den Eintrag StyleVisionServer.jar und doppelklicken Sie anschließend auf den Eintrag Javadoc location: (None).
4.Stellen Sie sicher, dass die Optionen Javadoc in archive und External file aktiviert sind und navigieren Sie anschließend zur Datei StyleVisionServer_JavaDoc.zip im StyleVision Server Installationsordner.
5.Klicken Sie auf OK. Die Referenz zur StyleVision Server Bibliothek und zum Javadoc-Archiv wird zur .classpath-Datei des Projekts hinzugefügt.