Manuelles Referenzieren von Java, C# und C++-Bibliotheken
In diesem Abschnitt wird erläutert, wie Sie benutzerdefinierte Bibliotheken in einer .mff-Datei (MapForce Function File) referenzieren. Die .mff-Datei, die die Referenz enthält, kann anschließend als MapForce-Bibliothek importiert werden. Eine .mff-Datei ist eine XML-Datei, in der Sie die Verknüpfungen zwischen Klassendefinitionen in Ihrem benutzerdefinierten Code und MapForce manuell definieren. Nach Erstellung einer benutzerdefinierten .mff-Datei können Sie diese ähnlich wie eine .NET DLL- oder Java class-Datei in MapForce importieren.
Achtung:
•Wenn Sie benutzerdefinierte NET-Funktionen in der integrierten Ausgabevorschau (im Fenster Ausgabe) verwenden möchten, müssen diese Funktionen für das .NET Framework 4.x oder :NET Standard 2.0 kompiliert werden.
•Sie können eine Funktion nur dann in MapForce importieren, wenn ihr Rückgabetyp und ihre Parameter den Typ simpleType haben. Eine Liste der verfügbaren Datentypen für die einzelnen Sprachen finden Sie unter Datentyp-Zuordnung.
•Wenn Sie Funktionsbibliotheken aus benutzerdefinierten .mff-Dateien importieren, Vorschau auf das Mapping direkt in MapForce (im Fenster Ausgabe) eingeschränkt. Bei in C++ geschriebenen Bibliotheken wird die Vorschau auf das Mapping in MapForce nicht unterstützt. Bei Java und C# steht die Vorschau zur Verfügung, wenn in Ihrer Bibliothek native Sprachtypen verwendet werden, nicht aber, wenn darin die von Altova generierte Klassen importiert wurden. Sie können jedoch Code in der Zielsprache der jeweiligen Bibliothek generieren. Die benutzerdefinierten Funktionen stehen im generierten Code zur Verfügung, sodass Sie das Mapping über den generierten Code ausführen können.
•Die genaue Reihenfolge, in der Funktionen vom generierten Mapping-Code aufgerufen werden, ist nicht definiert. MapForce kann die berechneten Ergebnisse zur Wiederverwendung im Cache aufbewahren oder Ausdrücke in jeder beliebigen Reihenfolge auswerten. Es wird daher empfohlen, nur benutzerdefinierte Funktionen zu verwenden, die keine unerwünschten anderen Auswirkungen haben.
•Es muss zwischen benutzerdefinierten Funktionen und benutzerdefinierten Funktionsbibliotheken unterschieden werden. Benutzerdefinierte Funktionen werden grafisch in einem Mapping erstellt und können und müssen nicht in einer .mff-Datei gespeichert werden, da sie zusammen mit der .mfd-Datei, in der sie erstellt wurden, gespeichert werden. Nähere Informationen dazu finden Sie unter Aufrufen und Importieren von benutzerdefinierten Funktionen.
•Wenn Sie ein Upgrade von einer MapForce-Version vor 2010 installieren, müssen Sie die in Ihren benutzerdefinierten Funktionen verwendeten Datentypen eventuell aktualisieren (siehe Datentyp-Zuordnung.)
Eine Anleitung zum Erstellen und Konfigurieren einer benutzerdefinierten .mff-Datei finden Sie unter Konfigurieren der MFF-Datei. Die Beispiele finden Sie in den folgenden Kapiteln:
•Referenzieren von C++ in .mff
•Referenzieren von Java in .mff