Outils java

Programmer en java

Les outils du JDK

man javac

Classpath

Variables d'environnement

JAVA_HOME : C:\Program Files\Java\jdk1.8.0_112
JDK_HOME  : %JAVA_HOME%
JRE_HOME  : %JAVA_HOME%\jre
CLASSPATH : .;%JAVA_HOME%\lib;%JAVA_HOME%\jre\lib
PATH      : your-unique-entries;%JAVA_HOME%\bin

JAVA_HOME : /usr/lib/jvm/java-11-openjdk-amd64
JDK_HOME  : $JAVA_HOME
JRE_HOME  : $JAVA_HOME/jre
CLASSPATH : .:$JAVA_HOME/lib:$JAVA_HOME/jre/lib
PATH      : your-unique-entries:$JAVA_HOME/bin

Compilation - javac

projet
    ├── bin
    └── src
        └── projet
            ├── package1
            │   └── Class1.java
            ├── package2
            │   └── Class2.java
            └── Projet.java

javac -sourcepath src/ -d bin/ src/projet/Projet.java

javac -sourcepath src/ -classpath /path/to/lib1/bin:/path/to/lib2.jar -d bin/ src/projet/Projet.java

Exécution - java

• Exécution d'un fichier .class

  java [options] classname [args]

  Noter qu'on spécifie le nom de la classe, pas le nom du fichier.
  Pour exécuter l'exemple pécédent :

  java -cp bin/ projet.Projet

• Exécution d'un fichier .jar

  java [options] -jar filename [args]

java HelloWorld.java

Documentation - javadoc

Documenter une classe, une interface

/** 
    Une phrase d'introduction, qui apparaitra dans les pages de résumé.
    Une description plus précise de la classe, qui peut s'étaler sur plusieurs lignes.
    @author Auteur 1
    @author Auteur 2
    @version 2017-01-02
*/
public class MyClass{
    ...
}

Documenter une méthode

public class MyClass{
    
    /**
        Une phrase de résumé.
        Une description plus précise de la méthode, qui peut s'étaler sur plusieurs lignes.
        
        @param  param1  Description du premier paramètre
        @param  param2  Description du second paramètre
        
        @return Description du retour de la méthode
        
        @throws IllegalArgumentException    Description de l'exception
        @throws IOException                 Description de l'exception
        
        @see    java.util.List
    */
    public static int method1(int param1, String param2) throws IllegalArgumentException, IOException{
        
    }
}

Liens entre les pages, inline doc-comment tags

    @param regexp   The regular expression to search for. This string
                    argument must follow the syntax rules described for
                    {@link java.util.regex.Pattern}.

• package name :
  @see java.lang.reflect
• pkgname.typename :
  @see java.util.List
@see List (nom résolu par javadoc de la même manière que javac).
• typename#methodname
  @see java.io.InputStream#reset
@see InputStream#close
• typename
  @see List
• typename#methodname ( paramtypes )
  @see InputStream#read(byte[], int, int)
.... {@link InputStream#read(byte[], int, int)} ...
• #methodname
  @see #setBackgroundColor A utiliser pour des liens internes à la classe (mais permet aussi de référencer vers les super classes ou interfaces, ou les classes contenantes).
#methodname(paramtypes)
@see #setPosition(int, int)
• typename#fieldname
  @see java.io.BufferedInputStream#buf
• #fieldname
  @see #x

appli
    ├── overview.html
    ├── package1
    │   ├── doc-files
    │   │   └── image1.jpg
    │   └── package.html
    └── package2
        └── package.html

Tests - jshell

jshell -v

|  Welcome to JShell -- Version 10.0.2
|  For an introduction type: /help intro

jshell> 

/set feedback normal

Imports par défaut

jshell> /import
|    import java.io.*
|    import java.math.*
|    import java.net.*
|    import java.nio.file.*
|    import java.util.*
|    import java.util.concurrent.*
|    import java.util.function.*
|    import java.util.prefs.*
|    import java.util.regex.*
|    import java.util.stream.*

jshell> import java.lang.reflect.*

Expressions

jshell> 1+1
$1 ==> 2
|  created scratch variable $1 : int

jshell> 1+1.0
$2 ==> 2.0
|  created scratch variable $2 : double

jshell> 1/2
$4 ==> 0
|  created scratch variable $4 : int

jshell> 1/2.0
$5 ==> 0.5
|  created scratch variable $5 : double

jshell> 1.0/2
$6 ==> 0.5
|  created scratch variable $6 : double

jshell> 1.0f/2
$7 ==> 0.5
|  created scratch variable $7 : float

jshell> Math.PI
$3 ==> 3.141592653589793
|  created scratch variable $3 : double

Variables

jshell> int x = 5
x ==> 5
|  created variable x : int

jshell> x
x ==> 5
|  value of x : int

Méthodes

jshell> void hello(){System.out.println("hello");}
|  created method hello()

jshell> hello()
hello

jshell> int add4(int nb){
   ...> return nb + 4;
   ...> }
|  created method add4(int)

jshell> add4(5)
$17 ==> 9
|  created scratch variable $17 : int

Commandes

jshell> /help