net.bytebuddy.agent

Class VirtualMachine.ForHotSpotVm

java.lang.Object

net.bytebuddy.agent.VirtualMachine.ForHotSpotVm

All Implemented Interfaces:

VirtualMachine

Enclosing interface:

VirtualMachine

public static class VirtualMachine.ForHotSpotVm
extends Object
implements VirtualMachine

A virtual machine implementation for a HotSpot VM or any compatible VM.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	VirtualMachine.ForHotSpotVm.Connection Represents a connection to a virtual machine.

Nested classes/interfaces inherited from interface net.bytebuddy.agent.VirtualMachine

VirtualMachine.ForHotSpotVm

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ForHotSpotVm(VirtualMachine.ForHotSpotVm.Connection connection) Creates a default virtual machine implementation.

Method Summary

Modifier and Type	Method and Description
static Class<?>	assertAvailability() Asserts if this virtual machine type is available on the current VM.
static VirtualMachine	attach(String processId) Attaches to the supplied process id using the default JNA implementation.
static VirtualMachine	attach(String processId, VirtualMachine.ForHotSpotVm.Connection.Factory connectionFactory) Attaches to the supplied process id using the supplied connection factory.
void	detach() Detaches this virtual machine representation.
protected void	load(String file, boolean isNative, String argument) Loads an agent by the given command.
void	loadAgent(String jarFile, String argument) Loads an agent into the represented virtual machine.
void	loadAgentPath(String library, String argument) Loads a native agent into the represented virtual machine.

Methods inherited from class java.lang.Object

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

Constructor Detail

ForHotSpotVm

protected ForHotSpotVm(VirtualMachine.ForHotSpotVm.Connection connection)

Creates a default virtual machine implementation.

Parameters:

connection - The virtual machine connection.

Method Detail

assertAvailability

public static Class<?> assertAvailability()
                                   throws Throwable

Asserts if this virtual machine type is available on the current VM.

Returns:

The virtual machine type if available.

Throws:

Throwable - If this virtual machine is not available.

attach

public static VirtualMachine attach(String processId)
                             throws IOException

Attaches to the supplied process id using the default JNA implementation.

Parameters:

processId - The process id.

Returns:

A suitable virtual machine implementation.

Throws:

IOException - If an IO exception occurs during establishing the connection.

attach

public static VirtualMachine attach(String processId,
                                    VirtualMachine.ForHotSpotVm.Connection.Factory connectionFactory)
                             throws IOException

Attaches to the supplied process id using the supplied connection factory.

Parameters:

processId - The process id.

connectionFactory - The connection factory to use.

Returns:

A suitable virtual machine implementation.

Throws:

IOException - If an IO exception occurs during establishing the connection.

loadAgent

public void loadAgent(String jarFile,
                      String argument)
               throws IOException

Loads an agent into the represented virtual machine.

Specified by:

loadAgent in interface VirtualMachine

Parameters:

jarFile - The jar file to attach.

argument - The argument to provide or null if no argument should be provided.

Throws:

IOException - If an I/O exception occurs.

loadAgentPath

public void loadAgentPath(String library,
                          String argument)
                   throws IOException

Loads a native agent into the represented virtual machine.

Specified by:

loadAgentPath in interface VirtualMachine

Parameters:

library - The agent library.

argument - The argument to provide or null if no argument should be provided.

Throws:

IOException - If an I/O exception occurs.

load

protected void load(String file,
                    boolean isNative,
                    String argument)
             throws IOException

Loads an agent by the given command.

Parameters:

file - The Java agent or library to be loaded.

isNative - true if the agent is native.

argument - The argument to the agent or null if no argument is given.

Throws:

IOException - If an I/O exception occurs.

detach

public void detach()
            throws IOException

Detaches this virtual machine representation.

Specified by:

detach in interface VirtualMachine

Throws:

IOException - If an I/O exception occurs.