254 * description()} method of the underlying transport service. Both
255 * the AttachingConnector and the ListeningConnector will have two
256 * Connector {@link com.sun.jdi.connect.Connector$Argument Arguments}.
257 * A {@link com.sun.jdi.connect.Connector$StringArgument StringArgument}
258 * named <tt>address</tt> is the connector argument to specify the
259 * address to attach too, or to listen on. A
260 * {@link com.sun.jdi.connect.Connector$IntegerArgument IntegerArgument}
261 * named <tt>timeout</tt> is the connector argument to specify the
262 * timeout when attaching, or accepting. The timeout connector may be
263 * ignored depending on if the transport service supports an attach
264 * timeout or accept timeout.
265 *
266 * <p> Initialization of the virtual machine manager will fail, that is
267 * {@link com.sun.jdi.Bootstrap#virtualMachineManager()} will throw an
268 * error if the virtual machine manager is unable to create any
269 * connectors.
270 *
271 * @author Gordon Hirsch
272 * @since 1.3
273 */
274 public interface VirtualMachineManager {
275
276 /**
277 * Identifies the default connector. This connector should
278 * be used as the launching connector when selection of a
279 * connector with specific characteristics is unnecessary.
280 *
281 * @return the default {@link com.sun.jdi.connect.LaunchingConnector}
282 */
283 LaunchingConnector defaultConnector();
284
285 /**
286 * Returns the list of known {@link com.sun.jdi.connect.LaunchingConnector} objects.
287 * Any of the returned objects can be used to launch a new target
288 * VM and immediately create a {@link VirtualMachine} mirror for it.
289 *
290 * Note that a target VM launched by a launching connector is not
291 * guaranteed to be stable until after the {@link com.sun.jdi.event.VMStartEvent} has been
292 * received.
293 * @return a list of {@link com.sun.jdi.connect.LaunchingConnector} objects.
|
254 * description()} method of the underlying transport service. Both
255 * the AttachingConnector and the ListeningConnector will have two
256 * Connector {@link com.sun.jdi.connect.Connector$Argument Arguments}.
257 * A {@link com.sun.jdi.connect.Connector$StringArgument StringArgument}
258 * named <tt>address</tt> is the connector argument to specify the
259 * address to attach too, or to listen on. A
260 * {@link com.sun.jdi.connect.Connector$IntegerArgument IntegerArgument}
261 * named <tt>timeout</tt> is the connector argument to specify the
262 * timeout when attaching, or accepting. The timeout connector may be
263 * ignored depending on if the transport service supports an attach
264 * timeout or accept timeout.
265 *
266 * <p> Initialization of the virtual machine manager will fail, that is
267 * {@link com.sun.jdi.Bootstrap#virtualMachineManager()} will throw an
268 * error if the virtual machine manager is unable to create any
269 * connectors.
270 *
271 * @author Gordon Hirsch
272 * @since 1.3
273 */
274 @jdk.Supported
275 public interface VirtualMachineManager {
276
277 /**
278 * Identifies the default connector. This connector should
279 * be used as the launching connector when selection of a
280 * connector with specific characteristics is unnecessary.
281 *
282 * @return the default {@link com.sun.jdi.connect.LaunchingConnector}
283 */
284 LaunchingConnector defaultConnector();
285
286 /**
287 * Returns the list of known {@link com.sun.jdi.connect.LaunchingConnector} objects.
288 * Any of the returned objects can be used to launch a new target
289 * VM and immediately create a {@link VirtualMachine} mirror for it.
290 *
291 * Note that a target VM launched by a launching connector is not
292 * guaranteed to be stable until after the {@link com.sun.jdi.event.VMStartEvent} has been
293 * received.
294 * @return a list of {@link com.sun.jdi.connect.LaunchingConnector} objects.
|