Package com.sun.tools.attach
Class AgentInitializationException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- com.sun.tools.attach.AgentInitializationException
-
- All Implemented Interfaces:
java.io.Serializable
public final class AgentInitializationException extends java.lang.Exception
The exception thrown when an agent fails to initialize in the target Java virtual machine.This exception is thrown by
VirtualMachine.loadAgent
,VirtualMachine.loadAgentLibrary
,VirtualMachine.loadAgentPath
methods if an agent, or agent library, cannot be initialized. When thrown by VirtualMachine.loadAgentLibrary, or VirtualMachine.loadAgentPath then the exception encapsulates the error returned by the agent'sAgent_OnAttach
function. This error code can be obtained by invoking thereturnValue
method.- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description private int
returnValue
private static long
serialVersionUID
-
Constructor Summary
Constructors Constructor Description AgentInitializationException()
Constructs anAgentInitializationException
with no detail message.AgentInitializationException(java.lang.String s)
Constructs anAgentInitializationException
with the specified detail message.AgentInitializationException(java.lang.String s, int returnValue)
Constructs anAgentInitializationException
with the specified detail message and the return value from the execution of the agent'sAgent_OnAttach
function.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description int
returnValue()
If the exception was created with the return value from the agentAgent_OnAttach
function then this returns that value, otherwise returns0
.
-
-
-
Field Detail
-
serialVersionUID
private static final long serialVersionUID
- See Also:
- Constant Field Values
-
returnValue
private final int returnValue
-
-
Constructor Detail
-
AgentInitializationException
public AgentInitializationException()
Constructs anAgentInitializationException
with no detail message.
-
AgentInitializationException
public AgentInitializationException(java.lang.String s)
Constructs anAgentInitializationException
with the specified detail message.- Parameters:
s
- the detail message.
-
AgentInitializationException
public AgentInitializationException(java.lang.String s, int returnValue)
Constructs anAgentInitializationException
with the specified detail message and the return value from the execution of the agent'sAgent_OnAttach
function.- Parameters:
s
- the detail message.returnValue
- the return value
-
-