» Referenzen / Klassen / System

Die Systemklasse von Java beinhaltet viele nützliche Funktionen zum Speichermanagement, sowie die Standardobjekte für die Eingabe und Ausgabe. Alle Methoden und Elemente sind statischer Natur und eine Instanziierung der Klasse ist ebenfalls nicht möglich.

» ab JDK Version 1.0

» Hierarchie

» Implementierung 

public final class System
extends Object
» Basisklasse » implementierte Schnittstellen

» Object
keine
» Package java.lang

» Elemente

In der folgenden Liste sind alle von uns bereits referenzierten Elemente der Klasse aufgeführt.

» Methoden » Konstruktoren

» arraycopy
» currentTimeMillis
» exit
» gc
» getProperties
» getProperty [1][2]
» getSecurityManager
» identityHashCode
» load
» loadLibrary
» mapLibraryName
» runFinalization
» setErr
» setIn
» setOut
» setProperties
» setProperty
» setSecurityManager
keine
» Datenelemente » Destruktoren

» err
» in
» out
keine

» Datenelemente / err

Das Element repräsentiert den Standardausgabekanal. Dieser ist immer geöffnet und kann frei verwendet werden. In der Regel wird dieser Stream für die Ausgabe von Fehlermeldungen verwendet.

» Prototyp 

public static final PrintStream err
» ab JDK Version 1.0

» Datenelemente / in

Das Element repräsentiert den Standardeingabekanal. Dieser ist immer geöffnet und kann frei verwendet werden. In der Regel wird dieser Stream für die Entgegennahme von Anwendereingaben genutzt.

» Prototyp 

public static final InputStream in
» ab JDK Version 1.0

» Datenelemente / out

Das Element repräsentiert den Standardausgabekanal. Dieser ist immer geöffnet und kann frei verwendet werden. In der Regel wird dieser Stream für die Ausgabe von benutzerdefinierten Nachrichten verwendet.

» Prototyp 

public static final InputStream in
» ab JDK Version 1.0

» Methoden / arraycopy

Die Methode erzeugt eine tiefe Kopie eines Arrays. Die zu kopierende Sequenz kann dabei direkt bestimmt werden.

Handelt es sich bei der Quelle gleichzeitig um das Ziel, so wird die Sequenz erst in ein temporäres Array verschoben und dann in das Quellarray hineinkopiert.

» Prototyp 

public static void arraycopy(Object source,int begin1,
                             Object target,int begin2,int length)
» Parameter

source Das Quellarray das zu kopieren ist.
target In das einzufügende Zielarray.
begin1 Ab der zu lesenden Position im Quellarray.
begin2 Ab der zu schreibenden Position im Zielarray.
length Anzahl der maximal zu kopierenden Elemente.

» Rückgabe

keine
» Ausnahmen & Fehler

IndexOutOfBoundsException
Ein Zugriff außerhalb der Arrays trat auf.
ArrayStoreException
Ein Quellelement konnte nicht ins Zielarray kopiert werden.
NullPointerException
Die Referenzen auf die Arrays sind null.

» ab JDK Version 1.0

» Methoden / currentTimeMillis

Die Methode liefert die aktuelle Zeit im Millisekunden. Gerechnet wird ab Mitternacht des ersten Januar 1970.

» Prototyp 

public static long currentTimeMillis()
» Parameter

keine
» Rückgabe

Wert Die aktuelle Zeit in Millisekunden.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / exit

Die Methode beendet das Programm und die JVM. Es kann ein Statuscode an den Kommandointerpreter übergeben werden.

» Prototyp 

public static void exit(int status)
» Parameter

status Der Statuscode beim Beenden des Programms.

» Rückgabe

keine
» Ausnahmen & Fehler

SecurityException
Der Abbruch mit dem spezifischen Statuscode wird vom Sicherheitsmanager nicht gestattet.

» ab JDK Version 1.0

» Methoden / gc

Die Methode ruft den Garbage Collector auf und beginnt die Speicherbereinigung.

» Prototyp 

public static void gc()
» Parameter

keine
» Rückgabe

keine
» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / getProperties

Die Methode liefert eine Sammlung aller Systemeigenschaften der JVM und Umgebung.

» Prototyp 

public static Properties getProperties()
» Parameter

keine
» Rückgabe

Objekt Ein Objekt welches die Umgebungsvariablen samt ihrer Werte enthält.

» Ausnahmen & Fehler

SecurityException
Der Zugriff auf das System ist untersagt.

» ab JDK Version 1.0

» Methoden / getProperty [1][2]

Die Methode liefert den Wert einer bestimmten Umgebungsvariable. Ist diese nicht vorhanden, so kann ein optionaler Rückgabewert spezifiziert werden.

» Prototyp 

public static String getProperty(String key               )
public static String getProperty(String key,String default)
» Parameter

default Rückgabewert falls die Umgebungsvariable nicht bekannt ist.
key Die gesuchte Umgebungsvariable. Folgende Namen sind verwendbar. Je nach Compiler und System kann es noch andere Bezeichner geben.

java.home
java.vendor
java.vendor.url
java.version
java.vm.name
java.vm.vendor
java.vm.version
java.vm.specification.version
java.vm.specification.vendor
java.vm.specification.name
java.specification.version
java.specification.vendor
java.specification.name
java.class.version
java.class.path
java.ext.dirs
os.name
os.arch
os.version
file.separator
path.separator
line.separator
user.name
user.home
user.dir

» Rückgabe

String Der Wert der Umgebungsvariable oder der Defaultwert.

» Ausnahmen & Fehler

SecurityException
Der Zugriff auf das System ist untersagt.
NullPointerException
Die Referenz auf den Namen der Umgebungsvariable ist null.
IllegalArgumentException
Der gesuchte Schlüssel ist leer.

» ab JDK Version alle 1.0

» Methoden / getSecurityManager

Die Methode liefert die Schnittstelle des Sicherheitsmanagers.

» Prototyp 

public static SecurityManager getSecurityManager()
» Parameter

keine
» Rückgabe

Objekt Der aktuelle Sicherheitsmanager.
null Es wurde noch kein Sicherheitsmanager instanziiert.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / identityHashCode

Die Methode liefert den Hashwert eines Objekts.

» Prototyp 

public static int identityHashCode(Object object)
» Parameter

object Das Objekt dessen Hashwert zu ermitteln ist.

» Rückgabe

Wert Der Hashwert des Objekts.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.1

» Methoden / load

Die Methode läd eine externe Datei als dynamische Bibliothek.

» Prototyp 

public static void load(String path)
» Parameter

path Vollständiger Pfad der zu ladenden Datei.

» Rückgabe

keine
» Ausnahmen & Fehler

SecurityException
Das Laden der Bibliothek ist untersagt.
UnsatisfiedLinkError
Die Datei existiert nicht.

» ab JDK Version 1.0

» Methoden / loadLibrary

Die Methode läd eine Systembibliothek. Diese ist vom verwendeten System abhängig.

» Prototyp 

public static void loadLibrary(String path)
» Parameter

path Vollständiger Pfad der zu ladenden Datei.

» Rückgabe

keine
» Ausnahmen & Fehler

SecurityException
Das Laden der Bibliothek ist untersagt.
UnsatisfiedLinkError
Die Datei existiert nicht.

» ab JDK Version 1.0

» Methoden / mapLibraryName

Die Methode liefert die Stringrepräsentation einer Systembibliothek samt Extension. Diese ist vom verwendeten System abhängig. Der Name der Bibliothek ist ohne Extension anzugeben.

» Prototyp 

public static String mapLibraryName(String name)
» Parameter

name Dateiname der Bibliothek.

» Rückgabe

String Stringrepräsentation mit dem vollwertigen Dateinamen und Extension.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.2

» Methoden / runFinalization

Die Methode ruft die Destruktoren aller Objekte auf, welche durch die JVM zur Speicherbereinigung freigegeben sind.

» Prototyp 

public static void runFinalization()
» Parameter

keine
» Rückgabe

keine
» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / setErr

Die Methode legt einen neuen Ausgabestream für Fehlermeldungen fest.

» Prototyp 

public static void setErr(PrintStream stream)
» Parameter

stream Der neue Ausgabestream.

» Rückgabe

keine
» Ausnahmen & Fehler

SecurityException
Das Überschreiben der aktuellen Einstellungen ist untersagt.

» ab JDK Version 1.1

» Methoden / setIn

Die Methode legt einen neuen Eingabestream fest.

» Prototyp 

public static void setIn(InputStream stream)
» Parameter

stream Der neue Eingabestream.

» Rückgabe

keine
» Ausnahmen & Fehler

SecurityException
Das Überschreiben der aktuellen Einstellungen ist untersagt.

» ab JDK Version 1.1

» Methoden / setOut

Die Methode legt einen neuen Ausgabestream fest.

» Prototyp 

public static void setOut(PrintStream stream)
» Parameter

stream Der neue Ausgabestream.

» Rückgabe

keine
» Ausnahmen & Fehler

SecurityException
Das Überschreiben der aktuellen Einstellungen ist untersagt.

» ab JDK Version 1.1

» Methoden / setProperties

Die Methode setzt neue Systemvariablen über ein Containerobjekt fest.

» Prototyp 

public static void setProperties(Properties container)
» Parameter

container Das Objekt mit den neuen Einstellungen.

» Rückgabe

keine
» Ausnahmen & Fehler

SecurityException
Das Setzen neuer Werte ist untersagt.

» ab JDK Version 1.0

» Methoden / setProperty

Die Methode setzt eine neue Umgebungsvariable.

» Prototyp 

public static String setProperty(String key,String value)
» Parameter

key Der Name der zu setzenden Umgebungsvariable.
value Der Wert der neuen Variable.

» Rückgabe

String Der alte Wert der Variable.
null Die Variable hatte keinen Wert.

» Ausnahmen & Fehler

SecurityException
Das Setzen neuer Werte ist untersagt.
NullPointerException
Die Referenz auf den Namen der Umgebungsvariable ist null.
IllegalArgumentException
Der gesuchte Schlüssel ist leer.

» ab JDK Version 1.2

» Methoden / setSecurityManager

Die Methode legt einen neuen Sicherheitsmanager fest.

» Prototyp 

public static void setSecurityManager(SecurityManager manager)
» Parameter

manager Der neue Sicherheitsmanager.

» Rückgabe

keine
» Ausnahmen & Fehler

SecurityException
Das Setzen eines neuen Sicherheitsmanagers ist untersagt.

» ab JDK Version 1.0