1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
|
/*******************************************************************************
* Copyright (c) 2012 Wind River Systems, Inc. and others. All rights reserved.
* This program and the accompanying materials are made available under the terms
* of the Eclipse Public License v1.0 which accompanies this distribution, and is
* available at http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* Wind River Systems - initial API and implementation
*******************************************************************************/
package org.eclipse.tcf.te.launch.core.lm.interfaces;
import org.eclipse.debug.core.ILaunchConfiguration;
import org.eclipse.debug.core.ILaunchConfigurationWorkingCopy;
import org.eclipse.tcf.te.launch.core.exceptions.LaunchServiceException;
import org.eclipse.tcf.te.launch.core.selection.interfaces.ILaunchSelection;
import org.eclipse.tcf.te.launch.core.selection.interfaces.ISelectionContext;
import org.eclipse.tcf.te.runtime.interfaces.extensions.IExecutableExtension;
/**
* Describes the interface used by the <code>LaunchManager</code> to create
* and manage the different types of possible launch configurations in a generalized,
* simple and abstract way. A <code>ILaunchManagerDelegate</code> is strictly bound
* to one specific <code>ILaunchConfigurationType</code> and is capable and responsible
* to initializing and handling launch configurations of this type. A launch manager
* delegate is contribute through the <code>org.eclipse.tcf.te.launch.core.launchManagerDelegates</code>
* extension point!
*/
public interface ILaunchManagerDelegate extends IExecutableExtension {
public static final int SITUATION_BEFORE_LAUNCH = 0;
public static final int SITUATION_AFTER_LAUNCH_FAILED = 99;
// Constants for signaling the type of found matches
/**
* Constant to signal to ignore this matching.
*/
public final static int IGNORE = -1;
/**
* Constant to signal a no match (no attributes are matching).
*/
public final static int NO_MATCH = 0;
/**
* Constant to signal a partial match (some attributes are matching).
*/
public final static int PARTIAL_MATCH = 1;
/**
* Constant to signal a full match (all attributes are matching).
*/
public final static int FULL_MATCH = 2;
/**
* Initialize the launch configuration attributes based on the specified launch specification. If an launch
* configuration attribute is not listed within the specified launch specification, the corresponding attribute is
* initialized with an default.
*
* @param wc The launch configuration working copy to initialize. Must not be <code>null</code>!
* @param launchSpec The launch specification. Must not be <code>null</code>!
*/
public void initLaunchConfigAttributes(ILaunchConfigurationWorkingCopy wc, ILaunchSpecification launchSpec);
/**
* Updates a found launch configuration based on the specified launch specification.
*
* @param wc The launch configuration working copy to initialize. Must not be <code>null</code>!
* @param launchSpec The launch specification. Must not be <code>null</code>!
*/
public void updateLaunchConfigAttributes(ILaunchConfigurationWorkingCopy wc, ILaunchSpecification launchSpec);
/**
* Updates a launch configuration with the given selection context.
*
* @param wc The launch configuration working copy.
* @param selContext The selection context to use for the update.
* @param replace <code>true</code> if existing attribute values should be replaced,
* <code>false</code> if data from the selection context should be added to existing values.
*/
public void updateLaunchConfig(ILaunchConfigurationWorkingCopy wc, ISelectionContext selContext, boolean replace);
/**
* Test the specified attribute if or if not the specified attribute value is an default value or not.
*
* @param attributeKey The attribute key/name. Must not be <code>null</code>.
* @param specValue The launch specification value.
* @param confValue The launch configuration value.
* @param launchSpec The launch specification which is the source of the <code>specValue</code>. Must not be <code>null</code>.
* @param launchConfig The launch configuration which is the source of the <code>confValue</code>. Must not be <code>null</code>.
* @param launchMode The launch mode. Default values may differ for different launch modes. Must not be
* <code>null</code>!
* @return <code>true</code> if the specified attribute value is the default value, <code>false</code> otherwise.
*/
public boolean isDefaultAttribute(String attributeKey, Object specValue, Object confValue, ILaunchSpecification launchSpec, ILaunchConfiguration launchConfig, String launchMode);
/**
* Returns a ranked list of launch configurations that best matches the given launch specification. In case of no
* results or a given empty or null launch configuration list an empty list should be returned. If no launch specification
* is given, the original list should be returned.
*
* @param launchSpec The launch specification the launch configurations should match.
* @param launchConfigs A full list of launch configurations to check for best matching.
* @return List of matching launch configurations starting with best match on first index.
* @throws LaunchServiceException
*/
public ILaunchConfiguration[] getMatchingLaunchConfigurations(ILaunchSpecification launchSpec, ILaunchConfiguration[] launchConfigs) throws LaunchServiceException;
/**
* Get the default launch configuration name.
*
* @param launchSpec The launch specification to create a default name for the launch config. Must not be <code>null</code>.
* @return The default launch configuration name.
*/
public String getDefaultLaunchName(ILaunchSpecification launchSpec);
/**
* Get the default launch configuration name.
*
* @param launchConfig The launch configuration to create a default name for the launch config. Must not be <code>null</code>.
* @return The default launch configuration name.
*/
public String getDefaultLaunchName(ILaunchConfiguration launchConfig);
/**
* Get a launch specification with all needed attributes for this delegate taken from the selection to find or create a new
* launch configuration.
*
* @param launchConfigTypeId The launch configuration type id.
* @param launchSelection The selected contexts.
* @return Launch specification with attributes set from selected contexts.
* @throws LaunchServiceException
*/
public ILaunchSpecification getLaunchSpecification(String launchConfigTypeId, ILaunchSelection launchSelection);
/**
* Validates a launch specification.
*
* @param launchSpec The launch specification to validate.
* @throws LaunchServiceException If validation fails with further information about the reason (e.q. missing
* attributes)
*/
public void validate(ILaunchSpecification launchSpec) throws LaunchServiceException;
/**
* Validates a launch configuration.
*
* @param launchConfig The launch configuration to validate.
* @param launchMode The launch mode.
* @throws LaunchServiceException If validation fails with further information about the reason (e.q. missing
* attributes)
*/
public void validate(String launchMode, ILaunchConfiguration launchConfig) throws LaunchServiceException;
/**
* Returns true, if the launch dialog should be shown before launch.
* @param situation The situation (before launch, after launch, ..)
*/
public boolean showLaunchDialog(int situation);
/**
* Return <code>true</code> if the two selection contexts are equal
* for this launch configuration type.
*
* @param ctx1 The first launch selection context or <code>null</code>.
* @param ctx2 The second launch selection context or <code>null</code>.
*
* @return <code>True</code> if the two selection contexts are equal for this launch configuration type, <code>false</code> otherwise.
*/
public boolean equals(ISelectionContext ctx1, ISelectionContext ctx2);
/**
* Get a short description for the given launch configuration.
* @param config The launch configuration.
* @return The description.
*/
public String getDescription(ILaunchConfiguration config);
}
|
