Beispiel: Generieren und Ausführen von Java-Code
In diesem Beispiel wird Schritt für Schritt erklärt, wie Sie mit MapForce eine Java-Applikation erstellen und diese außerhalb von MapForce über die Eclipse IDE (Integrated Development Environment) und mit Hilfe von Apache Ant kompilieren. Am Ende des Beispiels haben Sie eine fertige Java-Applikation kompiliert, mit der Sie eines der in MapForce verfügbaren Mapping-Beispiele ausführen können.
Wenn Sie bereits andere Java-Applikationen mit Eclipse und Ant kompilieren können, sind keine weiteren Voraussetzungen für dieses Beispiel erforderlich. Beachten Sie andernfalls die folgenden Punkte:
•Der Java Development Kit (JDK), Eclipse sowie Ant müssen auf Ihrem System installiert sein. Eclipse enthält normalerweise eine gebündelte Version von Ant. Sie können Ant jedoch auch separat installieren, siehe auch Erstellen des Projekts mit Ant.
•Um Eclipse mit OpenJDK auszuführen, muss die PATH-Umgebungsvariable normalerweise den Pfad zum JDK-bin-Verzeichnis (z.B: C:\Java\jdk-11.0.1\bin) enthalten.
•Wenn Sie Apache wie in diesem Beispiel separat ausführen, sollte die PATH-Umgebungsvariable auch den Pfad zum Ant bin-Verzeichnis (z.B. C:\apache-ant-1.10.5\bin) enthalten, sodass Sie Ant jederzeit ausführen können, ohne den vollständigen Pfad zur ausführbaren Datei in der Befehlszeile eingeben zu müssen.
In diesem Beispiel wird die folgenden Konfiguration verwendet:
•MapForce 64-Bit
•OpenJDK 11.0.1 64-Bit
•Eclipse IDE für Java-Entwickler Version 2019-03 (4.11.0), 64-Bit
•Apache Ant 1.10.6 (als eigenständige Applikation installiert) und Apache Ant 1.10.5 (im Paket mit Eclipse)
Schritt 1: Generieren von Java-Code
So generieren Sie den Java-Code in MapForce:
1.Klicken Sie im Menü Datei auf Öffnen und navigieren Sie zum Mapping CompletePO.mfd im Verzeichnis <Dokumente>\Altova\MapForce2024\MapForceExamples\.
2.Klicken Sie im Menü Ausgabe auf Java. Daraufhin wird die Transformationssprache in Java geändert.
3.Klicken Sie im Menü Datei auf Code generieren in | Java. Wenn Sie dazu aufgefordert werden, navigieren Sie zu dem Verzeichnis, in dem das Java-Projekt gespeichert werden soll. Aus Gründen der Einfachheit können Sie das Projekt in diesem Beispiel unter C:\codegen\java\CompletePO speichern. Sie müssen diesen Pfad in späteren Schritten referenzieren.
Schritt 2: Importieren des Projekts in Eclipse
So importieren Sie das Projekt in Eclipse:
1.Starten Sie Eclipse, falls Sie das noch nicht getan haben und wechseln Sie über den Menübefehl Window | Open Perspective in die Java-Standardperspektive.
2.Klicken Sie im Menü File auf Import und anschließend auf General | Existing Projects into Workspace.
![cg_java_example_01](./images/cg_java_example_01.png)
3.Klicken Sie auf Next.
![cg_java_example_02](./images/cg_java_example_02.png)
4.Navigieren Sie zu dem Ordner, in dem Sie zuvor den generierten Code gespeichert haben und klicken Sie anschließend auf Finish. Das mit MapForce erstellte Java-Projekt steht nun in der Package Explorer-Ansicht zur Verfügung. Wenn Sie die Package Explorer-Ansicht nicht sehen, wählen Sie den Menübefehl Window | Show View | Package Explorer, um die Ansicht anzuzeigen.
![cg_java_example_03](./images/cg_java_example_03.png)
Schritt 3: Ausführen des Projekts als Dialog-Applikation
So führen Sie das Java-Projekt als GUI-Applikation aus:
1.Klicken Sie in der Package Explorer-Ansicht von Eclipse auf die Datei MappingApplication.java im Paket com.mapforce.
2.Wählen Sie im Menü Run den Befehl Run As | Java application.
3.Klicken Sie im MapForce-Applikationsfenster auf Start, um das Mapping auszuführen.
![cg_java_example_04](./images/cg_java_example_04.png)
Wenn es in Eclipse zu Laufzeitfehlern oder zu Fehlern im Zusammenhang mit der Systemkonfiguration kommt, erscheint eine entsprechende Eingabeaufforderung, siehe auch Behandlung von JDBC-Referenzen. Andernfalls führt die Java-Applikation die Mapping-Transformation aus und generiert die Datei CompletePO.xml unter dem Ausgabepfad (in diesem Beispiel: C:\codegen\Java\CompletePO).
Schritt 4: Ausführen des Projekts als Konsolenapplikation
So führen Sie das Java-Projekt als Konsolenapplikation aus:
1.Klicken Sie in der Package Explorer-Ansicht von Eclipse auf die Datei MappingConsole.java im Paket com.mapforce.
2.Klicken Sie im Menü Run auf Run As | Java application.
![cg_java_example_05](./images/cg_java_example_05.png)
Wenn es in Eclipse zu Laufzeitfehlern oder zu Fehlern im Zusammenhang mit der Systemkonfiguration kommt, erscheint eine entsprechende Eingabeaufforderung, siehe auch Behandlung von JDBC-Referenzen. Andernfalls führt die Java-Applikation die Mapping-Transformation aus und generiert die Datei CompletePO.xml unter dem Ausgabepfad (in diesem Beispiel: C:\codegen\Java\CompletePO).
Schritt 5: Erstellen der JAR-Datei
Wenn Apache Ant mit Eclipse gebündelt ist, können Sie die JAR-Datei direkt von der Eclipse IDE aus erstellen. Um die JAR-Datei außerhalb von Eclipse über die Befehlszeile zu erstellen, muss Apache Ant separat installiert sein.
So erstellen Sie die .jar-Datei in Eclipse mit Ant:
1.Klicken Sie in der Package Explorer-Ansicht von Eclipse mit der rechten Maustaste auf die Datei build.xml und verweisen Sie auf das Menü Run as. Im "Run As"-Menü werden zwei Optionen für die Ausführung der Ant Build-Datei angezeigt. Wenn Sie die erste Option auswählen, startet Eclipse den Ant Build mit den Standardeinstellungen. Bei Auswahl der zweiten Option können Sie die Einstellungen des Ant Build vor dem Start ändern. Wählen Sie die zweite Option aus.
![cg_java_example_06](./images/cg_java_example_06.png)
2.Aktivieren Sie die Ziele, die im Ant Build inkludiert werden sollen, durch Anklicken. In diesem Beispiel sind die Ziele test und jar ausgewählt.
![cg_java_example_07](./images/cg_java_example_07.png)
3.Klicken Sie auf Run. Eclipse führt die Ant Build-Datei aus und zeigt das Ergebnis in der Konsolenansicht an.
So erstellen Sie die JAR-Datei über die Befehlszeile:
1.Stellen Sie sicher, dass das Verzeichnis, in dem Apache Ant installiert ist (z.B. C:\apache-ant-1.10.5\bin), zur PATH-Umgebungsvariablen hinzugefügt wurde.
2.Öffnen Sie ein Befehlszeilenfenster und ändern Sie das aktuelle Verzeichnis in das, in dem Sie Java-Code generiert haben (in diesem Beispiel C:\codegen\java\CompletePO). Dies ist auch das Verzeichnis, in dem die build.xml-Datei generiert wurde.
3.Geben Sie Folgendes in die Befehlszeile ein:
ant clean jar |
Daraufhin führt Ant die Ziele "clean" und "jar" aus der build.xml-Datei aus (einschließlich aller davon abhängigen Ziele) und zeigt das Ergebnis in der Befehlszeile an:
![cg_java_example_08](./images/cg_java_example_08.png)