Java EE / Spring

Il faudra déterminer quelle est l'architecture de notre poste de travail. Windows, Linux, Mac OS ? Système 32 bits ou 64 bits ?

$ uname -a
Darwin webpulser-mbp.local 11.4.2 Darwin Kernel Version 11.4.2: Thu Aug 23 16:25:48 
PDT 2012; root:xnu-1699.32.7~1/RELEASE_X86_64 x86_64

Dans mon cas un mac équipé d'un processeur intel (x86) et 64 bits. La version 11.4.2 du noyau me permet de dire, après une petite recherche, qu'il s'agit de Mac OS X Lion. "A propos de ce mac" aurait aussi pu m'aider. Sous windows appuyer sur [Win]+[Pause] pour ouvrir les propriétés du poste de travail.

Il faudra idéalement ajouter le chemin des binaires java dans la variable d'environnement "PATH" du système. Modifiez le PATH.

Le PATH est une liste de dossiers parcourus par le système pour trouver les commandes exécutables appelées sans en préciser le chemin complet. Lorsque vous tapez "java" dans l'invite de commande, le système va rechercher dans chacun des dossiers, dans l'ordre où ils sont définis, un fichier exécutable portant ce nom. Si un tel programme est trouvé il est lancé, sinon vous aurez une erreur du type "java: command not found."
Il est aussi possible d'appeler un programme en précisant son chemin complet. Si vous taper "/opt/jdk1.8.0_11/bin/java -version" c'est ce programme en particulier qui sera appelé (en supposant qu'il existe).

Le PATH est une chaîne de caractère regroupant l'ensemble des dossiers de recherche, séparés par un ':' sous linux/osx et par ';' sous windows.
Pour modifier ce PATH.
Imaginons que j'utilise linux et que j'ai décompressé l'archive dans /opt, cela a du créer un répertoire jdk1.8.0_11.

$ echo 'export PATH="/opt/jdk1.8.0_11/bin:$PATH"' >> ~/.bashrc
$ . ~/.bashrc

Le fichier .bashrc contenu dans votre répertoire utilisateur est exécuté à chaque fois qu'un shell de type bash est lancé.

Sous mac l'installation du package va se faire dans '/Library/Java/JavaVirtualMachines/jdk1.8.0_11.jdk/Contents/Home/'. Le fichier à modifier pour le PATH est '.bash_profile' dans le HOME.

$ echo 'export PATH="/Library/Java/JavaVirtualMachines/jdk1.8.0_11.jdk/Contents/Home/bin:$PATH"' >> ~/.bash_profile
$ . ~/.bash_profile

Pour compiler un fichier il faut utiliser la commande "javac" suivi du source à compiler. La compilation transforme votre code source texte en une suite d'instructions et de données interprétable par la machine virtuelle java. Ces fichiers compilés seront interprétables quel que soit le système d'exploitation utilisé: "Compile Once, Run Everywhere" (ou presque).

Sans option, cette commande créera des fichiers compilés à l'endroit où vous avez exécuté la commande. Voici une petite liste d'options à connaitre :
-d suivi d'un répertoire permet d'indiquer où les ".class" doivent être créés.
-sourcepath indique l'endroit où rechercher les fichiers sources de l'utilisateur. Lorsque votre compilateur rencontre dans le source une classe qu'il ne connait pas, il essaiera de la rechercher et de la compiler depuis cet endroit
-source permet de s'assurer de la compatibilité des sources java pour une version minimale d'un compilateur. Il peut être en effet pratique d'utiliser cette option si vous possédez une version 1.8 alors que vos collègues utilisent la version 1.7 (et doivent recompiler vos sources)
-target permet de compiler du bytecode qui peut être lu et interprété par une JVM de cette version. La plupart des nouveautés syntaxiques peuvent être compilées vers des versions de JVM inférieures. Les nouvelles versions du compilateur introduisent par contre des optimisations et une forme encodée des classes qui peuvent être différentes.
-cp permet de définir le CLASSPATH, c'est à dire la liste des répertoires et des jar contenant les classes nécessaires à la compilation de vos sources.

Pour exécuter votre programme il faut utiliser la commande "java" suivi d'une classe contenant une méthode "main" (sans l'extension .class). C'est le point d'entrée de notre programme java. La signature de cette méthode doit être :
public static void main(String[] args)
Les arguments passés à votre ligne de commande se retrouvent dans le tableau "args" (dont vous pouvez changer le nom évidemment).

Généralement, nous utilisons des "librairies" dont il faudra indiquer le chemin à la JVM pour que les classes auxquelles vous faîtes référence dans votre programme puissent fonctionner. De nombreuses librairies sont chargées de base par la JVM tel que "rt.jar" contenant la définition de java.lang.Integer (et de la plupart des classes fournies avec la JVM).
Les fichiers jar ne sont que des archives "zip" dans lesquelles nous avons rangé nos classes et un fichier META-INF/MANIFEST.MF décrivant éventuellement des informations complémentaires sur le compilateur ou autre ...

Lorsqu'une classe est référencée par une autre, la JVM va en rechercher le code dans les librairies et les dossiers dont vous avez fourni la liste. C'est cette liste que l'on nomme le CLASSPATH, à ne pas confondre avec la variable d'environnement PATH.
Le CLASSPATH se définit à la compilation ou à l'exécution par l'option -cp suivi d'une chaîne de caractère reprenant tous les dossiers et librairies dans lesquels la JVM ira chercher après les classes. Chaque dossier ou librairie sera séparé par un ":" sous mac et linux ou par un ";" sous windows.
Sans cette option la JVM ne recherche que dans le répertoire courant (celui dans lequel vous êtes en lançant java).

Vous avez peut être déjà remarqué qu'il est possible d'exécuter des fichiers jar ?
Quand vous double-cliquez dessus dans votre explorateur de fichier, par exemple...
Lorsque vous le faîtes, la commande java -jar fichier.jar est en fait exécuter.
-jar indique à la JVM de rechercher dans ce jar après la classes principale à lancer. Cette recherche se fait dans le fichier MANIFEST dans lequel une "MainClass" doit être indiquée.

Il peut être utile de définir ou re-définir une variable d'environnement pour un programme java en particulier.
-D permet de définir une variable. la syntaxe est : -DmaVariable=maValeur.
C'est une manière de passer un paramètre optionnel à un programme java.