sun.tools.attach

Class WindowsAttachProvider

java.lang.Object

com.sun.tools.attach.spi.AttachProvider

sun.tools.attach.HotSpotAttachProvider

sun.tools.attach.WindowsAttachProvider

public class WindowsAttachProvider
extends HotSpotAttachProvider

Constructor Summary

Constructors

Constructor and Description
WindowsAttachProvider()

Method Summary

Modifier and Type	Method and Description
VirtualMachine	attachVirtualMachine(String vmid) Attaches to a Java virtual machine.
List<VirtualMachineDescriptor>	listVirtualMachines() Lists the Java virtual machines known to this provider.
String	name() Return this provider's name.
String	type() Return this provider's type.

Methods inherited from class sun.tools.attach.HotSpotAttachProvider

checkAttachPermission

Methods inherited from class com.sun.tools.attach.spi.AttachProvider

attachVirtualMachine, providers

Methods inherited from class java.lang.Object

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

Constructor Detail

WindowsAttachProvider

public WindowsAttachProvider()

Method Detail

name

public String name()

Description copied from class: AttachProvider

Return this provider's name.

Specified by:

name in class AttachProvider

Returns:

The name of this provider

type

public String type()

Description copied from class: AttachProvider

Return this provider's type.

Specified by:

type in class AttachProvider

Returns:

The type of this provider

attachVirtualMachine

public VirtualMachine attachVirtualMachine(String vmid)
                                    throws AttachNotSupportedException,
                                           IOException

Description copied from class: AttachProvider

Attaches to a Java virtual machine.

A Java virtual machine is identified by an abstract identifier. The nature of this identifier is platform dependent but in many cases it will be the string representation of the process identifier (or pid).

This method parses the identifier and maps the identifier to a Java virtual machine (in an implementation dependent manner). If the identifier cannot be parsed by the provider then an AttachNotSupportedException is thrown. Once parsed this method attempts to attach to the Java virtual machine. If the provider detects that the identifier corresponds to a Java virtual machine that does not exist, or it corresponds to a Java virtual machine that does not support the attach mechanism implemented by this provider, or it detects that the Java virtual machine is a version to which this provider cannot attach, then an AttachNotSupportedException is thrown.

Specified by:

attachVirtualMachine in class AttachProvider

Parameters:

vmid - The abstract identifier that identifies the Java virtual machine.

Returns:

VirtualMachine representing the target virtual machine.

Throws:

AttachNotSupportedException - If the identifier cannot be parsed, or it corresponds to to a Java virtual machine that does not exist, or it corresponds to a Java virtual machine which this provider cannot attach.

IOException - If some other I/O error occurs

listVirtualMachines

public List<VirtualMachineDescriptor> listVirtualMachines()

Description copied from class: AttachProvider

Lists the Java virtual machines known to this provider.

This method returns a list of VirtualMachineDescriptor elements. Each VirtualMachineDescriptor describes a Java virtual machine to which this provider can potentially attach. There isn't any guarantee that invoking attachVirtualMachine on each descriptor in the list will succeed.

Overrides:

listVirtualMachines in class HotSpotAttachProvider

Returns:

The list of virtual machine descriptors which describe the Java virtual machines known to this provider (may be empty).