Méthode « System.getProperties »

Signature

public static Properties getProperties();

Description

Renvoie l'ensemble de toutes les « propriétés d'environnement Java » connues par la JVM.

Normalement un système d'exploitation défini des variables d'environnement : par exemple la variable d'environnement PATH que bon nombre d'entre vous doivent connaître. Le problème de ces variables d'environnement, c'est que leurs noms et leurs contenus sont dépendants du système d'exploitation considéré. Pour garantir la portabilité, entre différents systèmes d'exploitations, il est donc fortement recommandé de ne surtout pas les utiliser.

En lieu et place de ces variables d'environnement, Java SE propose la notion de « propriété d'environnement Java ». Il s'agit sensiblement de la même chose (les propriétés d'environnement Java sont, en partie, produites à partir des variables d'environnement), à la différence qu'elles sont spécifiées par la spécification Java SE et qu'elles sont donc existantes quelle que soit la JVM considérée.

Il est possible, au démarrage d'une JVM, de spécifier des propriétés d'environnement complémentaires. Pour ce faire, il faut ajouter une ou plusieurs options -DpropName=propValue. Par exemple, vous pouvez démarrer une JVM avec deux propriétés d'environnement Java supplémentaires (demo1 et demo2) comme le montre la ligne de commande suivante :

java -Ddemo1=value1 -Ddemo2=value2 MainClass

Voici la liste des principales propriétés d'environnement proposées par la JVM OpenJDK ainsi qu'une description de chaque entrée et de quelques exemples de valeurs pour certaines de ces propriétés. L'ensemble des propriétés d'environnement Java retenu dans cet exemple sera toujours existant, quelques soit la JVM (Java Virtual Machine) considérée.

Paramètres

Cette méthode n'accepte aucun paramètre.

Valeur de retour

La valeur de retour est de type Properties. L'ensemble des propriétés vous sera retourné dans un objet de la classe java.util.Properties. Techniquement, cette classe dérive de la classe java.util.Hashtable mais à été réadaptée pour tenir compte du fait que les clés et les valeurs de la collection seront forcément des chaînes de caractères.

Exception

SecurityException

Exemple de code

Voici un petit exemple de code affichant toutes les propriétés d'environnement connues de la JVM. Tentez de lancer ce programme avec ou sans options -D qui ajouteraient d'autres propriétés d'environnement.

 1 
 2 
 3 
 4 
 5 
 6 
 7 
 8 
 9 
 10 
 11 
 12 
 13 
 14 
 15 
 16 
 17 
 18 
 19 
 20 
 21 
 22 

import java.io.File;
import java.io.IOException;
import java.text.DateFormat;
import java.util.Date;
import java.util.Properties;

public class PropertiesSample {    
    
    public static void main(String[] args) {

        // On récupère toutes les propriétés d'environnement
        Properties properties = System.getProperties();
        
        // Pour chacune d'entre elle, et on affiche son nom et sa valeur 
        for( Object key : properties.keySet() ) {
            String value = System.getProperty( (String) key );
            System.out.printf( "%-30s == %s\n", key, value );
        }
    
    }
    
}

Disponible depuis

Voir aussi

Le tutoriel Java complet (Text+Vidéos)
Le tutoriel Java en vidéos

Evaluez vos compétences en Java