net.bytebuddy.agent

Class VirtualMachine.ForHotSpot

java.lang.Object

net.bytebuddy.agent.VirtualMachine.ForHotSpot

All Implemented Interfaces:

VirtualMachine

Enclosing interface:

VirtualMachine

public static class VirtualMachine.ForHotSpot
extends Object
implements VirtualMachine

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

Nested Class Summary

Nested Classes

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

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

VirtualMachine.ForHotSpot, VirtualMachine.ForOpenJ9, VirtualMachine.Resolver

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ForHotSpot(VirtualMachine.ForHotSpot.Connection connection) Creates a new virtual machine connection for HotSpot.

Method Summary

Modifier and Type	Method and Description
static VirtualMachine	attach(String processId) Attaches to the supplied process id using the default JNA implementation.
static VirtualMachine	attach(String processId, VirtualMachine.ForHotSpot.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

ForHotSpot

protected ForHotSpot(VirtualMachine.ForHotSpot.Connection connection)

Creates a new virtual machine connection for HotSpot.

Parameters:

connection - The virtual machine connection.

Method Detail

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.ForHotSpot.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.