<oXygen/> User Guide |
Les processeurs Xalan et Saxon supportent tous les deux l'usage d'élements d'extension et de fonctions d'extension. Contrairement à un élément de résultat littéral, auquel la feuille de style transfert simplement l'arbre résultat, un élément extension exécute une action. L'extension est habituellement utilisée car la feuille de style xslt échoue à proposer des fonctions adéquates à l'utilisateur pour accomplir une tâche plus complexe.
Exemples sur comment utiliser les extensions peut être trouvé ici :
http://xml.apache.org/xalan-j/extensions.html
http://saxon.sourceforge.net/saxon6.5.2/extensions.html
Les choses suivantes doivent être faites dans l'ordre afin que le transformateur puisse trouver et utiliser avec succès les classes de l'extension Java :
Régler la propriété "com.oxygenxml.additional.classpath" afin qu'elle contienne les chemins additionnels vers les répertoires contenant les classes ou jars de l'extension Java utilisée.
Exemple de réglage pour deux répertoires appelés "test1" et "test2" situés dans le répertoire racine de <oXygen/> comme chemins de l'extension (contenant les classes ou jars de l'extension) :
Pour les personnes qui utilisent un script ( bat ou sh ) pour lancer <oXygen/>, ajoutez le paramètre suivant "-Dcom.oxygenxml.additional.classpath=test1;test2" à la ligne de commande java dans votre fichier de script (oxygen.bat ou oxygen.sh). Exemple : "java -Xmx256m -Dcom.oxygenxml.additional.classpath=test1;test2; -cp %CP% ro.sync.exml.Oxygen %1 %2 %3 %4 %5" .
Pour les personnes qui utilisent un exécutable ( exe ) pour lancer <oXygen/>, ajoutez le paramètre suivant "com.oxygenxml.additional.classpath=test1;test2" dans le fichier "oxygen.lax" situé dans le répertoire racine de <oXygen/>.
Après que le paramètre est réglé, les classes et jars Java des chemins de l'extension sont dynamiquement chargés et peuvent être utilisés par les processeurs de transformation sans aucun réglage supplémentaire.