Command vous permet de lancer une commande (target Ant, goal Maven,...) à partir d'un wizard page pour construire/générer un projet (WEB, Struts,...). Une commande est définie dans l'élement output d'un XML component et peut lancer par exemple une target d'un fichier Ant build.xml.
Les valeurs des contrôles XUL du wizard page peuvent être utilisées dans les propriétés utilisées dans la commande.
L'élement XML command défini dans l'élement output d'un XML component permet de décrire la commande à lancer. L'exemple suivant permet de lancer la commande (target pour Ant) name_of_myCommand définit dans le fichier de configuration path_of_myCommandConfig :
<?xml version="1.0" encoding="UTF-8"?> <component> ... <output> <command type="ant" uri="path_of_myCommandConfig" name="name_of_myCommand" /> ... </output> ... </component>
Nom attribut | Description | Obligatoire ? |
type | Type du moteur de commande (Ant, Maven,...). Par défaut type="ant" est utilisé. | Non |
uri | URI du fichier de configuration des commandes à utiliser. Pour Ant, uri correspond au fichier build.xml | Non |
path | Chemin fichier de configuration des commandes à utiliser. Voir section path. | Non |
name | Nom de la commande à lancer. Pour Ant, name correspond à la target à lancer. | Oui |
condition | Appel d'une fonction javascript qui retourne true si la commande doit être executée et false sinon. | Non |
La déclaration d'une commande (utilisé dans la section output d'un XML component) qui doit lancer la commande name_of_myCommand définie dans le fichier de configuration path_of_myCommandConfig s'effectue à l'aide de l'élement command :
... <command uri="path_of_myCommandConfig" name="name_of_myCommand" /> ...
path_of_myCommandConfig est le chemin du fichier de configuration command à utiliser, plus exactement l'uri du fichier. Toutes les commandes doivent être contenues dans le répertoire Commands du catalogue. L'uri de command doit démarrer de ce répertoire.
... <command type="ant" uri="/ant/build.xml" name="myTarget" /> ...
signifie qu'il y a un fichier /ant/build.xml stocké dans le répertoire Commands du catalogue. La target Ant à lancer est myTarget.
Vous pouvez aussi utiliser path pour référencer le fichier ant/build.xml :
... <command type="ant" path="catalog:/Commands/ant/build.xml" name="myTarget" /> ...
Les moteurs de commande sont acccéssibles à l'aide d'un descripteur Spring. Akrogen implémente par défaut les moteurs de commande :