Exemple : Référencer Java dans .mff
Cet exemple vous montre comment créer une bibliothèque Java library d'échantillon et la référencer à un fichier MapForce Function (.mff). Le fichier .mff peut ensuite être importé en tant que bibliothèque MapForce. Référencer une bibliothèque Java dans un fichier .mff ne constitue qu'un des moyens pour importer des bibliothèques Java dans MapForce. Une alternative plus simple est d'importer des fichiers de .class Java directement. Pour plus d'informations, voir Exemple : Importer une classe Java personnalisée.
Étapes de configuration
Pour référencer une bibliothèque C# dans un fichier .mff, suivez les instructions ci-dessous.
Étape 1. Créer un nouveau projet
Créer un nouveau projet Java dans votre environnement de développement de prédilection (par exemple, Eclipse).
Étape 2. Ajouter le package com.mylib
Ajouter au projet un nouveau package appelé mylib qui consiste en une classe appelée Greetings. Dans l'extrait de code ci-dessous, veuillez noter que la fonction SayHello a été définie en tant que public static.
package com.mylib;
public class Greetings {
public static String SayHello ( boolean isMorning ) {
if( isMorning )
return "Good Morning!";
return "Good Day!";
}
}
Étape 3. Importer les com.altova.types
En option, si votre projet nécessite une prise en charge pour des types de schéma spéciaux comme, par exemple, la date, l'heure et la durée, importer le package com.altova.types. Pour obtenir ce package, générer du code Java depuis un mappage sans fonctions personnalisées : importer com.altova.types.*;.
Étape 4. Compilez votre bibliothèque personnalisée
Compilez votre bibliothèque personnalisée dans un fichier de classe et l'ajouter au classpath Java.
Étape 5. Créez un .mff et référencez votre bibliothèque Java library
En utilisant un éditeur XML, créer un nouveau fichier .mff et valider le par rapport au schéma suivant : C:\Program Files\MapForceLibraries\mff.xsd. Veuillez vous assurer que toutes les références sous implementation language="java" pointent vers les membres Java corrects créés précédemment. Aussi, la ligne function name="SayHello" doit référer au nom de la fonction exactement tel qu'il a été défini dans Java. Pour les plus détails, voir Configurer le fichier .mff.
<?xml version="1.0" encoding="UTF-8"?>
<mapping version="9" library="custom" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="mff.xsd">
<implementations>
<implementation language="java">
<setting name="package" value="com.mylib"/>
<setting name="class" value="Greetings"/>
</implementation>
</implementations>
<group name="greetings">
<component name="sayhello">
<sources>
<datapoint name="ismorning" type="xs:boolean"/>
</sources>
<targets>
<datapoint name="result" type="xs:string"/>
</targets>
<implementations>
<implementation language="java">
<function name="SayHello"/>
</implementation>
</implementations>
<description>
<short>result = sayhello(ismorning)</short>
<long>Returns "Good morning" or "Good day", depending on the input parameter.</long>
</description>
</component>
</group>
</mapping>
Étape 6. Importer le fichier .mff en tant que bibliothèque
Maintenant que notre bibliothèque personnalisée est référencée dans le fichier .mff, vous pouvez importer le fichier .mff dans MapForce en tant que bibliothèque. Pour plus d’information, voir Importer les Bibliothèques .mff.