org.eclipse.ptp.core.util

Class LaunchUtils

java.lang.Object

org.eclipse.ptp.core.util.LaunchUtils

public class LaunchUtils
extends java.lang.Object

Utility methods for managing launch configuration attributes.

Since:

6.0

Constructor Summary

Constructors

Constructor and Description
LaunchUtils() Constructor

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	getArguments(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the program arguments specified in the Arguments tab
static java.lang.String	getConnectionName(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the connection name specified in the Resources tab
static boolean	getCopyExecutable(org.eclipse.debug.core.ILaunchConfiguration configuration) Get if the executable shall be copied to remote target before launch.
static java.lang.String	getDebuggerExePath(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the debugger executable path
static java.lang.String	getDebuggerID(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the ID of the debugger for this launch
static boolean	getDebuggerStopInMainFlag(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the debugger "stop in main" flag
static java.lang.String	getDebuggerWorkDirectory(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the working directory for this debug session
static java.lang.String	getExecutablePath(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the absolute path of the executable to launch.
static java.lang.String[]	getProgramArguments(org.eclipse.debug.core.ILaunchConfiguration configuration) Convert application arguments to an array of strings.
static java.lang.String	getProgramName(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the name of the executable to launch
static java.lang.String	getProgramPath(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the path component of the executable to launch.
static org.eclipse.core.resources.IProject	getProject(java.lang.String project) Get the IProject object from the project name.
static java.lang.String	getProjectName(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the name of the project
static java.lang.String	getRemoteServicesId(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the remote services ID specified in the Resources tab (possibly implicitly)
static java.lang.String	getResourceManagerUniqueName(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the target controller to use for the launch
static java.lang.String	getSystemType(org.eclipse.debug.core.ILaunchConfiguration configuration) Given a launch configuration, find the system type that was been selected.
static java.lang.String	getTemplateName(org.eclipse.debug.core.ILaunchConfiguration configuration) Given a launch configuration, find the template name that was been selected.
static java.lang.String	getWorkingDirectory(org.eclipse.debug.core.ILaunchConfiguration configuration) Get the working directory for the application launch
static org.eclipse.core.resources.IWorkspaceRoot	getWorkspaceRoot() Get the workspace root.
static void	setConfigurationName(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy configuration, java.lang.String name) Set the name of the launch configuration
static void	setConnectionName(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy configuration, java.lang.String name) Set the connection name attribute
static void	setRemoteServicesId(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy configuration, java.lang.String id) Set the remote services ID attribute
static void	setResourceManagerUniqueName(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy configuration, java.lang.String id) Set the target controller used for the launch
static void	setSystemType(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy configuration, java.lang.String type) Set the target system type used for the launch
static void	setWorkingDirectory(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy configuration, java.lang.String dir) Set the working directory

Methods inherited from class java.lang.Object

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

Constructor Detail

LaunchUtils

public LaunchUtils()

Constructor

Method Detail

getArguments

public static java.lang.String getArguments(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                     throws org.eclipse.core.runtime.CoreException

Get the program arguments specified in the Arguments tab

Parameters:

configuration -

Returns:

program arguments string

Throws:

org.eclipse.core.runtime.CoreException

getConnectionName

public static java.lang.String getConnectionName(org.eclipse.debug.core.ILaunchConfiguration configuration)

Get the connection name specified in the Resources tab

Parameters:

configuration -

Returns:

connection name

Since:

6.0

getCopyExecutable

public static boolean getCopyExecutable(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                 throws org.eclipse.core.runtime.CoreException

Get if the executable shall be copied to remote target before launch.

Parameters:

configuration -

Returns:

copy executable attribute

Throws:

org.eclipse.core.runtime.CoreException

getDebuggerExePath

public static java.lang.String getDebuggerExePath(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                           throws org.eclipse.core.runtime.CoreException

Get the debugger executable path

Parameters:

configuration -

Returns:

debugger executable path

Throws:

org.eclipse.core.runtime.CoreException

getDebuggerID

public static java.lang.String getDebuggerID(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                      throws org.eclipse.core.runtime.CoreException

Get the ID of the debugger for this launch

Parameters:

configuration -

Returns:

debugger ID

Throws:

org.eclipse.core.runtime.CoreException

getDebuggerStopInMainFlag

public static boolean getDebuggerStopInMainFlag(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                         throws org.eclipse.core.runtime.CoreException

Get the debugger "stop in main" flag

Parameters:

configuration -

Returns:

"stop in main" flag

Throws:

org.eclipse.core.runtime.CoreException

getDebuggerWorkDirectory

public static java.lang.String getDebuggerWorkDirectory(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                                 throws org.eclipse.core.runtime.CoreException

Get the working directory for this debug session

Parameters:

configuration -

Returns:

working directory

Throws:

org.eclipse.core.runtime.CoreException

getExecutablePath

public static java.lang.String getExecutablePath(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                          throws org.eclipse.core.runtime.CoreException

Get the absolute path of the executable to launch. If the executable is on a remote machine, this is the path to the executable on that machine.

Parameters:

configuration -

Returns:

executable path

Throws:

org.eclipse.core.runtime.CoreException

getProgramArguments

public static java.lang.String[] getProgramArguments(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                              throws org.eclipse.core.runtime.CoreException

Convert application arguments to an array of strings.

Parameters:

configuration - launch configuration

Returns:

array of strings containing the program arguments

Throws:

org.eclipse.core.runtime.CoreException

getProgramName

public static java.lang.String getProgramName(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                       throws org.eclipse.core.runtime.CoreException

Get the name of the executable to launch

Parameters:

configuration -

Returns:

program name

Throws:

org.eclipse.core.runtime.CoreException

getProgramPath

public static java.lang.String getProgramPath(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                       throws org.eclipse.core.runtime.CoreException

Get the path component of the executable to launch.

Parameters:

configuration -

Returns:

program path

Throws:

org.eclipse.core.runtime.CoreException

Since:

5.0

getProject

public static org.eclipse.core.resources.IProject getProject(java.lang.String project)

Get the IProject object from the project name.

Parameters:

project - name of the project

Returns:

IProject resource

getProjectName

public static java.lang.String getProjectName(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                       throws org.eclipse.core.runtime.CoreException

Get the name of the project

Parameters:

configuration -

Returns:

project name specified in the Application tab

Throws:

org.eclipse.core.runtime.CoreException

getRemoteServicesId

public static java.lang.String getRemoteServicesId(org.eclipse.debug.core.ILaunchConfiguration configuration)

Get the remote services ID specified in the Resources tab (possibly implicitly)

Parameters:

configuration -

Returns:

remote services ID

Since:

6.0

getResourceManagerUniqueName

public static java.lang.String getResourceManagerUniqueName(org.eclipse.debug.core.ILaunchConfiguration configuration)

Get the target controller to use for the launch

Parameters:

configuration -

Returns:

Throws:

org.eclipse.core.runtime.CoreException

getSystemType

public static java.lang.String getSystemType(org.eclipse.debug.core.ILaunchConfiguration configuration)

Given a launch configuration, find the system type that was been selected.

Parameters:

configuration -

Returns:

resource manager type

Throws:

org.eclipse.core.runtime.CoreException

Since:

6.0

getTemplateName

public static java.lang.String getTemplateName(org.eclipse.debug.core.ILaunchConfiguration configuration)

Given a launch configuration, find the template name that was been selected.

Parameters:

configuration -

Returns:

resource manager type

Throws:

org.eclipse.core.runtime.CoreException

Since:

6.0

getWorkingDirectory

public static java.lang.String getWorkingDirectory(org.eclipse.debug.core.ILaunchConfiguration configuration)
                                            throws org.eclipse.core.runtime.CoreException

Get the working directory for the application launch

Parameters:

configuration -

Returns:

Throws:

org.eclipse.core.runtime.CoreException

Since:

5.0

getWorkspaceRoot

public static org.eclipse.core.resources.IWorkspaceRoot getWorkspaceRoot()

Get the workspace root.

Returns:

workspace root

setConnectionName

public static void setConnectionName(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy configuration,
                     java.lang.String name)

Set the connection name attribute

Parameters:

configuration -

name - connection name

Since:

6.0

setRemoteServicesId

public static void setRemoteServicesId(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy configuration,
                       java.lang.String id)

Set the remote services ID attribute

Parameters:

configuration -

id - remote services ID

Since:

6.0

setResourceManagerUniqueName

public static void setResourceManagerUniqueName(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy configuration,
                                java.lang.String id)

Set the target controller used for the launch

Parameters:

configuration -

Since:

6.0

setSystemType

public static void setSystemType(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy configuration,
                 java.lang.String type)

Set the target system type used for the launch

Parameters:

configuration -

type - target system type

Since:

6.0

setConfigurationName

public static void setConfigurationName(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy configuration,
                        java.lang.String name)

Set the name of the launch configuration

Parameters:

configuration -

name - configuration name

Since:

6.0

setWorkingDirectory

public static void setWorkingDirectory(org.eclipse.debug.core.ILaunchConfigurationWorkingCopy configuration,
                       java.lang.String dir)
                                throws org.eclipse.core.runtime.CoreException

Set the working directory

Parameters:

configuration -

dir -

Throws:

org.eclipse.core.runtime.CoreException

Since:

5.0