Altova MapForce 2025 Enterprise Edition

Une fois que vous avez installé MapForce, un exemple de projet client de MapForce API pour Java est disponible dans le répertoire C:\Users\<username>\Documents\Altova\MapForce2025\MapForceExamples\API.

 

Vous pouvez tester l’exemple de Java directement depuis la ligne de commande, utilisant le fichier de commandes BuildAndRun.bat, ou vous pouvez compiler et exécuter l’exemple de projet depuis l’intérieur d’Eclipse. Voir plus bas pour des instructions sur l’utilisation de ces procédures.

 

Liste de fichier

Le dossier d’exemples de Java contient toutes les fichiers requis pour exécuter l'exemple de projet. Ces fichiers sont recensés ci-dessous :

 

AltovaAutomation.dll

Java-COM bridge : DLL part

AltovaAutomation.jar

Java-COM bridge : Java library part

MapForceAPI.jar

Java classes of the MapForce API

RunMapForce.java

Code source de l’exemple Java

BuildAndRun.bat

Fichier de commandes pour compiler et exécuter un exemple de code depuis l’invite de la ligne de commande. Attend le dossier où Java Virtual Machine réside en tant que paramètre.

.classpath

Fichier d’assistance pour le projet Eclipse

.project        

Fichier de projet Eclipse

MapForceAPI_JavaDoc.zip

Le fichier Javadoc contenant une documentation d’aide pour Java API

 

Ce que fait l’exemple

L’exemple démarre MapForce et effectue quelques opérations, y compris ouvrir et fermer les documents. Quand il a terminé, MapForce reste ouvert. Vous devez le fermer manuellement.

 

Exécuter l’exemple depuis la ligne de commande

Pour exécuter l’exemple depuis la ligne de commande, ouvrez une fenêtre d’invite de commande, allez au dossier Java du dossier d’exemples API (voir ci-dessus pour l’emplacement), puis tapez :

 

 buildAndRun.bat "<Path-to-the-Java-bin-folder>"

 

Le dossier binaire de Java doit être celui d’un kit de développement de Java (JDK) 7 ou d’une installation ultérieure sur votre ordinateur.

 

Appuyez sur la clé Retour. La source de Java dans RunMapForce.java sera compilée, puis exécutée.

 

Charger l’exemple dans Eclipse

Ouvrez Eclipse et utilisez la commande Fichier | Importer... Commande | Général | Projets existants dans flux de travail pour ajouter un fichier de projet Eclipse (.project) situé dans le dossier Java du dossier d’exemples API (voir au-dessus pour l’emplacement). Le projet RunMapForce apparaîtra ensuite dans votre Package Explorer ou Navigator.

 

Sélectionnez le projet, puis la commande Run as | Java Application pour exécuter l’exemple.

 

Note :Vous pouvez sélectionner un nom de classe ou de méthode de l’API de Java et appuyez sur F1 pour recevoir de l’aide pour cette classe ou méthode.

 

Liste de code source de Java

Le code source de Java dans l’exemple de fichier RunMapForce.java iest recensé ci-dessous avec des commentaires.

 

// access general JAVA-COM bridge classes
import java.util.Iterator;
 
import com.altova.automation.libs.*;
 
// access XMLSpy Java-COM bridge
import com.altova.automation.MapForce.*;
import com.altova.automation.MapForce.Enums.ENUMProgrammingLanguage;
 
/**
* Un exemple simple qui démarre le serveur COM et réalise quelques opérations sur celui-ci.
* N’hésitez pas à élargir.
*/
public class RunMapForce
{
public static void main(String[] args)
{
// une instance de l’application.
Application mapforce = null;
 
// au lieu d’utiliser la gestion d’erreur COM, utilisez le mécanisme d’exception de Java.
try
{
// Démarrez MapForce en tant que serveur COM.
mapforce = new Application();
// les serveurs COM démarrent de manière invisible, donc nous les rendons visibles
mapforce.setVisible(true);
 
// Les lignes suivantes se joignent aux événements de l’application en utilisant une mise en œuvre par défaut
// pour les événements et écrase l’une de ses méthodes.
// Si vous souhaitez écraser tous les événements de document, il est plus judicieux de dériver votre classe d’écoute
// de DocumentEvents et met en œuvre toutes les méthodes de cette interface.
mapforce.addListener(new ApplicationEventsDefaultHandler()
{
@Override
public void onDocumentOpened(Document i_ipDoc) throws AutomationException
{
String name = i_ipDoc.getName();
 
if (name.length() > 0)
System.out.println("Document " + name + " was opened.");
else
System.out.println("A new mapping was created.");
}
});
 
// Localisez des exemples installés avec le produit.
int majorVersionYear = mapforce.getMajorVersion() + 1998;
String strExamplesFolder = System.getenv("USERPROFILE") + "\\Documents\\Altova\\MapForce" + Integer.toString(majorVersionYear) + "\\MapForceExamples\\";
// créez un nouveau mappage MapForce et générez le code c++
Document newDoc = mapforce.newMapping();
ErrorMarkers err1 = newDoc.generateCodeEx(ENUMProgrammingLanguage.eCpp);
afficher(err1);
// ouvrez CompletePO.mfd et générez le code c++
Document doc = mapforce.openDocument(strExamplesFolder + "CompletePO.mfd");
ErrorMarkers err2 = doc.generateCodeEx(ENUMProgrammingLanguage.eCpp);
afficher(err2);
 
doc.close();
doc = null;
 
System.out.println("Watch MapForce!");
}
catch (AutomationException e)
{
// e.printStackTrace();
}
finally
{
// Assurez-vous que MapForce peut être arrêté correctement.
if (mapforce != null)
mapforce.dispose();
 
// Puisque le serveur COM a été rendu visible et l’est encore, il poursuivra son exécution
// et devra être arrêté manuellement.
System.out.println("Now close MapForce!");
}
}
 
public static void display(ErrorMarkers err) throws AutomationException
{
Iterator<ErrorMarker> itr = err.iterator();
 
if (err.getCount() == 0)
System.out.print("Code generation completed successfully.\n");
 
while (itr.hasNext())
{
String sError = "";
Object element = itr.next();
if (element instanceof ErrorMarker)
sError = ((ErrorMarker)element).getText();
System.out.print("Error text: " + sError + "\n");
}
}
}

© 2018-2024 Altova GmbH