co.paralleluniverse.capsule

Class CapsuleLauncher

java.lang.Object

co.paralleluniverse.capsule.CapsuleLauncher

public final class CapsuleLauncher
extends Object

Provides methods for loading, inspecting, and launching capsules.

Constructor Summary

Constructors

Constructor and Description
CapsuleLauncher(Path jarFile)

Method Summary

Modifier and Type	Method and Description
static List<String>	enableJMX(List<String> jvmArgs) Adds an option to the JVM arguments to enable JMX connection
static Map<String,List<Path>>	findJavaHomes() Returns all known Java installations
Capsule	newCapsule() Creates a new capsule.
Capsule	newCapsule(Path wrappedJar) Creates a new capsule
Capsule	newCapsule(String mode) Creates a new capsule
Capsule	newCapsule(String mode, Path wrappedJar) Creates a new capsule
CapsuleLauncher	setCacheDir(Path dir) Sets the location of the cache directory for the capsules created by newCapsule
CapsuleLauncher	setJavaHomes(Map<String,List<Path>> javaHomes) Sets the Java homes that will be used by the capsules created by newCapsule.
CapsuleLauncher	setProperties(Properties properties) Sets the properties for the capsules created by newCapsule
CapsuleLauncher	setProperty(String property, String value) Sets a property for the capsules created by newCapsule

Methods inherited from class java.lang.Object

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

Constructor Detail

CapsuleLauncher

public CapsuleLauncher(Path jarFile)
                throws IOException

Throws:

IOException

Method Detail

setJavaHomes

public CapsuleLauncher setJavaHomes(Map<String,List<Path>> javaHomes)

Sets the Java homes that will be used by the capsules created by newCapsule.

Parameters:

javaHomes - a map from Java version strings to their respective JVM installation paths

Returns:

this

setProperties

public CapsuleLauncher setProperties(Properties properties)

Sets the properties for the capsules created by newCapsule

Parameters:

properties - the properties

Returns:

this

setProperty

public CapsuleLauncher setProperty(String property,
                                   String value)

Sets a property for the capsules created by newCapsule

Parameters:

property - the name of the property

value - the property's value

Returns:

this

setCacheDir

public CapsuleLauncher setCacheDir(Path dir)

Sets the location of the cache directory for the capsules created by newCapsule

Parameters:

dir - the cache directory

Returns:

this

newCapsule

public Capsule newCapsule()

Creates a new capsule.

newCapsule

public Capsule newCapsule(String mode)

Creates a new capsule

Parameters:

mode - the capsule mode

Returns:

the capsule.

newCapsule

public Capsule newCapsule(Path wrappedJar)

Creates a new capsule

Parameters:

wrappedJar - a path to a capsule JAR that will be launched (wrapped) by the empty capsule in jarFile or null if no wrapped capsule is wanted

Returns:

the capsule.

newCapsule

public Capsule newCapsule(String mode,
                          Path wrappedJar)

Creates a new capsule

Parameters:

mode - the capsule mode, or null for the default mode

wrappedJar - a path to a capsule JAR that will be launched (wrapped) by the empty capsule in jarFile or null if no wrapped capsule is wanted

Returns:

the capsule.

findJavaHomes

public static Map<String,List<Path>> findJavaHomes()

Returns all known Java installations

Returns:

a map from the version strings to their respective paths of the Java installations.

enableJMX

public static List<String> enableJMX(List<String> jvmArgs)

Adds an option to the JVM arguments to enable JMX connection

Parameters:

jvmArgs - the JVM args

Returns:

a new list of JVM args