Examples of com.sun.jdi.VirtualMachineManager

com.sun.jdi.VirtualMachineManager

A manager of connections to target virtual machines. The VirtualMachineManager allows one application to debug multiple target VMs. (Note that the converse is not supported; a target VM can be debugged by only one debugger application.) This interface contains methods to manage connections to remote target VMs and to obtain the {@link VirtualMachine}mirror for available target VMs.

Connections can be made using one of several different {@link com.sun.jdi.connect.Connector} objects. Each connector encapsulatesa different way of connecting the debugger with a target VM.

The VirtualMachineManager supports many different scenarios for connecting a debugger to a virtual machine. Four examples are presented in the table below. The examples use the command line syntax in Sun's implementation. Some {@link com.sun.jdi.connect.Connector} implementations may require slightlydifferent handling than presented below.

Scenario	Description
Debugger launches target VM (simplest, most-common scenario)	Debugger calls the {@link com.sun.jdi.connect.LaunchingConnector#launch(java.util.Map)}method of the default connector, obtained with {@link #defaultConnector}. The target VM is launched, and a connection between that VM and the debugger is established. A {@link VirtualMachine} mirror is returned. Or, for more control Debugger selects a connector from the list returned by {@link #launchingConnectors} with desired characteristics(for example, transport type, etc.). Debugger calls the {@link com.sun.jdi.connect.LaunchingConnector#launch(java.util.Map)}method of the selected connector. The target VM is launched, and a connection between that VM and the debugger is established. A {@link VirtualMachine} mirror is returned.
Debugger attaches to previously-running VM	Target VM is launched using the options `-agentlib:jdwp=transport=xxx,server=y` Target VM generates and outputs the tranport-specific address at which it will listen for a connection. Debugger is launched. Debugger selects a connector in the list returned by {@link #attachingConnectors} matching the transport withthe name "xxx". Debugger presents the default connector parameters (obtained through {@link com.sun.jdi.connect.Connector#defaultArguments()}) to the end user, allowing the user to fill in the transport-specific address generated by the target VM. Debugger calls the {@link com.sun.jdi.connect.AttachingConnector#attach(java.util.Map)} methodof the selected to attach to the target VM. A {@link VirtualMachine}mirror is returned.
Target VM attaches to previously-running debugger	At startup, debugger selects one or more connectors from the list returned by {@link #listeningConnectors} for one or moretransports. Debugger calls the {@link com.sun.jdi.connect.ListeningConnector#startListening(java.util.Map)} method for each selectedconnector. For each call, a transport-specific address string is generated and returned. The debugger makes the transport names and corresponding address strings available to the end user. Debugger calls {@link com.sun.jdi.connect.ListeningConnector#accept(java.util.Map)}for each selected connector to wait for a target VM to connect. Later, target VM is launched by end user with the options `-agentlib:jdwp=transport=xxx,address=yyy` where "xxx" the transport for one of the connectors selected by the the debugger and "yyy" is the address generated by {@link com.sun.jdi.connect.ListeningConnector#accept(java.util.Map)} for thattransport. Debugger's call to {@link com.sun.jdi.connect.ListeningConnector#accept(java.util.Map)} returnsa {@link VirtualMachine} mirror.
Target VM launches debugger (sometimes called "Just-In-Time" debugging)	Target VM is launched with the options `-agentlib:jdwp=launch=cmdline,onuncaught=y,transport=xxx,server=y` Later, an uncaught exception is thrown in the target VM. The target VM generates the tranport-specific address at which it will listen for a connection. Target VM launches the debugger with the following items concatenated together (separated by spaces) to form the command line: The launch= value The transport= value The generated transport-specific address at which VM is listening for debugger connection. Upon launch, debugger selects a connector in the list returned by {@link #attachingConnectors} matching the transport withthe name "xxx". Debugger changes the default connector parameters (obtained through {@link com.sun.jdi.connect.Connector#defaultArguments()}) to specify the transport specific address at which the VM is listenig. Optionally, other connector arguments can be presented to the user. Debugger calls the {@link com.sun.jdi.connect.AttachingConnector#attach(java.util.Map)} methodof the selected to attach to the target VM. A {@link VirtualMachine}mirror is returned.

Connectors are created at start-up time. That is, they are created the first time that {@link com.sun.jdi.Bootstrap#virtualMachineManager()} is invoked.The list of all Connectors created at start-up time can be obtained from the VirtualMachineManager by invoking the {@link #allConnectors allConnectors} method.

Connectors are created at start-up time if they are installed on the platform. In addition, Connectors are created automatically by the VirtualMachineManager to encapsulate any {@link com.sun.jdi.connect.spi.TransportService} implementationsthat are installed on the platform. These two mechanisms for creating Connectors are described here.

A Connector is installed on the platform if it is installed in a jar file that is visible to the defining class loader of the {@link com.sun.jdi.connect.Connector} type,and that jar file contains a provider configuration file named com.sun.jdi.connect.Connector in the resource directory META-INF/services, and the provider configuration file lists the full-qualified class name of the Connector implementation. A Connector is a class that implements the {@link com.sun.jdi.connect.Connector Connector} interface. Moreappropriately the class implements one of the specific Connector types, namely {@link com.sun.jdi.connect.AttachingConnector AttachingConnector}, {@link com.sun.jdi.connect.ListeningConnector ListeningConnector}, or {@link com.sun.jdi.connect.LaunchingConnector LaunchingConnector}. The format of the provider configuration file is one fully-qualified class name per line. Space and tab characters surrounding each class, as well as blank lines are ignored. The comment character is '#' (0x23), and on each line all characters following the first comment character are ignored. The file must be encoded in UTF-8.

At start-up time the VirtualMachineManager attempts to load and instantiate (using the no-arg constructor) each class listed in the provider configuration file. Exceptions thrown when loading or creating the Connector are caught and ignored. In other words, the start-up process continues despite of errors.

In addition to Connectors installed on the platform the VirtualMachineManager will also create Connectors to encapsulate any {@link com.sun.jdi.connect.spi.TransportService} implementationsthat are installed on the platform. A TransportService is installed on the platform if it installed in a jar file that is visible to the defining class loader for the {@link com.sun.jdi.connect.spi.TransportService} type, and that jarfile contains a provider configuration file named com.sun.jdi.connect.spi.TransportService in the resource directory META-INF/services, and the provider configuration file lists the the full-qualified class name of the TransportService implementation. A TransportService is a concrete sub-class of {@link com.sun.jdi.connect.spi.TransportService TransportService}. The format of the provider configuration file is the same as the provider configuration file for Connectors except that each class listed must be the fully-qualified class name of a class that implements the TransportService interface.

For each TransportService installed on the platform, the VirtualMachineManager creates a corresponding {@link com.sun.jdi.connect.AttachingConnector} and{@link com.sun.jdi.connect.ListeningConnector}. These Connectors are created to encapsulate a {@link com.sun.jdi.connect.Transport Transport} that in turnencapsulates the TransportService. The AttachingConnector will be named based on the name of the transport service concatenated with the string Attach. For example, if the transport service {@link com.sun.jdi.connect.spi.TransportService#name() name()} methodreturns telepathic then the AttachingConnector will be named telepathicAttach. Similiarly the ListeningConnector will be named with the string Listen tagged onto the name of the transport service. The {@link com.sun.jdi.connect.Connector#description() description()} methodof both the AttachingConnector, and the ListeningConnector, will delegate to the {@link com.sun.jdi.connect.spi.TransportService#description() description()} method of the underlying transport service. Boththe AttachingConnector and the ListeningConnector will have two Connector {@link com.sun.jdi.connect.Connector$Argument Arguments}. A {@link com.sun.jdi.connect.Connector$StringArgument StringArgument}named address is the connector argument to specify the address to attach too, or to listen on. A {@link com.sun.jdi.connect.Connector$IntegerArgument IntegerArgument}named timeout is the connector argument to specify the timeout when attaching, or accepting. The timeout connector may be ignored depending on if the transport service supports an attach timeout or accept timeout.

Initialization of the virtual machine manager will fail, that is {@link com.sun.jdi.Bootstrap#virtualMachineManager()} will throw anerror if the virtual machine manager is unable to create any connectors. @author Gordon Hirsch @since 1.3

        throw new IllegalStateException(e);
      }
    }


    private AttachingConnector getConnector() {
      VirtualMachineManager vmManager = Bootstrap
          .virtualMachineManager();
      for (AttachingConnector connector : vmManager
          .attachingConnectors()) {
        if ("com.sun.jdi.SocketAttach".equals(connector
            .name())) {
          return (AttachingConnector) connector;
        }

View Full Code Here

    // either host,port will be set, or name
    private void connect(String host, String port, String name) throws Exception {
        // connect to JVM
        boolean useSocket = (port != null);


        VirtualMachineManager manager = Bootstrap.virtualMachineManager();
        List<AttachingConnector> connectors = manager.attachingConnectors();
        AttachingConnector connector = null;
//      System.err.println("Connectors available");
        for (int i = 0; i < connectors.size(); i++) {
            AttachingConnector tmp = connectors.get(i);
//          System.err.println("conn "+i+"  name="+tmp.name()+" transport="+tmp.transport().name()+

View Full Code Here

      attachButton = new JButton();
      attachButton.setText("Attach");
      attachButton.addActionListener(new java.awt.event.ActionListener() {
        public void actionPerformed(java.awt.event.ActionEvent e) {
          boolean suspend = false;
          VirtualMachineManager vmm = Bootstrap.virtualMachineManager();
          if (DebugTab.this.launchVM.isSelected()) {
            // Launch
            LaunchingConnector connector = vmm.defaultConnector();
            Map<String, Argument> args = connector.defaultArguments();
            //Project project = OpenProjects.getInstance().getCurrentProject();
            String mainClass = DebugTab.this.mainClassField.getText();
            args.get("options").setValue("-cp \"" + project.getFileSet().getClasspath(mainClass) + "\"" + DebugTab.this.classpathField.getText());
            args.get("suspend").setValue("true");
            suspend = DebugTab.this.suspend.isSelected();
            args.get("main").setValue(mainClass);
            try {
              DebugTab.this.vm = connector.launch(args);        
              StreamRedirector srErr = new StreamRedirector(vm.process().getErrorStream(), System.err);
              new Thread(srErr).start();
              StreamRedirector srOut = new StreamRedirector(vm.process().getInputStream(), System.out);
              new Thread(srOut).start();
            } catch (Exception ex) {
              SystemFacade.getInstance().handleException(ex);
              return;
            }
          } else {
            // Attach
            AttachingConnector connector = null;
            for (AttachingConnector ac : vmm.attachingConnectors()) {
              if (ac.transport().name().equals(DebugTab.this.methodCombo.getSelectedItem())) {
                connector = ac;
                break;
              }
            }

View Full Code Here

    }
    return null;
  }


  private static AttachingConnector getAttachingConnector() {
    VirtualMachineManager vmm = Bootstrap.virtualMachineManager();
    List<AttachingConnector> connectors = vmm.attachingConnectors();
    AttachingConnector connector = null;
    for (AttachingConnector conn : connectors) {
      if (conn.name().equals("com.sun.jdi.SocketAttach"))
        connector = conn;
    }

View Full Code Here

    }
    return connector;
  }
  
  private static ListeningConnector getListeningConnector() {
    VirtualMachineManager vmm = Bootstrap.virtualMachineManager();
    List<ListeningConnector> connectors = vmm.listeningConnectors();
    ListeningConnector connector = null;
    for (ListeningConnector conn : connectors) {
      if (conn.name().equals("com.sun.jdi.SocketListen"))
        connector = conn;
    }

View Full Code Here

    void log(String event) {
        trace.append(event).append('\n');
    }
    
    public void start() throws Exception {
        VirtualMachineManager vmm = com.sun.jdi.Bootstrap.virtualMachineManager();
        LaunchingConnector conn = vmm.defaultConnector();
        Map<String, Argument> defaultArguments = conn.defaultArguments();
        defaultArguments.get("main").setValue(mainClass);
        defaultArguments.get("options").setValue("-cp " + classPath);
        System.out.println(defaultArguments);
        vm = conn.launch(defaultArguments);

View Full Code Here

    inject(args[0], loader, stagerArgs);
  }
  
  public static void inject(String connector, final StagerHandler.Loader loader, String[] stagerArgs) throws Exception {
    final String stager = stagerArgs[0];
    final VirtualMachineManager vmm = com.sun.jdi.Bootstrap.virtualMachineManager();
    VirtualMachine vm = null;
    boolean disableSecurityManager = false;
    if (connector.endsWith("!")) {
      disableSecurityManager = true;
      connector = connector.substring(0, connector.length()-1);
    }
    final int pos = connector.lastIndexOf(':');
    if (pos == -1) {
      final int port = Integer.parseInt(connector);
      for (int i = 0; i < vmm.listeningConnectors().size(); i++) {
        final ListeningConnector lc = (ListeningConnector) vmm.listeningConnectors().get(i);
        if (lc.name().equals("com.sun.jdi.SocketListen")) {
          final Map connectorArgs = lc.defaultArguments();
          ((Argument) connectorArgs.get("port")).setValue("" + port);
          lc.startListening(connectorArgs);
          vm = lc.accept(connectorArgs);
          lc.stopListening(connectorArgs);
        }
      }
    } else {
      final int port = Integer.parseInt(connector.substring(pos + 1));
      for (int i = 0; i < vmm.attachingConnectors().size(); i++) {
        final AttachingConnector ac = (AttachingConnector) vmm.attachingConnectors().get(i);
        if (ac.name().equals("com.sun.jdi.SocketAttach")) {
          final Map connectorArgs = ac.defaultArguments();
          ((Argument) connectorArgs.get("hostname")).setValue(connector.substring(0, pos));
          ((Argument) connectorArgs.get("port")).setValue("" + port);
          vm = ac.attach(connectorArgs);

View Full Code Here

   * @since 2.1
   */
  public static int[] getJDIVersion() {
    if (fJDIVersion == null) {
      fJDIVersion = new int[2];
      VirtualMachineManager mgr = Bootstrap.virtualMachineManager();
      fJDIVersion[0] = mgr.majorInterfaceVersion();
      fJDIVersion[1] = mgr.minorInterfaceVersion();
    }
    return fJDIVersion;
  }

View Full Code Here

    public void close() throws IOException {
        disconnect();
    }


    private VirtualMachine connect(int port) throws IOException {
        VirtualMachineManager manager = Bootstrap.virtualMachineManager();


        // Find appropiate connector
        List<AttachingConnector> connectors = manager.attachingConnectors();
        AttachingConnector chosenConnector = null;
        for (AttachingConnector c : connectors) {
            if (c.transport().name().equals(TRANSPORT_NAME)) {
                chosenConnector = c;
                break;

View Full Code Here

TOP

Related Classes of com.sun.jdi.VirtualMachineManager

com.github.dcevm.JDIRedefiner

com.google.code.vimsztool.debug.Debugger

com.redhat.ceylon.compiler.java.test.trace.TracerImpl

javapayload.builder.JDWPInjector

net.sf.rej.gui.tab.DebugTab

org.eclipse.jdt.internal.debug.core.JDIDebugPlugin

org.jnode.ant.taskdefs.HotSwapHelper

st.gravel.support.jvm.debugger.VMAcquirer

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.