8.3 Benutzereinstellungen 

Einstellungen des Benutzers – wie die letzen 4 geöffneten Dateien oder das letzte benutzte Verzeichnis – müssen abgespeichert werden. Dazu gibt es eine Reihe von Möglichkeiten.

Die Einstellungen werden auf der Kommandozeile übergeben. Das lässt die Option –D auf der Kommandozeile zu, wenn die JVM über java gestartet wird.

In der Regel werden die Daten auf dem Rechner in einer Datei (Property-Datei) gespeichert. Die dafür nötigen Operationen werden im Kapitel über Ein-/Ausgabeoperationen vermittelt. Ein definiertes Ausgabeformat kann auch XML sein. Wie sich Dateien in XML speichern lassen beschreibt ein anderes Kapitel.

Die Daten können in einem globalen Verzeichnisbaum nicht-lokale gespeichert werden. Dazu dienen Systeme wie JNDI, die etwa in einem LDAP-Baum die Benutzereintragungen verwalten.

Die Daten stehen in einer Datenbank.

Unter Windows gibt es eine andere Möglichkeit der Speicherung: Die Registry.

8.3.1 Eine zentrale Registry 

Läuft Java unter Windows, so lässt sich mit dem Paket java.util.prefs ein Teilbaum der Registry ansprechen. Da Unix-Systeme keine Registry besitzen, werden in diesem Fall die Informationen in einer XML-Datei gespeichert.¹  Doch auch wenn unter Windows gespeichert wird, lässt sich auch nicht auf die gesamte Registy zugreifen – Java-Programme bekommen nur einen bestimmen Zweig zugesprochen.

Für die Benutzereinstellungen stehen zwei Gruppen zur Verfügung: der Benutzerumgebung und Systemumgebung. Sie lassen sich über zwei Arten erlangen: Die erste Möglichkeit arbeitet über einen absolute Pfades zum Registry-Knoten. Die Funktionen sind am Preferences-Objekt befestigt und heißt für die Benutzerumgebung userRoot() und Systemumgebung systemRoot().Die zweite Möglichkeit nutzt die Eigenschaft, dass automatisch jede Klasse in eine Paketstruktur eingebunden ist. userNodeForPackage(Class) oder systemNodeForPackage(Class) liefert ein Preferences-Objekt für eine Verzeichnisstruktur, in der die Klasse selbst liegt.

Preferences userPrefs = Preferences.userRoot().node(   "/com/javatutor/insel"   );
Preferences userPrefs = Preferences.userNodeForPackage(   this.getClass()   );

8.3.2 Einträge einfügen, auslesen und löschen 

Die Klasse Preferences hat große Ähnlichkeit mit den Klassen Properties beziehungsweise HashMap (vergleiche Kapitel 11). Schlüssel-/Wertepaare lassen sich Einfügen, Löschen und Erfragen. Allerdings ist die Klasse Preferences kein Mitglied der Collection-API und es existiert auch keine Implementierung von Collection-Schnittstellen.

abstract class java.util.prefs.  Preferences  

abstract void put( String key, String value ) abstract void putBoolean( String key, boolean value ) abstract void putByteArray( String key, byte[] value ) abstract void putDouble( String key, double value ) abstract void putFloat( String key, float value ) abstract void putInt( String key, int value ) abstract void putLong( String key, long value )

Bildet eine Assoziation zwischen den Schlüsselnamen und dem Wert. Die Varianten mit den speziellen Datentypen nehmen intern eine einfache String-Umwandlung vor und sicht nur kleine Hilfsfunktionen und so steht in putDouble() nur put(key, Double.toString(value)). putByteArray() konvertiert die Daten nach der Base64-Kodierung.

abstract String get( String key, String def ) abstract boolean getBoolean( String key, boolean def ) abstract byte[] getByteArray( String key, byte def[] ) abstract double getDouble( String key, double def ) abstract float getFloat( String key, float def ) abstract int getInt( String key, int def ) abstract long getLong( String key, long def )

abstract String[] keys() Liefert alle Knoten unter der Wurzel, dem ein Wert zugewiesen wurde. Falls der Knoten keine Eigenschaften hat, liefert keys() ein leeres Feld.

Unser folgendes Programm richtet einen neuen Knoten unter /com/javatutor/insel ein. Aus den über System.getProperties() ausgelesenen System-Eigenschaften sollen alle Eigenschaften die mit »user.« beginnen, in die Registry übernommen werden.

Listing 8.5   PropertiesInRegistry.java

import java.io.ByteArrayOutputStream;
import java.util.Enumeration;
import java.util.prefs.*;

public class PropertiesInRegistry
{
  static Preferences prefs = Preferences.userRoot().node( "/com/javatutor/insel" );

  static void fillRegistry()
  {
    for ( Enumeration e = System.getProperties().propertyNames(); 
e.hasMoreElements(); )
    {
      String key = (String) e.nextElement();

      if ( key.startsWith("user.") )
      prefs.put( key, System.getProperty(key) );
    }
  }

Um die Elemente auszulesen, kann ein bestimmtes Elemente mit getXXX() erfragt werden. Die Ausgabe aller Elemente unter einem Knoten gelingt am Besten mit keys(). Das Auslesen kann eine BackingStoreException auslösen, falls der Zugriff auf den Knoten nicht möglich ist. Mit get() erfragen wir anschließend den mit den Schlüssel assoziierten Wert. Wir geben »---« aus, falls der Schlüssel keinen assoziierten Wert besitzt.

  static void display()
  {
    try
    {
      String keys[] = prefs.keys();

      for ( int i = 0; i < keys.length; i++ )
        System.out.println( keys[i] + ": " + prefs.get(keys[i], "---") );
    }
    catch ( BackingStoreException e )
    {
      System.err.println( "Knoten können nicht ausgelesen werden: " + e );
    }
  }

Um Einträge wieder loszuwerden, gibt es drei Methoden: clear(), remove() und removeNode(). Die Namen sprechen für sich.

8.3.3 Auslesen der Daten und schreiben in anderem Format 

Die Daten aus den Preferences lassen sich mit exportNode(OutputStream) beziehungsweise exportSubtree(OutputStream) im UTF-8 kodierten XML-Format in einen Ausgabestrom schreiben. exportNode(OutputStream) speichert nur einen Knoten und exportSubtree(OutputStream) den Knoten inklusive seiner Kinder. Und auch der umgekehrte Weg funktioniert: importPreferences(InputStream) importiert Teile in die Registrierung. Die Schreib- und Lesefunktionen lösten eine IOException bei Fehlern aus und eine InvalidPreferencesFormatException ist beim Lesen möglich, wenn die XML-Daten ein falsches Format haben.

8.3.4 Auf Ereignisse horchen 

Änderungen lassen sich mit Listernern verfolgen. Der NodeChangeListener reagiert auf Einfüge- und Löschoperationen von Knoten und der PreferenceChangeListener informiert bei Wertänderungen.

¹  Die Systemeigenschaften landen unter /etc/.java/.systemPrefs und die Benutzereigenschaften lokal unter $HOME/.java/.userPrefs.