co.paralleluniverse.capsule.container

Class CapsuleContainer

java.lang.Object

co.paralleluniverse.capsule.container.CapsuleContainer

All Implemented Interfaces:

CapsuleContainerMXBean

Direct Known Subclasses:

MBeanCapsuleContainer

public class CapsuleContainer
extends Object
implements CapsuleContainerMXBean

Launches, monitors and manages capsules.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	CapsuleContainer.ProcessInfo

Field Summary

Fields

Modifier and Type	Field and Description
static String	CAPSULE_PROCESS_KILLED
static String	CAPSULE_PROCESS_LAUNCHED

Constructor Summary

Constructors

Constructor and Description
CapsuleContainer(Path cacheDir) Constructs a new capsule container

Method Summary

Methods

Modifier and Type	Method and Description
protected ProcessBuilder	configureCapsuleProcess(ProcessBuilder pb) May be overridden to pipe app IO streams.
protected NotificationBroadcasterSupport	createEmitter()
protected String	createProcessId(String appId, Process p) Generates a unique id for a process
protected Class<?>	getMBeanInterface()
Process	getProcess(String id)
Set<String>	getProcesses() Returns the IDs of all currently running managed processes.
protected Map<String,CapsuleContainer.ProcessInfo>	getProcessInfo() Returns information about all managed processes.
protected CapsuleContainer.ProcessInfo	getProcessInfo(String id) Returns information about a process
void	killProcess(String id) Kills a managed process
String	launchCapsule(Path capsulePath, List<String> jvmArgs, List<String> args) Launch and monitor a capsule.
protected CapsuleContainer.ProcessInfo	mountProcess(Process p, String id, String capsuleId, List<String> jvmArgs, List<String> args)
protected void	onProcessDeath(String id, CapsuleContainer.ProcessInfo pi, int exitValue) Called a a process has died.
protected void	onProcessLaunch(String id, CapsuleContainer.ProcessInfo pi) Called a a process has been launched.

Methods inherited from class java.lang.Object

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

Field Detail

CAPSULE_PROCESS_LAUNCHED

public static final String CAPSULE_PROCESS_LAUNCHED

See Also:

Constant Field Values

CAPSULE_PROCESS_KILLED

public static final String CAPSULE_PROCESS_KILLED

See Also:

Constant Field Values

Constructor Detail

CapsuleContainer

public CapsuleContainer(Path cacheDir)

Constructs a new capsule container

Parameters:

cacheDir - the path of the directory to hold capsules' caches

Method Detail

getMBeanInterface

protected Class<?> getMBeanInterface()

createEmitter

protected NotificationBroadcasterSupport createEmitter()

launchCapsule

public String launchCapsule(Path capsulePath,
                   List<String> jvmArgs,
                   List<String> args)
                     throws IOException

Launch and monitor a capsule.

Parameters:

capsulePath - the capsule file

jvmArgs - the JVM arguments for the capsule

args - the arguments of the capsule's application

Returns:

a unique process ID

Throws:

IOException

mountProcess

protected CapsuleContainer.ProcessInfo mountProcess(Process p,
                                        String id,
                                        String capsuleId,
                                        List<String> jvmArgs,
                                        List<String> args)
                                             throws IOException,
                                                    InstanceAlreadyExistsException

Throws:

IOException

InstanceAlreadyExistsException

configureCapsuleProcess

protected ProcessBuilder configureCapsuleProcess(ProcessBuilder pb)
                                          throws IOException

May be overridden to pipe app IO streams.

Parameters:

pb - The capsule's ProcessBuilder.

Returns:

pb

Throws:

IOException

onProcessLaunch

protected void onProcessLaunch(String id,
                   CapsuleContainer.ProcessInfo pi)

Called a a process has been launched.

Parameters:

id - the process ID

pi - the CapsuleContainer.ProcessInfo object for the process

onProcessDeath

protected void onProcessDeath(String id,
                  CapsuleContainer.ProcessInfo pi,
                  int exitValue)

Called a a process has died.

Parameters:

id - the process ID

pi - the CapsuleContainer.ProcessInfo object for the process

exitValue - the process's exit value

createProcessId

protected String createProcessId(String appId,
                     Process p)

Generates a unique id for a process

Parameters:

appId - the capsule's app ID

p - the process

Returns:

a unique process ID

getProcessInfo

protected final Map<String,CapsuleContainer.ProcessInfo> getProcessInfo()

Returns information about all managed processes.

Returns:

a map from process IDs to their respective CapsuleContainer.ProcessInfo objects.

getProcessInfo

protected CapsuleContainer.ProcessInfo getProcessInfo(String id)

Returns information about a process

Parameters:

id - the process ID

Returns:

the process's CapsuleContainer.ProcessInfo object/

getProcess

public final Process getProcess(String id)

Parameters:

id - the process ID (as returned from launchCapsule.

Returns:

the process

getProcesses

public final Set<String> getProcesses()

Returns the IDs of all currently running managed processes.

Specified by:

getProcesses in interface CapsuleContainerMXBean

killProcess

public final void killProcess(String id)

Kills a managed process

Specified by:

killProcess in interface CapsuleContainerMXBean

Parameters:

id - the process's ID