Skip to content

Un template d'Application en Ligne de Commande (CLI) avec Java 23 et les JEP 458 et 477

Notifications You must be signed in to change notification settings

java-cli-apps/basic-java-23-quickstart

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Un template d'Application en Ligne de Commande (CLI) avec Java 23 et les JEP 458 et 477

Le template basic-java-23-quickstart permet de démarrer une nouvelle application en commande ligne avec Java sans utiliser aucun système de build (autre que make).

Ce template nécessite d'utiliser Java 23 ou une version supérieure car il utilise les JEPs suivantes :

  • La JEP 458 qui permet de lancer un programme Java dont le code est réparti dans plusieurs fichiers sources sans avoir besoin de les compiler préalablement
  • La JEP 477 qui permet de :
    • Se passer de déclaration de classe
    • Simplifier la déclaration de la méthode main
    • Utiliser les méthodes de la classe java.io.IO sans devoir les importer

Créer un dépôt depuis ce template

Pour créer un dépôt depuis ce template, on procédera comme suit :

Construire votre application

Après avoir créé le dépôt GitHub de votre nouvelle application à partir de ce template, vous pouvez suivre les étapes suivantes pour construire votre application.

Changer le nom de l'application

Pour changer le nom de l'application, initialement nommée BasicQuickstart, il faut modifier la variable APP_NAME dans le terminal ou dans le fichier .envrc, comme suit :

export APP_NAME=MyCmdLine

Lancer l'application localement

make test
./bin/Application.sh
Do you speak English (Y/N) ? N
Bonjour 🇫🇷

Construire le package de l'application

Le package de l'application comprend les sources ainsi que ses dépendances.

make package
mkdir --parents build/MyCmdLine/src build/MyCmdLine/lib build/MyCmdLine/bin
cp --update --recursive src lib bin build/MyCmdLine
cd build/MyCmdLine \
	&& mv src/Application.java src/MyCmdLine.java \
	&& mv bin/Application.sh bin/MyCmdLine.sh
cd build \
	&& zip --quiet --recurse-paths MyCmdLine.zip MyCmdLine

Shell de lancement

Le script de lancement Application.sh, dont le rôle est de lancer le fichier Application.java, est renommé lors de la construction du package en MyCmdLine.sh.

Cela permet d'ajouter plusieurs applications dans le PATH et donc d'invoquer directement MyCmdLine.sh.

Installer l'application

DEST_DIR=/home/user make install
unzip -q -d /home/user build/MyCmdLine.zip

Lancer l'application installée

DEST_DIR=/home/user make test-install
PATH=/home/user/MyCmdLine/bin:/usr/lib/jvm/jdk-23/bin:/home/fopy/.local/bin:... MyCmdLine.sh
Do you speak English (Y/N) ? N
Bonjour 🇫🇷

Il ne nous reste plus qu'à :

  • Implémenter notre métier dans Application.java
  • Ajouter les fichiers qui déclarent les classes utilisées par Application.java dans le répertoire src
  • Ajouter les jars de nos dépendances dans le répertoire lib

Autres templates

Si vous ne disposez pas de Java 23, vous pouvez utiliser le template basic-java-quickstart qui ne requiert que la version 11 de Java. Il est alors nécessaire que tout le code Java réside dans le même fichier comme décrit dans la JEP 330.

About

Un template d'Application en Ligne de Commande (CLI) avec Java 23 et les JEP 458 et 477

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Makefile 47.5%
  • Java 35.8%
  • Shell 16.7%