Java-Beispielprojekt
Das StyleVision-Installationspaket enthält ein Java-Beispielprojekt, das Sie im Unterordner API\Java des Ordners Examples finden:
Windows 7, Windows 8, Windows 10, Windows 11 | C:\Benutzer\<Benutzername>\Dokumente\ |
Dieser Ordner enthält Java-Beispiele für die StyleVision API. Sie können das Beispielprojekt mit Hilfe der Batch-Datei BuildAndRun.bat, direkt über die Befehlszeile testen oder Sie können es in Eclipse kompilieren und ausführen. Anleitungen dafür finden Sie weiter unten.
Dateiliste
Der Ordner für die Java-Beispiele enthält alle zum Ausführen des Beispielprojekts erforderlichen Dateien. Diese Dateien sind unten aufgelistet. Wenn Sie eine 64-Bit-Version der Applikation verwenden, enthalten einige Dateinamen _x64. Diese Dateinamen sind mit (_x64) gekennzeichnet.
AltovaAutomation(_x64).dll | Java-COM Bridge: DLL-Teil |
AltovaAutomation.jar | Java-COM Bridge: Java-Bibliotheksteil |
StyleVisionAPI.jar | Java-Klassen der Authentic Desktop API |
RunStyleVision.java | Java-Beispielquellcode |
BuildAndRun.bat | Batch-Datei zum Kompilieren und Ausführen des Beispielcodes über die Befehlszeile. Es wird ein Ordner benötigt, in dem sich die Java Virtual Machine als Parameter befindet. |
.classpath | Hilfedatei Eclipse-Projekt |
.project | Eclipse-Projektdatei |
StyleVision_JavaDoc.zip | Javadoc Datei, die die Hilfedokumentation für die Java API enthält |
Funktionen in diesem Beispiel
In diesem Beispielprojekt wird StyleVision gestartet und einige Operationen wie das Öffnen und Schließen von Dokumenten werden ausgeführt. StyleVision bleibt danach geöffnet. Sie müssen die Applikation manuell schließen.
•StyleVision starten: Startet StyleVision, das als Automation Server registriert ist, bzw. aktiviert das Programm, wenn StyleVision bereits ausgeführt wird.
•OrgChart.pxf öffnen: Navigiert zu einem der mit StyleVision installierten Beispieldokumente und öffnet es.
•Iterieren durch und Ändern des Ansichtsmodus: Hier wird beschrieben, wie man durch offene Dokumente iteriert.
•Event-Behandlung: Zeigt, wie XMLSpy Events behandelt werden.
•StyleVision beenden: Beendet StyleVision.
Sie können das Beispiel beliebig modifizieren und es ausführen.
Ausführen des Beispiels über die Befehlszeile
Um das Beispiel von der Befehlszeile aus auszuführen, öffnen Sie ein Eingabeaufforderungsfester, gehen Sie zum Ordner Java des Ordners API Examples (Pfad siehe oben) und geben Sie folgende Zeile ein:
buildAndRun.bat "<Path-to-the-Java-bin-folder>"
Der Java Binary-Ordner muss von einer JDK 14 oder höheren Version auf Ihrem Rechner sein. Drücken Sie die Eingabetaste. Der Java-Quellcode in RunStyleVision.java wird kompiliert und anschließend ausgeführt.
Laden des Beispiels in Eclipse
Öffnen Sie Eclipse und wählen Sie den Befehl Import | Existing Projects into Workspace um die Eclipse-Projektdatei (.project) im Ordner Java des Ordners API Examples (Pfad siehe oben) zu Eclipse hinzuzufügen. Daraufhin wird das Projekt RunStyleVision in Ihrem Package Explorer oder Navigator angezeigt. Wählen Sie das Projekt aus und klicken Sie anschließend auf Run as | Java Application um das Beispiel auszuführen.
Anmerkung: | Sie können einen Klassennamen oder eine Methode der Java API auswählen und F1 drücken, um Hilfe zu dieser Klasse oder Methode zu erhalten. |
Java-Quellcode
Im Folgenden finden Sie den mit Kommentaren versehenen Java-Quellcode aus der Beispieldatei RunStyleVision.java.
01 // Access general JAVA-COM bridge classes
02 import com.altova.automation.libs.*;
03
04 // Access StyleVision Java-COM bridge
05 import com.altova.automation.StyleVision.*;
06 import com.altova.automation.StyleVision.Enums.ENUMApplicationStatus;
07
08 /**
09 * A simple example that starts the COM server and performs a View operations on it.
10 * Feel free to extend.
11 */
12 public class RunStyleVision
13 {
14 public static void main(String[] args)
15 {
16 // An instance of the application.
17 Application stylevision = null;
18
19 // Instead of COM error-handling, use Java exception mechanism.
20 try
21 {
22 // Start StyleVision as COM server.
23 stylevision = new Application();
24
25 ENUMApplicationStatus status = ENUMApplicationStatus.eApplicationRunning;
26 do{
27 // Check the application status
28 status = stylevision.getStatus();
29 System.out.println("status : " + status + "\n");
30 } while (status != ENUMApplicationStatus.eApplicationRunning);
31
32 // COM servers start up invisible, so we make the server visible
33 stylevision.setVisible(true);
34
35 // Locate samples installed with the product.
36 String strExamplesFolder = System.getenv("USERPROFILE") + "\\My Documents\\Altova\\StyleVision2012\\StyleVisionExamples\\";
37
38 // Open two files from the product samples.
39 stylevision.getDocuments().openDocument(strExamplesFolder + "OrgChart.pxf");
40 stylevision.getDocuments().openDocument(strExamplesFolder + "BiggestCitiesPerContinent.sps");
41
42 // Iterate through all open documents
43 for (Document doc:stylevision.getDocuments())
44 {
45 System.out.println("Document name : " + doc.getName() + "\n");
46 SchemaSources sources = doc.getSchemaSources();
47
48 for (int i = 1; i <= sources.getCount(); i++)
49 {
50 SchemaSource source = sources.getItem(i);
51 System.out.println("\tSchema file name : " + source.getSchemaFileName() + "\n");
52 System.out.println("\tWorking XML file name : " + source.getWorkingXMLFileName() + "\n");
53 System.out.println("\tIs main schema source : " + source.getIsMainSchemaSource() + "\tType name : " + source.getTypeName() + "\n");
54 }
55 }
56 // The following lines attach to the document events using a default implementation
57 // for the events and override one of its methods.
58 // If you want to override all document events it is better to derive your listener class
59 // from DocumentEvents and implement all methods of this interface.
60 Document doc = stylevision.getActiveDocument();
61 doc.addListener(new DocumentEventsDefaultHandler()
62 {
63 @Override
64 public void onDocumentClosed(Document i_ipDoc) throws AutomationException
65 {
66 System.out.println("Document " + i_ipDoc.getName() + " requested closing.");
67 }
68 });
69 doc.close();
70 doc = null;
71
72 System.out.println("Watch StyleVision!");
73 }
74 catch (AutomationException e)
75 {
76 e.printStackTrace();
77 }
78 finally
79 {
80 // Make sure that StyleVision can shut down properly.
81 if (stylevision != null)
82 stylevision.dispose();
83
84 // Since the COM server was made visible and still is visible, it will keep running
85 // and needs to be closed manually.
86 System.out.println("Now close StyleVision!");
87 }
88 }
89 }