Package wt.security

Class RuntimeAccess

java.lang.Object

wt.security.Access

wt.security.RuntimeAccess

public class RuntimeAccess
extends wt.security.Access

Class that provides wrappers to privileged runtime methods using the wt.security package. This allows applets to execute applications on the client which is typically restricted by the sandbox.

Supported API: true

Method Summary

Modifier and Type	Method	Description
final Process	exec(String command)	Wrapper for Runtime.getRuntime().exec() method.
final Process	exec(String[] cmdarray, String[] envp)	Wrapper for Runtime.getRuntime().exec() method.
final Process	exec(String[] cmdarray, String[] envp, File workDir)	Wrapper for Runtime.getRuntime().exec() method.
static RuntimeAccess	getRuntimeAccess()	Get instance of RuntimeAccess.
static RuntimeAccess	getRuntimeAccess(Frame parentFrame)	Get instance of RuntimeAccess.
final void	load(String filename)	Wrapper for Runtime.getRuntime().load() method.
final void	loadLibrary(String libname)	Wrapper for Runtime.getRuntime().loadLibrary() method.
final void	openOrRun(File file)	Tries to use Java 6 Desktop API to open the file and then if that fails falls back to trying run(String).
final Process	run(String file)	Deprecated. Use openOrRun(File) or DesktopAccess open() or edit() APIs instead as these are cross-platform.

Methods inherited from class wt.security.Access

checkAccessAll, getReason, setReason

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

getRuntimeAccess

public static RuntimeAccess getRuntimeAccess(Frame parentFrame)

Get instance of RuntimeAccess. This instance can then be used to perform runtime operation that are typically restricted by the sandbox.

Supported API: true

Parameters:

parentFrame - the parent frame for security dialog boxes that may be presented

getRuntimeAccess

public static RuntimeAccess getRuntimeAccess()

Get instance of RuntimeAccess. This instance can then be used to perform runtime operation that are typically restricted by the sandbox.

Supported API: true

exec

public final Process exec(String command)
                   throws WTSecurityException,
IOException

Wrapper for Runtime.getRuntime().exec() method.

Supported API: true

Parameters:

command - the command to be executed

Throws:

WTSecurityException

IOException

exec

public final Process exec(String[] cmdarray,
 String[] envp)
                   throws WTSecurityException,
IOException

Wrapper for Runtime.getRuntime().exec() method.

Supported API: true

Parameters:

cmdarray - array containing the command to call and its arguments

envp - array containing environment in format name=value

Throws:

WTSecurityException

IOException

exec

public final Process exec(String[] cmdarray,
 String[] envp,
 File workDir)
                   throws WTSecurityException,
IOException

Wrapper for Runtime.getRuntime().exec() method.

Supported API: true

Parameters:

cmdarray - array containing the command to call and its arguments

envp - array containing environment in format name=value

workDir - working directory of subprocess

Throws:

WTSecurityException

IOException

run

public final Process run(String file)
                  throws WTSecurityException,
IOException

Deprecated.

Use openOrRun(File) or DesktopAccess open() or edit() APIs instead as these are cross-platform.

Method to load a file with the associated application. This method is currently only implemented in Windows by passing the filename to "rundll32.exe url.dll,FileProtocolHandler file://"

Supported API: true

Parameters:

file - the file to be loaded by it's associated executable

Throws:

WTSecurityException

IOException

openOrRun

public final void openOrRun(File file)
                     throws WTSecurityException,
IOException

Tries to use Java 6 Desktop API to open the file and then if that fails falls back to trying run(String).

Supported API: true

Parameters:

file - the file to be loaded by it's associated executable

Throws:

WTSecurityException

IOException

load

public final void load(String filename)
                throws WTSecurityException

Wrapper for Runtime.getRuntime().load() method.

Supported API: true

Parameters:

filename - the file to load

Throws:

WTSecurityException

loadLibrary

public final void loadLibrary(String libname)
                       throws WTSecurityException

Wrapper for Runtime.getRuntime().loadLibrary() method.

Supported API: true

Parameters:

libname - the name of the library

Throws:

WTSecurityException