Vous pouvez exécuter des révisions de code sur des fichiers source Java à partir d'une ligne de
commande d'un plan de travail "sans interface" (sans interface utilisateur pour l'environnement de développement).
Cela peut être très utile si vous souhaitez régulièrement
exécuter des révisions de code sans surveillance ou les insérer dans un script Ant.
Une interface de ligne de commande permet de préciser votre espace de travail et tous les paramètres
facultatifs. La ligne de commande lance un environnement sans interface Eclipse avec uniquement les fonctions de base afin
d'exécuter des révisions de code, et sans les fonctions de l'interface utilisateur. Par défaut,
il exécute une révision de code sur le code source de l'espace de travail en utilisant soit les règles
de la révision de code rapide, soit celles qui ont été spécifiées dans l'interface utilisateur lors de la dernière
révision de code.
Avant d'exécuter les révisions de code en mode sans interface, vous devez détenir un espace de travail contenant un projet
avec des fichiers source Java. Il est inutile de lancer l'environnement de développement.
Remarque : En raison des limitations
du système d'exploitation Windows, la longueur de la chaîne utilisée pour exécuter le mode ligne de commande
(C:\path\java.exe …) doit être aussi courte que possible. Sinon, le système risque de couper et de perdre les
paramètres placés à la fin de la chaîne. Il est conseillé aux utilisateurs de Windows d'utiliser les meilleures
pratiques suivantes pour obtenir des résultats optimaux :
- La variable PATH doit contenir autant de chemins d'accès que possible (le chemin d'accès Java et celui des
fichiers JAR, par exemple).
- Le chemin d'accès à l'espace de travail doit être aussi court que possible (C:\workspace, par exemple).
- Le chemin d'accès à l'emplacement dans lequel sont générés les rapports doit également être aussi court que
possible (C:\report, par exemple).
Vous ne pouvez pas exécuter simultanément plusieurs
révision de code en mode sans interface sur le même espace de travail, ni utiliser le mode sans interface
lorsqu'une interface utilisateur graphique Eclipse a verrouillé l'espace de travail.
Exemple
La ligne de commande ci-dessous exécute une révision de code sous Windows à partir
de l'espace de travail D:\workspace. Un rapport HTML est généré dans D:\workspace\report.
D:\eclipse\jre\bin\java -Xj9 -Dorg.eclipse.swt.browser.internal.flash
-Dorg.eclipse.emf.ecore.EPackage.Registry.INSTANCE=org.eclipse.emf.ecore.impl.EPackageRegistryImpl
-cp D:\eclipse\startup.jar org.eclipse.core.launcher.Main -application com.ibm.r2a.command.line.mode.CommandLineModeApplication
-plugincustomization <pluginCustomizationPath> -data <rép_espace_travail -reportDirectory
D:\workspace\report -onlyClient CodeReview
Remarque : Vous pouvez ajouter des paramètres aux commandes de cet exemple pour l'exécuter,
selon la configuration de votre système d'exploitation. Les paramètres se trouvent dans les détails de configuration du système,
sous "Propriétés du système" de
..