com.iizigo.server.launch

Class DevelServerLaunchConfigurationDelegate

java.lang.Object

org.eclipse.debug.core.model.LaunchConfigurationDelegate

org.eclipse.jdt.launching.AbstractJavaLaunchConfigurationDelegate

com.iizigo.server.launch.DevelServerLaunchConfigurationDelegate

All Implemented Interfaces:

IDebugEventSetListener, ILaunchConfigurationDelegate, ILaunchConfigurationDelegate2

public class DevelServerLaunchConfigurationDelegate
extends AbstractJavaLaunchConfigurationDelegate

The iizi Development Server delegate launcher.

This delegate is used for the iizi Development Server to verify that the configuration is still valid as the configuration file resides separately, loads various configurations from it and then launches the Java VM with the JettyRunConfiguration class.

Author:

Christopher Mindus

Field Summary

Fields inherited from class org.eclipse.debug.core.model.LaunchConfigurationDelegate

complileErrorProjectPromptStatus, complileErrorPromptStatus, promptStatus, saveScopedDirtyEditors, switchToDebugPromptStatus

Constructor Summary

Constructors

Constructor and Description
DevelServerLaunchConfigurationDelegate() Constructor.

Method Summary

Modifier and Type	Method and Description
boolean	buildForLaunch(ILaunchConfiguration configuration, String mode, IProgressMonitor monitor) Optionally performs any required building before launching the given configuration in the specified mode, and returns whether the debug platform should perform an incremental workspace build before the launch continues.
boolean	finalLaunchCheck(ILaunchConfiguration configuration, String mode, IProgressMonitor monitor) Returns whether a launch should proceed.
String[]	getClasspath(ILaunchConfiguration configuration) Returns the entries that should appear on the user portion of the classpath as specified by the given launch configuration, as an array of resolved strings.
void	launch(ILaunchConfiguration configuration, String mode, ILaunch launch, IProgressMonitor monitor) Launches the given configuration in the specified mode, contributing debug targets and/or processes to the given launch object.
boolean	preLaunchCheck(ILaunchConfiguration configuration, String mode, IProgressMonitor monitor) Returns whether a launch should proceed.

Methods inherited from class org.eclipse.jdt.launching.AbstractJavaLaunchConfigurationDelegate

abort, allowAdvancedSourcelookup, getBootpath, getBootpathExt, getBreakpoints, getBuildOrder, getClasspathAndModulepath, getDefaultWorkingDirectory, getEnvironment, getJavaLibraryPath, getJavaProject, getJavaProjectName, getLaunch, getLaunchManager, getMainTypeName, getModuleCLIOptions, getProgramArguments, getProjectsForProblemSearch, getVMArguments, getVMArguments, getVMConnectorId, getVMInstall, getVMInstallName, getVMInstallType, getVMInstallTypeId, getVMRunner, getVMSpecificAttributesMap, getWorkingDirectory, getWorkingDirectoryPath, handleDebugEvents, isAllowTerminate, isLaunchProblem, isStopInMain, prepareStopInMain, setDefaultSourceLocator, supportsModule, supportsPreviewFeatures, verifyJavaProject, verifyMainTypeName, verifyVMInstall, verifyWorkingDirectory

Methods inherited from class org.eclipse.debug.core.model.LaunchConfigurationDelegate

addReferencedProjects, buildProjects, computeBuildOrder, computeReferencedBuildOrder, existsProblems, saveBeforeLaunch

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.debug.core.model.ILaunchConfigurationDelegate

showCommandLine

Constructor Detail

DevelServerLaunchConfigurationDelegate

public DevelServerLaunchConfigurationDelegate()

Constructor.

Method Detail

preLaunchCheck

public boolean preLaunchCheck(ILaunchConfiguration configuration,
                              String mode,
                              IProgressMonitor monitor)
                       throws CoreException

Returns whether a launch should proceed. This method is called first in the launch sequence providing an opportunity for this launch delegate to abort the launch.

Specified by:

preLaunchCheck in interface ILaunchConfigurationDelegate2

Overrides:

preLaunchCheck in class AbstractJavaLaunchConfigurationDelegate

Parameters:

configuration - Configuration being launched.

mode - Launch mode.

monitor - The progress monitor, or null.

Returns:

Whether the launch should proceed.

Throws:

CoreException - If an exception occurs while performing pre-launch checks.

buildForLaunch

public boolean buildForLaunch(ILaunchConfiguration configuration,
                              String mode,
                              IProgressMonitor monitor)
                       throws CoreException

Optionally performs any required building before launching the given configuration in the specified mode, and returns whether the debug platform should perform an incremental workspace build before the launch continues. If false is returned the launch will proceed without further building, and if true is returned an incremental build will be performed on the workspace before launching.

This method is only called if the launch is invoked with flag indicating building should take place before the launch. This is done via the method ILaunchConfiguration.launch(String mode, IProgressMonitor monitor, boolean build).

Specified by:

buildForLaunch in interface ILaunchConfigurationDelegate2

Overrides:

buildForLaunch in class LaunchConfigurationDelegate

Parameters:

configuration - The configuration being launched.

mode - Launch mode.

monitor - The Progress monitor, or null.

Returns:

Whether the debug platform should perform an incremental workspace build before the launch.

Throws:

CoreException - If an exception occurs while building.

finalLaunchCheck

public boolean finalLaunchCheck(ILaunchConfiguration configuration,
                                String mode,
                                IProgressMonitor monitor)
                         throws CoreException

Returns whether a launch should proceed. This method is called after preLaunchCheck() and buildForLaunch() providing a final chance for this launch delegate to abort a launch if required. For example, a delegate could cancel a launch if it discovered compilation errors that would prevent the launch from succeeding.

Specified by:

finalLaunchCheck in interface ILaunchConfigurationDelegate2

Overrides:

finalLaunchCheck in class LaunchConfigurationDelegate

Parameters:

configuration - The configuration being launched.

mode - Launch mode.

monitor - The Progress monitor, or null.

Returns:

Whether the launch should proceed.

Throws:

CoreException - If an exception occurs during final checks.

launch

public void launch(ILaunchConfiguration configuration,
                   String mode,
                   ILaunch launch,
                   IProgressMonitor monitor)
            throws CoreException

Launches the given configuration in the specified mode, contributing debug targets and/or processes to the given launch object. The launch object has already been registered with the launch manager.

Parameters:

configuration - The configuration to launch.

mode - The mode in which to launch, one of the mode constants defined by ILaunchManager, i.e. RUN_MODE or DEBUG_MODE.

monitor - The progress monitor, or null progress monitor, or null.

launch - The launch object to contribute processes and debug targets to.

Throws:

CoreException - If launching fails.

getClasspath

public String[] getClasspath(ILaunchConfiguration configuration)
                      throws CoreException

Returns the entries that should appear on the user portion of the classpath as specified by the given launch configuration, as an array of resolved strings. The returned array is empty if no classpath is specified.

Overridden superclass code to add the classpath of the server first.

Overrides:

getClasspath in class AbstractJavaLaunchConfigurationDelegate

Parameters:

configuration - launch configuration.

Returns:

the classpath specified by the given launch configuration.

Throws:

CoreException - If unable to retrieve the attribute.