Altova StyleVision Server 2025

Informationen zur Java-Schnittstelle

Zur Startseite Zurück Nach oben Weiter

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.

 

 

 

 

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.

 

© 2018-2024 Altova GmbH