Класс RemoteException

java.rmi.RemoteException

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

Прямые известные подклассы:: AccessException, ConnectException, ConnectIOException, ExportException, MarshalException, NoSuchObjectException, ServerError, ServerException, ServerRuntimeException, SkeletonMismatchException, SkeletonNotFoundException, StubNotFoundException, UnexpectedException, UnknownHostException, UnmarshalException

public class RemoteException extends IOException

RemoteException — общий суперкласс для ряда исключений, связанных с обменом данными, которые могут возникать при выполнении удалённого вызова метода. Каждый метод удалённого интерфейса, то есть интерфейса, расширяющего java.rmi.Remote, должен перечислять RemoteException в предложении throws.

Начиная с выпуска 1.4 это исключение было адаптировано для соответствия универсальному механизму объединения исключений в цепочку. «Обернутое удалённое исключение», которое может быть передано при создании и доступно через открытое поле detail, теперь называется причиной и может быть получено с помощью метода Throwable.getCause(), а также через упомянутое выше «устаревшее поле».

Вызов метода Throwable.initCause(Throwable) для экземпляра RemoteException всегда приводит к выбросу IllegalStateException.

Начиная с версии:

1.1

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`Throwable`	`detail`	Причина удалённого исключения.

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

Конструктор	Описание
`RemoteException()`	Создаёт `RemoteException`.
`RemoteException(String s)`	Создаёт `RemoteException` с указанным подробным сообщением.
`RemoteException(String s, Throwable cause)`	Создаёт `RemoteException` с указанным подробным сообщением и причиной.

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

Модификатор и тип	Метод	Описание
`Throwable`	`getCause()`	Возвращает причину этого исключения.
`String`	`getMessage()`	Возвращает подробное сообщение, включая сообщение причины этого исключения, если оно есть.

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

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

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

Методы, объявленные в классе 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()`	Заставляет текущий поток ожидать, пока он не будет пробуждён, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать, пока он не будет пробуждён, обычно в результате вызова notify или interrupt, либо пока не истечёт заданный промежуток реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать, пока он не будет пробуждён, обычно в результате вызова notify или interrupt, либо пока не истечёт заданный промежуток реального времени.

Подробное описание полей

detail

public Throwable detail

Причина удалённого исключения.

Это поле появилось до появления универсального механизма объединения исключений в цепочку. Метод Throwable.getCause() теперь является предпочтительным способом получения этих сведений.

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

RemoteException

public RemoteException()

Создаёт RemoteException.

RemoteException

public RemoteException(String s)

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

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

RemoteException

public RemoteException(String s, Throwable cause)

Создаёт RemoteException с указанным подробным сообщением и причиной. Этот конструктор присваивает полю detail указанное значение Throwable.

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

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

getMessage

public String getMessage()

Возвращает подробное сообщение, включая сообщение причины этого исключения, если оно есть.

Переопределяет:: getMessage в классе Throwable
Возвращает:: подробное сообщение

getCause

public Throwable getCause()

Возвращает причину этого исключения. Этот метод возвращает значение поля detail.

Переопределяет:: getCause в классе Throwable
Возвращает:: причину, которой может быть null.
Начиная с версии:: 1.4

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