Referenzen / Klassen / Runtime

» Referenzen / Klassen / Runtime

Jede Java - Applikation stellt ein Runtime - Modul zur Verfügung. Dieses beinhaltet diverse Systembefehle und Methoden. Eine Applikation kann allerdings nicht von alleine eine solche Klasse instanziieren.

» ab JDK Version

1.0

java.lang.Object

java.lang.Runtime

public class Runtime
extends Object

» Object

keine

» Elemente

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

» Methoden

» Konstruktoren

» addShutdownHook
» exec [1][2][3][4][5][6]
» exit
» freeMemory
» gc
» getRuntime
» halt
» load
» loadLibrary
» removeShutdownHook
» runFinalization
» totalMemory
» traceInstructions
» traceMethodCalls

keine

» Datenelemente

» Destruktoren

keine

» Methoden / addShutdownHook

Die Methoden registriert ein neues Ereignis für die Beendigung der JVM. Die JVM wird in den folgenden Fällen beendet.

Das Programm endet wenn alle Dämon - Threads beendet sind.
Die Exit - Methode wird aufgerufen.
Die JVM wird durch ein Systemereignis oder Fehler beendet.

Realisiert wird dieses Ereignis über einen Thread, der jedoch zunächst ungestartet bleibt. Erst beim Herunterfahren der JVM wird dieser Thread aufgerufen und kann seine Aufgabe erfüllen. So sind auch mehrere dieser Sequenzen möglich. Alle Dämon - Threads laufen allerdings parallel weiter, bis zur Beendigung der JVM.

» Prototyp

public void addShutdownHook(Thread hook)

» Parameter

hook	Der zu registrierende Thread.

» Rückgabe

keine

» Ausnahmen & Fehler

IllegalArgumentException

Das Ereignis wurde bereits registriert oder läuft bereits.

IllegalStateException

Die JVM wird gerade heruntergefahren.

SecurityException

Die Sicherheit verhindert die Operation.

» ab JDK Version

1.3

» Methoden / exec [1][2][3]

Die Methoden führt einen Befehl in einem separaten Prozess aus. Optional können Umgebungsvariablen und ein Arbeitsverzeichnis bestimmt werden.

» Prototyp

public Process exec(String command)
throws IOException
public Process exec(String command,String[] environment)
throws IOException
public Process exec(String command,String[] environment,File path)
throws IOException

» Parameter

command	Der auszuführende Befehl.
environment	Die Umgebungsvariablen für den Prozess.
path	Das Arbeitsverzeichnis des Prozesses.

» Rückgabe

Objekt

Ein Objekt um den neuen Prozess zu verwalten.

» Ausnahmen & Fehler

IOException

Es ist ein Fehler im Stream aufgetreten.

SecurityException

Die Sicherheit verhindert die Operation.

» ab JDK Version

alle 1.0

» Methoden / exec [4][5][6]

Die Methoden führt einen Befehl in einem separaten Prozess aus. Optional können Umgebungsvariablen und ein Arbeitsverzeichnis bestimmt werden.

» Prototyp

public Process exec(String[] command)
throws IOException
public Process exec(String[] command,String[] environment)
throws IOException
public Process exec(String[] command,String[] environment,File path)
throws IOException

» Parameter

command	Der auszuführende Befehl und seine Argumente.
environment	Die Umgebungsvariablen für den Prozess.
path	Das Arbeitsverzeichnis des Prozesses.

» Rückgabe

Objekt

Ein Objekt um den neuen Prozess zu verwalten.

» Ausnahmen & Fehler

IOException

Es ist ein Fehler im Stream aufgetreten.

SecurityException

Die Sicherheit verhindert die Operation.

NullPointerException

Das Array mit den Befehlen ist null.

IndexOutOfBoundsException

Das Array mit den Befehlen ist null oder leer.

» ab JDK Version

alle 1.0

» Methoden / exit

Die Methoden leitet das Herunterfahren der JVM ein. In der Regel beendet diese Methode das Programm nie normal, sondern liefert einen Statuscode ungleich null, um die Art des Abbruchs zu spezifizieren. Zuvor werden alle Speicherfreigaben durchgeführt und registrierte Ereignisse beim Beenden der JVM durchlaufen.

» Prototyp

public void exit(int code)

» Parameter

code	Der Statuscode des Abbruchs.

» Rückgabe

keine

» Ausnahmen & Fehler

SecurityException

Die Sicherheit verhindert die Operation.

» ab JDK Version

1.0

» Methoden / freeMemory

Die Methoden liefert eine Angabe des noch freien Systemspeichers in Bytes.

» Prototyp

public long freeMemory()

» Parameter

keine

» Rückgabe

Wert	Der noch verfügbare Systemspeicher.

» Ausnahmen & Fehler

keine

» ab JDK Version

1.0

» Methoden / gc

Die Methoden startet den Garbage Collector der JVM.

» Prototyp

public void gc()

» Parameter

keine

» Rückgabe

keine

» Ausnahmen & Fehler

keine

» ab JDK Version

1.0

» Methoden / getRuntime

Die Methoden liefert das Laufzeitobjekt der aktuellen Applikation.

» Prototyp

public static Runtime getRuntime()

» Parameter

keine

» Rückgabe

Objekt

Das gewünschte Laufzeitobjekt.

» Ausnahmen & Fehler

keine

» ab JDK Version

1.0

» Methoden / halt

Die Methoden beendet sofort die JVM. In der Regel beendet diese Methode das Programm nie normal, sondern liefert einen Statuscode ungleich null, um die Art des Abbruchs zu spezifizieren. Sie führt keinerlei Speicherfreigaben oder registrierte Ereignisse beim Beenden der JVM aus.

» Prototyp

public void halt(int code)

» Parameter

code	Der Statuscode des Abbruchs.

» Rückgabe

keine

» Ausnahmen & Fehler

SecurityException

Die Sicherheit verhindert die Operation.

» ab JDK Version

1.3

» Methoden / load

Die Methoden läd eine Datei als dynamische Bibliothek.

» Prototyp

public void load(String name)

» Parameter

name	Pfadangabe und Name der zu ladenden Datei.

» Rückgabe

keine

» Ausnahmen & Fehler

SecurityException

Die Sicherheit verhindert die Operation.

UnsatisfiedLinkError

Die Datei existiert nicht.

» ab JDK Version

1.0

» Methoden / loadLibrary

Die Methoden läd eine Datei als dynamische Bibliothek.

» Prototyp

public void loadLibrary(String name)

» Parameter

name	Pfadangabe und Name der zu ladenden Datei.

» Rückgabe

keine

» Ausnahmen & Fehler

SecurityException

Die Sicherheit verhindert die Operation.

UnsatisfiedLinkError

Die Datei existiert nicht.

» ab JDK Version

1.0

» Methoden / removeShutdownHook

Die Methoden entfernt ein registriertes Ereignis aus der Ereignisliste der JVM.

» Prototyp

public boolean removeShutdownHook(Thread hook)

» Parameter

hook	Der zu entfernende Thread, beziehungsweise Ereignis.

» Rückgabe

True	Das Ereignis war registriert und ist nun entfernt.
False	Das Ereignis war nicht registriert.

» Ausnahmen & Fehler

IllegalStateException

Die JVM wird gerade heruntergefahren.

SecurityException

Die Sicherheit verhindert die Operation.

» ab JDK Version

1.3

» Methoden / runFinalization

Die Methoden veranlaßt die JVM, alle Destruktoren der noch geladenen Objekte aufzurufen und folglich deren Speicher freizugeben.

» Prototyp

public void runFinalization()

» Parameter

keine

» Rückgabe

keine

» Ausnahmen & Fehler

keine

» ab JDK Version

1.0

» Methoden / totalMemory

Die Methoden liefert eine Angabe des gesamten Systemspeichers der JVM in Bytes.

» Prototyp

public long totalMemory()

» Parameter

keine

» Rückgabe

Wert	Der verfügbare Systemspeicher.

» Ausnahmen & Fehler

keine

» ab JDK Version

1.0

» Methoden / traceInstructions

Die Methoden aktiviert oder deaktiviert das Verfolgen, Aufzeichnen und Prüfen jeder Anweisung im Debugging. Der Ausgabestream hängt von der genutzten Umgebung ab.

» Prototyp

public void traceInstructions(boolean on)

» Parameter

on	Aktiviert oder deaktiviert den Trace - Modus.

» Rückgabe

keine

» Ausnahmen & Fehler

keine

» ab JDK Version

1.0

» Methoden / traceMethodCalls

Die Methoden aktiviert oder deaktiviert das Verfolgen, Aufzeichnen und Prüfen jedes Methodenaufrufs im Debugging. Der Ausgabestream hängt von der genutzten Umgebung ab.

» Prototyp

public void traceMethodCalls(boolean on)

» Parameter

on	Aktiviert oder deaktiviert den Trace - Modus.

» Rückgabe

keine

» Ausnahmen & Fehler

keine

» ab JDK Version

1.0