org.ow2.proactive.scheduler.common.task

Class ForkEnvironment

java.lang.Object

org.ow2.proactive.scheduler.common.task.ForkEnvironment

All Implemented Interfaces:

Serializable

@PublicAPI
public class ForkEnvironment
extends Object
implements Serializable

Class representing a forked environment of a JVM created specifically for an execution of a Java Task. A Java Task can be executed in the current JVM - then all Java Tasks are dependent on the same JVM (provider) and JVM options (like memory), or can be executed in a dedicated JVM with additional options specified like javaHome, javaArguments, classpath, ...

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ForkEnvironment()
ForkEnvironment(ForkEnvironment forkEnvironment) Copy constructor.
ForkEnvironment(String workingDir)

Method Summary

Modifier and Type	Method and Description
void	addAdditionalClasspath(String... values)
void	addAdditionalClasspath(String value) Add a new additional Classpath value.
void	addJVMArgument(String value) Add a new JVM argument value.
String	addSystemEnvironmentVariable(String name, String value) Add a new system environment variables value from its name and value.
List<String>	getAdditionalClasspath() Return a copy of the additional classpath, empty list if no arguments.
Script<?>	getEnvScript() Get the environment script.
String	getJavaHome() Returns the javaHome.
List<String>	getJVMArguments() Return a copy of the JVM arguments, empty list if no arguments.
Map<String,String>	getSystemEnvironment() Return a copy of the system environment, empty map if no variables.
String	getSystemEnvironmentVariable(String name) Get the system environment variable value associated with the given name.
String	getWorkingDir() Return the working Directory.
void	setEnvScript(Script<?> script) Set the environment script value to the given script value.
void	setJavaHome(String javaHome) Sets the javaHome to the given javaHome value.
void	setWorkingDir(String workingDir) Set the working directory value to the given workingDir value.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ForkEnvironment

public ForkEnvironment()

ForkEnvironment

public ForkEnvironment(ForkEnvironment forkEnvironment)
                throws ExecutableCreationException

Copy constructor.

Parameters:

forkEnvironment - the object to copy

Throws:

ExecutableCreationException - script copy failed

ForkEnvironment

public ForkEnvironment(String workingDir)

Method Detail

getJavaHome

public String getJavaHome()

Returns the javaHome.

Returns:

the javaHome.

setJavaHome

public void setJavaHome(String javaHome)

Sets the javaHome to the given javaHome value.

Parameters:

javaHome - the javaHome to set.

getWorkingDir

public String getWorkingDir()

Return the working Directory.

Returns:

the working Directory.

setWorkingDir

public void setWorkingDir(String workingDir)

Set the working directory value to the given workingDir value.

Parameters:

workingDir - the working directory to set

getSystemEnvironment

public Map<String,String> getSystemEnvironment()

Return a copy of the system environment, empty map if no variables.

Returns:

a copy of the system environment, empty map if no variables.

getSystemEnvironmentVariable

public String getSystemEnvironmentVariable(String name)

Get the system environment variable value associated with the given name.

Parameters:

name - the name of the variable value to get

Returns:

the system variable value associated with the given name, or null if the variable does not exist.

addSystemEnvironmentVariable

public String addSystemEnvironmentVariable(String name,
                                           String value)

Add a new system environment variables value from its name and value.

Parameters:

name - the name of the variable to add

value - the the value associated to the given name

Returns:

the previous value associated to the system environment variable.

Throws:

IllegalArgumentException - if name is null

getJVMArguments

public List<String> getJVMArguments()

Return a copy of the JVM arguments, empty list if no arguments.

Returns:

a copy of the JVM arguments, empty list if no arguments.

addJVMArgument

public void addJVMArgument(String value)

Add a new JVM argument value. (-Dname=value, -Xmx=.., -server)

Parameters:

value - the value of the property to be added.

Throws:

IllegalArgumentException - if value is null.

getAdditionalClasspath

public List<String> getAdditionalClasspath()

Return a copy of the additional classpath, empty list if no arguments.

Returns:

a copy of the additional classpath, empty list if no arguments.

addAdditionalClasspath

public void addAdditionalClasspath(String... values)

addAdditionalClasspath

public void addAdditionalClasspath(String value)

Add a new additional Classpath value.

Parameters:

value - the additional Classpath to add.

Throws:

IllegalArgumentException - if value is null.

getEnvScript

public Script<?> getEnvScript()

Get the environment script.

Returns:

the environment script.

setEnvScript

public void setEnvScript(Script<?> script)

Set the environment script value to the given script value.

This script allows the user to programmatically set system variables, JVM arguments, additional classpath, etc. Use the binding variable name forkEnvironment to fill this object in this given script.

Parameters:

script - the script to set

toString

public String toString()

Overrides:

toString in class Object