Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 


Eclipse JDT
Release 3.5

org.eclipse.jdt.launching
Interface IVMConnector


public interface IVMConnector

A VM connector establishes a JDI connection with a debuggable virtual machine. This extension point provides a mechanism for abstracting the connection to a remote virtual machine.

A VM connector extension is defined in plugin.xml. Following is an example definition of a VM connector extension.

 <extension point="org.eclipse.jdt.launching.vmConnectors">
   <vmConnector 
      id="com.example.VMConnector"
      class="com.example.VMConnectorClass"
   </vmConnector>
 </extension>
 
The attributes are specified as follows:
  • id specifies a unique identifier for this VM connector.
  • class specifies the fully qualified name of the Java class that implements IVMConnector.

Since:
2.0

Method Summary
 void connect ( Map arguments, IProgressMonitor monitor, ILaunch launch)
          Establishes a JDI connection with a debuggable VM using the arguments specified in the given map, contributing results (debug targets and processes), to the given launch.
  List getArgumentOrder ()
          Returns a list of argument names found in this connector's default argument map, defining the order in which arguments should be presented to the user.
  Map getDefaultArguments ()
          Returns a map of default arguments used by this connector.
  String getIdentifier ()
          Returns a unique identifier for this kind of connector.
  String getName ()
          Returns the name of this connector.
 

Method Detail

connect

void connect(
Map arguments,
             
IProgressMonitor monitor,
             
ILaunch launch)
             throws 
CoreException
Establishes a JDI connection with a debuggable VM using the arguments specified in the given map, contributing results (debug targets and processes), to the given launch.

Parameters:
arguments - Argument map to use in establishing a connection. The keys of the map are strings corresponding to the names of arguments returned by this connector's getDefaultAgruments() method. The values of the map are strings corresponding to the (String) values of the associated com.sun.jdi.connect.Connector.Arguments to use.
monitor - progress monitor
launch - launch to contribute debug target(s) and/or process(es) to
Throws:
CoreException - if unable to establish a connection with the target VM

getName

String getName()
Returns the name of this connector.

Returns:
the name of this connector

getIdentifier

String getIdentifier()
Returns a unique identifier for this kind of connector.

Returns:
a unique identifier for this kind of connector

getDefaultArguments

Map getDefaultArguments()
                        throws 
CoreException
Returns a map of default arguments used by this connector. The keys of the map are names of arguments used by this connector, and the values are of type com.sun.jdi.connect.Connector.Argument.

Returns:
argument map with default values
Throws:
CoreException - if unable to retrieve a default argument map

getArgumentOrder

List getArgumentOrder()
Returns a list of argument names found in this connector's default argument map, defining the order in which arguments should be presented to the user. Since a map is not ordered, this provides control on how arguments will be presented to the user.

Returns:
list of argument names

Eclipse JDT
Release 3.5

Copyright (c) IBM Corp. and others 2000, 2008. All Rights Reserved.

 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire