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 priviledged 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

Process	exec(String command) Wrapper for Runtime.getRuntime().exec() method.
Process	exec(String[] cmdarray, String[] envp) Wrapper for Runtime.getRuntime().exec() method.
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.
void	load(String filename) Wrapper for Runtime.getRuntime().load() method.
void	loadLibrary(String libname) Wrapper for Runtime.getRuntime().loadLibrary() method.
Process	run(String file) Method to load a file with the associated application.

Methods inherited from class java.lang.Object

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

Method Detail

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.

Parameters:

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

Supported API: true

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.

Parameters:

command - the command to be executed

Supported API: true

Throws:

WTSecurityException

IOException

exec

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

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

Parameters:

cmdarray - array containing the command to call and its arguments

envp - array containing environment in format name=value

Supported API: true

Throws:

WTSecurityException

IOException

exec

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

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

Parameters:

cmdarray - array containing the command to call and its arguments

envp - array containing environment in format name=value

workDir - working directory of subprocess

Supported API: true

Throws:

WTSecurityException

IOException

run

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

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://"

Parameters:

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

Supported API: true

Throws:

WTSecurityException

IOException

load

public final void load(String filename)
                throws WTSecurityException

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

Parameters:

filename - the file to load

Supported API: true

Throws:

WTSecurityException

loadLibrary

public final void loadLibrary(String libname)
                       throws WTSecurityException

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

Parameters:

libname - the name of the library

Supported API: true

Throws:

WTSecurityException