8.4 Systemeigenschaften der Java-Umgebung 

Die Java-Umgebung verwaltet Systemeigenschaften wie Pfadtrenner oder Version der virtuellen Maschine in einem java.util.Properties-Objekt. Die statische Funktion System.getProperties() erfragt diese Systemeigenschaften und liefert das gefüllte Properties-Objekt zurück. Zum Erfragen einzelner Eigenschaften ist das Properties-Objekt aber nicht unbedingt nötig: System.getProperty() erfragt direkt eine Eigenschaft.

System.getProperties().list( System.out );

System.out.println( System.getProperty("os.name") );

Eine Liste der Standard-Systemeigenschaften bietet die API-Dokumentation und die Web-Seite http://www.tolstoy.com/samizdat/sysprops.html sammelt für unterschiedliche Laufzeitumgebungen Belegungen.

final class java.lang.  System  

static Properties getProperties() Liefert ein mit den aktuellen Systembelegungen gefülltes Properties-Objekt.

static String getProperty( String key ) Gibt die Belegung einer Systemeigenschaft. Ist der Schlüssel null oder leer gibt es eine NullPointerException bzw. eine IllegalArgumentException.

static String getProperty( String key, String def ) Gibt die Belegung einer Systemeigenschaft. Ist sie nicht vorhanden, liefert die Funktion die Zeichenkette def, den Default-Wert. Für die Ausnahmen gilt das gleiche wie bei getProperty(String).

static String setProperty( String key, String value ) Belegung die Systemeigenschaft neu. Es wird die alte Belegung (oder null falls es keine alte Belegung gab) zurückgegeben.

static String clearProperty( String key ) Löscht eine Systemeigenschaft aus der Liste. Es wird die alte Belegung (oder null falls es keine alte Belegung gab) zurückgegeben.

8.4.1 line.separator 

Um nach dem Ende einer Zeile zum Anfang der nächsten zu kommen, wird ein Zeilenumbruch (engl. new line) eingefügt. Das Zeichen für den Zeilenumbruch muss kein einzelnes sein, es können auch mehrere Zeichen nötig sein. Zur Last der Programmierer unterscheidet sich die Anzahl Zeichen für den Zeilenumbruch auf den bekannten Architekturen:

Unix: Line Feed (Zeilenvorschub)

Macintosh: Carriage Return (Wagenrücklauf)

Windows: Beide Zeichen Carriage Return und Linefeed

Der Steuercode für Carriage Return (kurz CR) ist 13 (0x0D), der für Line Feed (kurz LF) ist 10 (0x0A). Java vergibt obendrein eigene Escape-Sequenzen für diese Zeichen: \r für Carriage Return und \n für Line Feed. (Die Sequenz \f für ein Form Feed – Seitenvorschub – spielt bei den Zeilenumbrüchen keine Rolle.)

Um sich nicht in eine Abhängigkeit eines Betriebssystems zu begeben, sollte der Zeilenumbruch vom System erfragt werden. Hierzu gibt es eine Property: line.separator. Unter Windows ergibt sich folgendes Bild:

System.out.println( System.getProperty("os.name") );             // Windows 2000
String lineSep = System.getProperty( "line.separator" );
System.out.println( lineSep.length() );                          // 2
System.out.println( Integer.toHexString(lineSep.charAt(0)) );    // d
if ( lineSep.length() > 1 )
  System.out.println( Integer.toHexString(lineSep.charAt(1)) );  // a

8.4.2 Browser-Version abfragen 

Nützlich für Applets sind die Eigenschaften browser.version und java.vendor. Letzteres identifiziert den Browser und so lässt sich in Erfahrung bringen, ob der Browser ein Internet Explorer oder Netscape Communicator ist.

String prop = System.getProperty( "java.vendor" );
boolean isIe = prop.indexOf( "Microsoft Corp." ) >= 0;

8.4.3 Property von der Konsole aus setzen 

Eigenschaften lassen sich auch bei Programmstart von der Konsole aus setzen. Dies ist praktisch für eine Eigenschaft, die beispielsweise das Verhalten des Programms steuert oder das Programm konfiguriert. In der Kommandozeile werden mit -D der Name der Eigenschaft und ihr Wert angegeben. Viele Entwicklungsumgebungen erlauben es, diese in einem Fenster zu setzen. Die Informationen tauchen nicht bei der Argument-Liste in der main()-Methode auf, da sie vor dem Namen der Klasse stehen und bereits von der Java-Laufzeitumgebung verarbeitet werden.

Um die Eigenschaften auszulesen, gibt es zwei Möglichkeiten. Eine davon ist überraschend.

Listing 8.6   SetProperty.java

class SetProperty
{
  static public void main( String args[] )
  {
    boolean debug = false;

    String prop = System.getProperty( "DEBUG" );

    // Erster Weg

    if ( prop != null )
      debug = Boolean.valueOf(prop).booleanValue();

    if ( debug )
       System.out.println( "Wir dürfen debuggen" );

    // Zweiter Weg

    System.out.println( Boolean.getBoolean("DEBUG") );
 }
}

Auf der Konsole folgt die Ausgabe

$ java -DDEBUG=true SetProperty

Wir dürfen debuggen

true

Wir bekommen über getProperty() einen String zurück, der den Wert anzeigt. Falls es überhaupt keine Eigenschaft mit diesem Namen gibt, erhalten wir stattdessen null. So wissen wir auch, ob dieser Wert überhaupt gesetzt wurde.

Für die Wahrheitswerte gibt es die statische Funktion getBoolean() in der Klasse Boolean, die aus den System-Properties eine Eigenschaft mit dem angegebenen Namen heraussucht.

public static boolean getBoolean( String name ) {
  return toBoolean( System.getProperty(name) );
}

Es erstaunt, diese Funktion in der Wrapper-Klasse Boolean anzutreffen, da dies nichts mit den Wrapper-Objekten zu tun hat. Gegenüber einer eigenen direkten System-Anfrage hat getBoolean() auch den Nachteil, dass wir bei der Rückgabe false nicht unterscheiden können, ob es die Eigenschaft nicht gibt, oder ob die Eigenschaft mit dem Wert false belegt ist.

class java.lang.  Boolean  
implements Serializable

static boolean getBoolean( String propName ) Liest eine Systemeigenschaft aus.

8.4.4 Umgebungsvariablen des Betriebssystems 

Fast jedes Betriebssystem nutzt das Konzept der Umgebungsvariablen; bekannt ist etwa PATH für den Suchpfad für Applikationen unter Windows und unter Unix. Die von Java eingeführten Eigenschaften mittels System.getProperties() unterschieden sich grundlegend von den System-Umgebungsvariablen und tauchen daher in der Liste nicht auf.

Seit Java 5 ist es möglich, auf diese System-Umgebungsvariablen zuzugreifen. Dazu dient die statische Funktion getenv() von System, wo auch getProperties() zu finden ist. Sie liefert eine Menge von <String, String>-Paaren. Um auf eine spezielle Umgebungsvariable zuzugreifen, lässt sich getenv(String) nutzen, etwa um den Suchpfad herauszufinden: System.getenv("path");

Map map = System.getenv();
System.out.println( map.toString().replace(’,’, ’\n’) );