java.lang.Object
   |
   +--java.lang.Runtime

Deklaration

Beschreibung

Methoden
public void	addShutdownHook(Thread hook)
public native int	availableProcessors()
public Process	exec(String command)
public Process	exec(String command, String[] envp)
public Process	exec(String[] cmdarray)
public Process	exec(String[] cmdarray, String[] envp)
public Process	exec(String command, String[] envp, File dir)
public Process	exec(String[] cmdarray, String[] envp, File dir)
public void	exit(int status)
public native long	freeMemory()
public native void	gc()
public InputStream	getLocalizedInputStream(InputStream in)       Verworfen in Version 1.1.
public OutputStream	getLocalizedOutputStream(OutputStream out)       Verworfen in Version 1.1.
public static Runtime	getRuntime()
public void	halt(int status)
public synchronized void	load(String filename)
public synchronized void	loadLibrary(String libname)
public native long	maxMemory()
public boolean	removeShutdownHook(Thread hook)
public native void	runFinalization()
public static void	runFinalizersOnExit(boolean value)
public native long	totalMemory()
public native void	traceInstructions(boolean on)
public native void	traceMethodCalls(boolean on)

Methoden im Detail

public void addShutdownHook(Thread hook)     

Registriert den Thread hook zur Ausführung beim Beenden der Virtual Machine. hook muss ein neu erzeugtes Thread-Exemplar sein, das noch nicht gestartet wurde. Diese Operation ist nur möglich, solange der Shutdown-Vorgang der Virtual Machine noch nicht begonnen hat, d. h. es ist nicht möglich, aus einer Shutdown-Routine eine andere zu registrieren. Bei der Registrierung mehrerer Threads können keine Annahmen über die Reihenfolge der Ausführung gemacht werden.

Exception: IllegalArgumentException

• Falls hook bereits registriert ist.
• Falls der übergebene Thread bereits gestartet wurde oder beendet ist.

Exception: IllegalStateException

• Falls der Shutdown-Vorgang bereits eingeleitet wurde.

Exception: SecurityException

• Falls der SecurityManager diese Operation nicht gestattet.

public native int availableProcessors()     

Liefert die Anzahl der Prozessoren zurück, die der Virtual Machine zur Verfügung stehen. Der Rückgabewert ist stets größer gleich Eins und kann während der Laufzeit aufgrund von Änderungen der Ressourcenzuteilung des Betriebssystems variieren.

public Process exec(String command)

Lässt das Kommando command vom Betriebssystem ausführen. Liefert ein Process-Objekt zurück, mit dem auf die Standardein- und -ausgabe sowie die Standardfehlerausgabe zugegriffen werden kann.

Exception: SecurityException

• Falls der SecurityManager das Ausführen von Tochterprozessen verweigert.

Exception: IOException

• Falls bei der Kommunikation mit den Tochterprozess ein Fehler aufgetreten ist.

public Process exec(String command, String[] envp)

Lässt das Kommando command vom Betriebssystem mit den in envp enthaltenen Umgebungsvariablen ausführen. Liefert ein Process-Objekt zurück, mit dem auf die Standardein- und -ausgabe sowie die Standardfehlerausgabe zugegriffen werden kann.

Exception: SecurityException

• Falls der SecurityManager das Ausführen von Tochterprozessen verweigert.

Exception: IOException

• Falls bei der Kommunikation mit den Tochterprozess ein Fehler aufgetreten ist.

public Process exec(String[] cmdarray)

Lässt die in cmdarray enthaltenen Kommandos vom Betriebssystem ausführen. Liefert ein Process-Objekt zurück, mit dem auf die Standardein- und -ausgabe sowie die Standardfehlerausgabe zugegriffen werden kann.

Exception: SecurityException

• Falls der SecurityManager das Ausführen von Tochterprozessen verweigert.

Exception: IOException

• Falls bei der Kommunikation mit den Tochterprozess ein Fehler aufgetreten ist.

public Process exec(String[] cmdarray, String[] envp)

Lässt die in cmdarray enthaltenen Kommandos vom Betriebsystem mit den in envp enthaltenen Umgebungsvariablen ausführen. Liefert ein Process-Objekt zurück, mit dem auf die Standardein- und -ausgabe sowie die Standardfehlerausgabe zugegriffen werden kann.

Exception: SecurityException

• Falls der SecurityManager das Ausführen von Tochterprozessen verweigert.

Exception: IOException

• Falls bei der Kommunikation mit den Tochterprozess ein Fehler aufgetreten ist.

public Process exec(String command, String[] envp, File dir)     

Lässt das Kommando command vom Betriebssystem mit den in envp enthaltenen Umgebungsvariablen ausführen. Mit dir kann das Arbeitsverzeichnis zur Ausführung der Kommandos gesetzt werden. Beim Wert null wird das Arbeitsverzeichnis der Virtual Machine übernommen.

Exception: IOException

• Falls bei der Kommunikation mit den Tochterprozess ein Fehler aufgetreten ist.

public Process exec(String[] cmdarray, String[] envp, File dir)     

Lässt die in cmdarray enthaltenen Kommandos vom Betriebsystem mit den in envp enthaltenen Umgebungsvariablen ausführen. Mit dir kann das Arbeitsverzeichnis zur Ausführung der Kommandos gesetzt werden. Beim Wert null wird das Arbeitsverzeichnis der Virtual Machine übernommen.

Exception: IOException

• Falls bei der Kommunikation mit den Tochterprozess ein Fehler aufgetreten ist.

public void exit(int status)

Führt Shutdown-Routinen aus, sofern welche registriert sind, und beendet anschließend die virtuelle Maschine mit dem Exit-Code status. Diese Methode kehrt nicht mehr von ihrem Aufruf zurück.

public native long freeMemory()

Liefert den der Virtual Machine noch zur Verfügung stehenden Hauptspeicherplatz in Bytes.

public native void gc()

Diese Methode startet den Garbage Collector.

public InputStream getLocalizedInputStream(InputStream in)

Liefert zum Stream in einen InputStream, der die gelesenen Zeichen aus dem Zeichensatz der Plattform in Unicode-Zeichen konvertiert.

public OutputStream getLocalizedOutputStream(OutputStream out)

Liefert zum Stream out einen OutputStream, der die zu schreibenden Unicode-Zeichen in den Zeichensatz der Plattform konvertiert.

public static Runtime getRuntime()

Liefert ein Runtime-Objekt, das die Laufzeitumgebung repräsentiert. Über den mit dieser Methode erhaltenen Verweis können die anderen Methoden aufgerufen werden.

public void halt(int status)     

Erzwingt eine Beendigung der Virtual Machine mit dem Exit-Code status. Im Gegensatz zu einer »geregelten« Beendigung der Virtual Machine mit System.exit() werden bei dieser Methode weder ausstehende Finalisierungen von Objekten noch mit addShutdownHook() registrierte Routinen ausgeführt.

public synchronized void load(String filename)

Lädt die durch filename bezeichnete Shared Library. filename muss hierbei den absoluten Pfad enthalten. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob das Laden von Shared Libraries zulässig ist. Wird benötigt, um die Implementierung von native-Methoden zu laden.

Exception: OutOfMemoryError

• Falls der Hauptspeicher nicht reicht, um die Shared Library zu laden.

Exception: UnsatisfiedLinkError

• Wenn die Shared Library nicht gefunden wurde.

public synchronized void loadLibrary(String libname)

Lädt die durch libname bezeichnete Shared Library, die in den Standard-Verzeichnissen des Systems gesucht wird. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob das Laden von Shared Libraries zulässig ist. Wird benötigt, um die Implementierung von native-Methoden zu laden.

Exception: OutOfMemoryError

• Falls der Hauptspeicher nicht reicht, um die Shared Library zu laden.

Exception: UnsatisfiedLinkError

• Wenn die Shared Library nicht gefunden wurde.

public native long maxMemory()     

Liefert die Größe des Hautspeicherbereichs in Bytes zurück, den die Virtual Machine maximal belegt. Wenn das Betriebssystem keine Grenze vorgibt, ist der Rückgabewert Long.MAX_VALUE.

public boolean removeShutdownHook(Thread hook)     

Entfernt hook aus der Liste der Shutdown-Routinen. Diese Operation ist nur möglich, solange der Shutdown-Vorgang der Virtual Machine noch nicht begonnen hat, d. h. es ist nicht möglich, aus einer Shutdown-Routine eine andere zu entfernen.

Exception: IllegalStateException

• Falls der Shutdown-Vorgang bereits eingeleitet wurde.

Exception: SecurityException

• Falls der SecurityManager diese Operation nicht gestattet.

public native void runFinalization()     

Fordert die Virtual Machine auf, nach Möglichkeit die finalize()-Methode aller zu entfernenden Objekte, deren finalize()-Methode noch nicht automatisch aufgerufen wurde, auszuführen.

public static void runFinalizersOnExit(boolean value)     

Wenn value true ist, wird erzwungen, dass beim Beenden der Virtual Machine die finalize()-Methode aller zu entfernenden Objekte, deren finalize()-Methode noch nicht automatisch aufgerufen wurde, ausgeführt wird. Standardmäßig ist diese Option nicht gesetzt.

public native long totalMemory()

Liefert die Hauptspeichermenge in Bytes, die der Virtual Machine insgesamt zur Verfügung steht.

public native void traceInstructions(boolean on)

Veranlasst die Virtual Machine in Abhängigkeit von on, Meldungen über die Ausführung jeder einzelnen Bytecode-Instruktion auszugeben.

public native void traceMethodCalls(boolean on)

Veranlasst die Virtual Machine in Abhängigkeit von on, Meldungen über jeden einzelnen Methodenaufruf auszugeben.