Класс AgentInitializationException

com.sun.tools.attach.AgentInitializationException

Все реализованные интерфейсы:: Serializable

public class AgentInitializationException extends Exception

Исключение, выбрасываемое, если агенту не удаётся инициализироваться в целевой виртуальной машине Java.

Это исключение выбрасывается методами VirtualMachine.loadAgent, VirtualMachine.loadAgentLibrary, VirtualMachine.loadAgentPath, если агент или библиотеку агента не удаётся инициализировать. Если исключение выбрасывается методом VirtualMachine.loadAgentLibrary или VirtualMachine.loadAgentPath, оно содержит код ошибки, возвращённый функцией Agent_OnAttach агента. Этот код ошибки можно получить, вызвав метод returnValue.

Начиная с:

1.6

См. также:

Краткое описание конструкторов

Конструктор	Описание
`AgentInitializationException()`	Создаёт `AgentInitializationException` без подробного сообщения.
`AgentInitializationException(String s)`	Создаёт `AgentInitializationException` с указанным подробным сообщением.
`AgentInitializationException(String s, int returnValue)`	Создаёт `AgentInitializationException` с указанным подробным сообщением и значением, возвращённым при выполнении функции `Agent_OnAttach` агента.

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`returnValue()`	Если исключение было создано со значением, возвращённым функцией `Agent_OnAttach` агента, возвращает это значение; в противном случае возвращает `0`.

Методы, объявленные в классе Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, которые были подавлены для передачи этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека вызовов.
`Throwable`	`getCause()`	Возвращает причину этого исключения или `null`, если причина отсутствует или неизвестна.
`String`	`getLocalizedMessage()`	Создаёт локализованное описание этого исключения.
`String`	`getMessage()`	Возвращает строку с подробным сообщением этого исключения.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к информации трассировки стека, выводимой методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив всех исключений, которые были подавлены, обычно оператором `try`, для передачи этого исключения.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину этого исключения указанным значением.
`void`	`printStackTrace()`	Выводит это исключение и его трассировку в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит это исключение и его трассировку в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит это исключение и его трассировку в указанный объект печати.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Задаёт элементы трассировки стека, которые будут возвращаться методом `Throwable.getStackTrace()` и выводиться методом `Throwable.printStackTrace()` и связанными методами.
`String`	`toString()`	Возвращает краткое описание этого исключения.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API планируется удалить в одной из будущих версий. Финализация устарела и планируется к удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного времени.

Подробное описание конструкторов

AgentInitializationException

public AgentInitializationException()

Создаёт AgentInitializationException без подробного сообщения.

AgentInitializationException

public AgentInitializationException(String s)

Создаёт AgentInitializationException с указанным подробным сообщением.

Параметры:: s — подробное сообщение.

AgentInitializationException

public AgentInitializationException(String s, int returnValue)

Создаёт AgentInitializationException с указанным подробным сообщением и значением, возвращённым при выполнении функции Agent_OnAttach агента.

Параметры:: s — подробное сообщение.; returnValue — возвращаемое значение

Подробное описание методов

returnValue

public int returnValue()

Если исключение было создано со значением, возвращённым функцией Agent_OnAttach агента, возвращает это значение; в противном случае возвращает 0.

Возвращает:: возвращаемое значение

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.