aQute.bnd.build

Class ProjectLauncher

java.lang.Object

aQute.bnd.build.ProjectLauncher

Direct Known Subclasses:

JUnitLauncher

public abstract class ProjectLauncher
extends java.lang.Object

A Project Launcher is a base class to be extended by launchers. Launchers are JARs that launch a framework and install a number of bundles and then run the framework. A launcher jar must specify a Launcher-Class manifest header. This class is instantiated and cast to a LauncherPlugin. This plug in is then asked to provide a ProjectLauncher. This project launcher is then used by the project to run the code. Launchers must extend this class.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ProjectLauncher.NotificationListener
static class	ProjectLauncher.NotificationType

Field Summary

Fields

Modifier and Type	Field and Description
static int	ACTIVATOR_ERROR
static int	CANCELED
static int	CUSTOM_LAUNCHER
static int	DUPLICATE_BUNDLE
static java.lang.String	EMBEDDED_ACTIVATOR
static int	ERROR
static int	NONE
static int	OK
static int	RESOLVE_ERROR
static int	SERVICES
static int	TIMEDOUT
static int	UPDATE_NEEDED
static int	WARNING

Constructor Summary

Constructors

Constructor and Description
ProjectLauncher(Project project)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	addActivator(java.lang.String e)
protected void	addClasspath(java.util.Collection<Container> path)
void	addClasspath(Container container)
void	addDefault(java.lang.String defaultSpec) Add the specification for a set of bundles the runpath if it does not already is included.
void	addRunBundle(java.lang.String f)
void	addRunProgramArgs(java.lang.String arg)
void	addRunVM(java.lang.String arg)
void	cancel()
void	cleanup() Is called after the process exists.
void	clear()
protected void	error(java.lang.String message, java.lang.Object... args)
Jar	executable() Create a self executable.
java.util.Collection<java.lang.String>	getActivators()
java.util.Collection<java.lang.String>	getArguments() Deprecated.
java.util.Collection<java.lang.String>	getClasspath()
java.io.File	getCwd()
java.util.List<java.lang.String>	getErrors()
abstract java.lang.String	getMainTypeName()
java.util.Set<ProjectLauncher.NotificationListener>	getNotificationListeners()
Project	getProject()
java.util.Collection<java.lang.String>	getRunBundles()
java.util.Map<java.lang.String,java.lang.String>	getRunEnv()
int	getRunFramework() Either NONE or SERVICES to indicate how the remote end launches.
java.lang.String	getRunJdb()
java.util.List<java.lang.String>	getRunpath()
java.util.Collection<java.lang.String>	getRunProgramArgs()
java.util.Map<java.lang.String,java.lang.String>	getRunProperties()
java.util.Collection<java.lang.String>	getRunVM()
java.io.File	getStorageDir()
java.lang.String	getSystemCapabilities()
java.util.Map<java.lang.String,? extends java.util.Map<java.lang.String,java.lang.String>>	getSystemPackages()
long	getTimeout()
boolean	getTrace()
java.util.List<java.lang.String>	getWarnings()
protected int	invoke(java.lang.Class<?> main, java.lang.String[] args)
boolean	isKeep()
int	launch()
abstract void	prepare() Should be called when all the changes to the launchers are set.
void	registerForNotifications(ProjectLauncher.NotificationListener listener)
protected void	reportResult(int result)
void	setCwd(java.io.File cwd)
void	setKeep(boolean keep)
void	setRunFramework(int n)
void	setTimeout(long timeout, java.util.concurrent.TimeUnit unit)
void	setTrace(boolean level)
int	start(java.lang.ClassLoader parent)
abstract void	update()
protected void	updateFromProject() Collect all the aspect from the project and set the local fields from them.
protected void	warning(java.lang.String message, java.lang.Object... args)

Methods inherited from class java.lang.Object

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

Field Detail

SERVICES

public static final int SERVICES

See Also:

Constant Field Values

NONE

public static final int NONE

See Also:

Constant Field Values

OK

public static final int OK

See Also:

Constant Field Values

WARNING

public static final int WARNING

See Also:

Constant Field Values

ERROR

public static final int ERROR

See Also:

Constant Field Values

TIMEDOUT

public static final int TIMEDOUT

See Also:

Constant Field Values

UPDATE_NEEDED

public static final int UPDATE_NEEDED

See Also:

Constant Field Values

CANCELED

public static final int CANCELED

See Also:

Constant Field Values

DUPLICATE_BUNDLE

public static final int DUPLICATE_BUNDLE

See Also:

Constant Field Values

RESOLVE_ERROR

public static final int RESOLVE_ERROR

See Also:

Constant Field Values

ACTIVATOR_ERROR

public static final int ACTIVATOR_ERROR

See Also:

Constant Field Values

CUSTOM_LAUNCHER

public static final int CUSTOM_LAUNCHER

See Also:

Constant Field Values

EMBEDDED_ACTIVATOR

public static final java.lang.String EMBEDDED_ACTIVATOR

See Also:

Constant Field Values

Constructor Detail

ProjectLauncher

public ProjectLauncher(Project project)
                throws java.lang.Exception

Throws:

java.lang.Exception

Method Detail

updateFromProject

protected void updateFromProject()
                          throws java.lang.Exception

Collect all the aspect from the project and set the local fields from them. Should be called

Throws:

java.lang.Exception

addClasspath

public void addClasspath(Container container)
                  throws java.lang.Exception

Throws:

java.lang.Exception

addClasspath

protected void addClasspath(java.util.Collection<Container> path)
                     throws java.lang.Exception

Throws:

java.lang.Exception

addRunBundle

public void addRunBundle(java.lang.String f)

getRunBundles

public java.util.Collection<java.lang.String> getRunBundles()

addRunVM

public void addRunVM(java.lang.String arg)

addRunProgramArgs

public void addRunProgramArgs(java.lang.String arg)

getRunpath

public java.util.List<java.lang.String> getRunpath()

getClasspath

public java.util.Collection<java.lang.String> getClasspath()

getRunVM

public java.util.Collection<java.lang.String> getRunVM()

getArguments

@Deprecated
public java.util.Collection<java.lang.String> getArguments()

Deprecated.

getRunProgramArgs

public java.util.Collection<java.lang.String> getRunProgramArgs()

getRunProperties

public java.util.Map<java.lang.String,java.lang.String> getRunProperties()

getStorageDir

public java.io.File getStorageDir()

getMainTypeName

public abstract java.lang.String getMainTypeName()

update

public abstract void update()
                     throws java.lang.Exception

Throws:

java.lang.Exception

launch

public int launch()
           throws java.lang.Exception

Throws:

java.lang.Exception

start

public int start(java.lang.ClassLoader parent)
          throws java.lang.Exception

Throws:

java.lang.Exception

invoke

protected int invoke(java.lang.Class<?> main,
         java.lang.String[] args)
              throws java.lang.Exception

Throws:

java.lang.Exception

cleanup

public void cleanup()

Is called after the process exists. Can you be used to cleanup the properties file.

reportResult

protected void reportResult(int result)

setTimeout

public void setTimeout(long timeout,
              java.util.concurrent.TimeUnit unit)

getTimeout

public long getTimeout()

cancel

public void cancel()

getSystemPackages

public java.util.Map<java.lang.String,? extends java.util.Map<java.lang.String,java.lang.String>> getSystemPackages()

getSystemCapabilities

public java.lang.String getSystemCapabilities()

setKeep

public void setKeep(boolean keep)

isKeep

public boolean isKeep()

setTrace

public void setTrace(boolean level)

getTrace

public boolean getTrace()

prepare

public abstract void prepare()
                      throws java.lang.Exception

Should be called when all the changes to the launchers are set. Will calculate whatever is necessary for the launcher.

Throws:

java.lang.Exception

getProject

public Project getProject()

addActivator

public boolean addActivator(java.lang.String e)

getActivators

public java.util.Collection<java.lang.String> getActivators()

getRunFramework

public int getRunFramework()

Either NONE or SERVICES to indicate how the remote end launches. NONE means it should not use the classpath to run a framework. This likely requires some dummy framework support. SERVICES means it should load the framework from the claspath.

Returns:

setRunFramework

public void setRunFramework(int n)

addDefault

public void addDefault(java.lang.String defaultSpec)
                throws java.lang.Exception

Add the specification for a set of bundles the runpath if it does not already is included. This can be used by subclasses to ensure the proper jars are on the classpath.

Parameters:

defaultSpec - The default spec for default jars

Throws:

java.lang.Exception

executable

public Jar executable()
               throws java.lang.Exception

Create a self executable.

Throws:

java.lang.Exception

clear

public void clear()

getErrors

public java.util.List<java.lang.String> getErrors()

getWarnings

public java.util.List<java.lang.String> getWarnings()

error

protected void error(java.lang.String message,
         java.lang.Object... args)

warning

protected void warning(java.lang.String message,
           java.lang.Object... args)

getCwd

public java.io.File getCwd()

setCwd

public void setCwd(java.io.File cwd)

getRunJdb

public java.lang.String getRunJdb()

getRunEnv

public java.util.Map<java.lang.String,java.lang.String> getRunEnv()

registerForNotifications

public void registerForNotifications(ProjectLauncher.NotificationListener listener)

getNotificationListeners

public java.util.Set<ProjectLauncher.NotificationListener> getNotificationListeners()