Класс 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.

Since:

1.1

См. также:

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

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

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

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

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

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

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

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

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

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

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

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.
Since:: 1.4

© 1993, 2023, 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.
https://docs.oracle.com/en/java/javase/21/docs/api/java.rmi/java/rmi/RemoteException.html