Skip to the content.

Utilisation de Maven Lite et description de toutes les fonctionnalités

Table des matières

Liste des options

Utilisation de base

Ligne de commande

La ligne de commande est la méthode classique pour utiliser Maven Lite bien qu’elle soit moins pratique que l’utilisation d’un fichier de configuration.

Vous pouvez mettre autant d’options que vous le souhaitez et dans n’importe quel ordre.

il faut juste mettre les arguments avec des espaces entre guillemets, par exemple -args "mon argument". sous windows il est impossible de mettre le caratère " dans les arguments.

Exemple de ligne de commande

Fichier de configuration

L’utilisation d’un fichier de configuration se fait avec l’option --file ou -f.

Le fichier de configuration est un fichier unique à chaque projet qui permet de configurer les options que Maven Lite devra utiliser.

Le nom par défaut du fichier de configuration est LPOM.conf et doit être à la racine du projet. Il est possible de le renommer mais dans ce cas il faudra préciser son nom l’ors de l’utilisation de l’option, par exemple mvnl -f monFichier.extention.

si vous voulez ajouté votre CLASSPATH système au CLASSPATH de Maven Lite dans le fichier de configuration, il faut utiliser le terme $CLASSPATH en majuscule.

Il est possible de mettre autant d’options que vous le souhaitez et dans n’importe quel ordre.

Exemple de fichier de configuration

Création d’un projet

L’utilisation d’un fichier de configuration se fait avec l’option --create ou -cr.

Il est impossible de créer un projet avec un espace dans le nom. Il est impossible de créer un projet avec un nom qui est déjà utilisé par un fichier ou un dossier.

Vous pouvez créer un projet dans le dossier courant grâce à la commande suivante :

mvnl --create ./

Par défaut, le nom du projet est NewProject et l’arborescence est la suivante

NewProject
├── LPOM.conf
├── src
│   ├── main
│   │   └── java
│   │       └── HelloWorld.java
│   └── resources
│       └── lib
└── target

Modèle Vue Contrôleur

L’utilisation de cette option se fait avec l’option --model-view-controller ou -mvc.

Permet de spécifier à l’option create de créer l’arborescence d’un projet MVC.

Compilation d’un projet

L’utilisation de cette option se fait avec l’option --compilation ou -c ou --compile-launch ou -cl ou --launch-compile ou -lc.

Cette option permet de compiler le projet.

Lancement d’un projet

L’utilisation de cette option se fait avec l’option --launch ou -l ou --compile-launch ou -cl ou --launch-compile ou -lc.

Cette option permet de lancer le projet.

Silencieux

L’utilisation de cette option se fait avec l’option --quiet ou -q.

Cette option permet de supprimer l’affichage de java dans le terminal lors de l’exécution du projet.

Verbeuse

L’utilisation de cette option se fait avec l’option --verbose ou -v.

Cette option permet d’afficher les commandes Java exécutées par Maven Lite.

Exclusion de fichiers et de dossiers

L’utilisation de cette option se fait avec l’option --exclude ou -ex.

Cette option permet d’exclure des fichiers java et des dossiers de la compilation.

Si vous voulez exclure un dossier, il faut mettre le chemin relatif du dossier à partir du dossier source du projet et sans utiliser ./ ou ../.

Si vous excluez un dossier, tous les fichiers et dossiers qu’il contient seront aussi exclus.

Attention, si vous excluez le dossier test, tout les fichiers ou dossiers qui contiennent le mot test dans leur nom seront aussi exclus.

Compilation en fichier jar

L’utilisation de cette option se fait avec l’option --compile-jar ou -cj.

Cette option permet de créer un fichier jar exécutable de votre projet.

Les conventions de nommage des fichiers jar sont les suivantes : <nom>-<M>.<m>.<b>.jar.

Lancement d’un fichier jar

L’utilisation de cette option se fait avec l’option --launch-jar ou -lj.

Cette option permet de lancer le fichier jar exécutable de votre projet.

Intégration des tests unitaires

L’utilisation de cette option se fait avec l’option --integrate-test ou -it.

Cette option permet d’intégrer les tests unitaires au projet, c’est à dire de créer l’arborescence des tests unitaires ainsi que les fichiers de test unitaire et copie également les fichiers jar utilisés par JUnit dans le dossier des librairies.

Si vous l’utilisez en même temps que l’option -cr ou --create, Maven Lite créera l’arborescence des tests unitaires ainsi qu’un fichier de test par défaut qui contient un test unitaire de la classe principale.

Si vous l’utilisez après avoir créé le projet, Maven Lite créera l’arborescence des tests unitaires ainsi qu’un fichier de test unitaire pour chaque fichier java du projet.

Source du projet

L’utilisation de cette option se fait avec l’option --source ou -s.

Cette option permet de spécifier le dossier contenant les fichiers java à compiler.

Le dossier source n’est pas la racine du projet mais le premier dossier contenant les fichiers java à compiler. Les fichiers java qui sont dans se dossier n’ont pas de package.

Destination des fichiers compilés

L’utilisation de cette option se fait avec l’option --target ou -t.

Cette option permet de spécifier le dossier de sortie des fichiers compilés, le dossier d’entrée des fichiers à lancer, le dossier de sortie des fichiers jar ainsi que le dossier d’entrée des fichiers .class à mettre dans le jar.

Vous n’avez pas besoin de créer le dossier de sortie des fichiers compilés, Maven Lite le fera pour vous.

Vous n’avez pas besoin d’ajouter le dossier de sortie des fichiers compilés au classpath, Maven Lite le fera pour vous.

Ressources

L’utilisation de cette option se fait avec l’option --resources ou -r.

Cette option permet de spécifier le dossier contenant les fichiers ressources à copier dans le dossier de sortie des fichiers compilés lors de la création d’un fichier jar.

Classpath

L’utilisation de cette option se fait avec l’option --classpath ou -cp.

Cette option permet de spécifier le classpath à utiliser lors de la compilation et du lancement.

Vous pouvez ajouter le classpath système en utilisant le terme $CLASSPATH en majuscule dans le fichier de configuration.

Dans la ligne de commande, vous pouvez utiliser le classpath système en utilisant le terme $CLASSPATH sous Linux et Macos. Sous Windows, vous pouvez utiliser le terme %CLASSPATH%.

Libraries

L’utilisation de cette option se fait avec l’option --libraries ou -lib.

Cette option permet de spécifier le dossier contenant les fichiers jar utiliser par le programme. Tout les fichiers jar seront ajoutés au classpath lors de la compilation et du lancement.

Vous pouvez créer des sous-dossiers dans le dossier des librairies pour mieux organiser vos fichiers jar, Maven Lite les prendra en compte.

Arguments

L’utilisation de cette option se fait avec l’option --arguments ou -args.

Cette option permet de spécifier tous les arguments à passer à la classe principale de votre projet.

Ces arguments seront passés à la classe principale dans l’ordre où ils sont passés à Maven Lite.

Attention, sous Windows, il est impossible de mettre le caractère " dans les arguments passés dans la ligne de commande, il devra donc être passé dans le fichier de configuration.

Exemple d’utilisation de l’option Arguments

Arguments dans la ligne de commande

Ligne de commande sous linux et Macos

Ligne de commande sous windows

// TODO : vérifier que les caractères spéciaux fonctionnent sous windows

Arguments dans le fichier de configuration

// TODO : vérifier les caractères spéciaux

Class main

L’utilisation de cette option se fait avec l’option --main ou -m.

Cette option permet de spécifier la classe principale à lancer avec le package sous la forme package.MainClass. Cette option est utile uniquement si vous avez plusieurs classes main dans votre projet, si se n’est pas le cas, Maven Lite trouvera et utilisera automatiquement la classe main du projet.

Encodage

L’utilisation de cette option se fait avec l’option --encoding ou -e.

Cette option permet de spécifier l’encodage des fichiers java à compiler.

Exportation

L’utilisation de cette option se fait avec l’option --export ou -exp.

Cette option permet de créer un fichier .class exécutable paramétrer pour votre projet permettant de compiler et lancer votre projet sans avoir installer MavenLite.

Les seuls options qu’accepte le fichier .class sont les options de la class main, --arguments, -args, les options de lancement et de compilation, --launch, -l, --compile, -c, --compile-launch, -cl, --launch-compile, -lc et l’option du fichier de config --file, -f et c’est tout. Les autres options ne seront pas prises en compte.

Il est important d’utiliser le fichier de configuration lors de l’utilisation de l’option --export ou -exp car il permet de spécifier les paramètres qu’utilisera le fichier .class exécutable.

Le but de cette option est de pouvoir lancer votre projet via le lancement d’un seul fichier sans argument et sans avoir à installer Maven Lite. Cela permet notamment de permettre à des personnes qui n’ont pas Maven Lite d’utiliser votre projet.

Transformation en projet Maven

L’utilisation de cette option se fait avec l’option --maven ou -mvn.

Cette option permet de convertir votre projet en projet Maven en créant un fichier pom.xml et en déplaçant les fichiers si nécessaire.

Langue

L’utilisation de cette option se fait avec l’option -lang ou --language.

Cette option permet d’afficher les langues disponibles pour Maven Lite si elle est utilisée seule.

Si vous utilisez cette option avec une langue, Maven Lite utilisera cette langue pour afficher les messages.

Cette option est persistante, c’est à dire que si vous l’utilisez une fois, Maven Lite utilisera cette langue pour afficher les messages tant que vous ne changez pas la langue.

Version

L’utilisation de cette option se fait avec l’option --version ou -V.

Cette option permet d’afficher la version de Maven Lite ainsi que la localisation du fichier principale de Maven Lite, la version de java, le type de build, le runtime java utilisé, la langue utilisée par le système, la plateforme d’encodage utilisée par Maven Lite, le nom du système d’exploitation, la version du noyaux du système d’exploitation et l’architecture du système.

Aide

L’utilisation de cette option se fait avec l’option --help ou -h.

Cette option permet d’afficher la liste des options ainsi que leur description, le nombre d’arguments qu’elles prennent et leur valeur par défaut si elle en ont une ainsi que le lien vers la documentation.

Supprimer les fichiers compilés

L’utilisation de cette option se fait avec l’option --clear ou -clr.

Cette option permet de supprimer tous les fichiers dans le dossier de sortie des fichiers compilés. Cette option permet de libérer de l’espace disque, ainsi que de faire un un fichier jar propre.

Exemple, fonctionnaliés et limites