Класс SOAPException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- javax.xml.soap.SOAPException
- Все реализуемые интерфейсы:
- Serializable
public class SOAPException extends Exception
Исключение, сигнализирующее о возникновении исключения SOAP. Объект SOAPException может содержать сообщение String, указывающее причину исключения, вложенный объект Throwable, или и то, и другое. Этот класс предоставляет методы для получения сообщений о причинах и для извлечения вложенного объекта Throwable.
Типичными причинами выброса объекта SOAPException являются проблемы, такие как трудности с установкой заголовка, невозможность отправки сообщения и невозможность получения соединения с поставщиком. Причины вложения объекта Throwable включают проблемы, такие как ошибки ввода-вывода или проблемы с разбором, такие как ошибка при разборе заголовка.
- См. также:
- Сериализованная форма
Конструкторы
| Конструктор и описание |
|---|
SOAPException() Создает объект |
SOAPException(String reason) Создает объект |
SOAPException(String reason,
Throwable cause) Создает объект |
SOAPException(Throwable cause) Создает объект |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
Throwable |
getCause() Возвращает вложенный объект |
String |
getMessage() Возвращает сообщение об ошибке для этого объекта |
Throwable |
initCause(Throwable cause) Инициализирует поле |
Методы, унаследованные от класса java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait Конструкторы
SOAPException
public SOAPException()
Создает объект SOAPException без причины или вложенного объекта Throwable.
SOAPException
public SOAPException(String reason)
Создает объект SOAPException с заданным String в качестве причины выброшенного исключения.
- Параметры:
-
reason- описание причины исключения
SOAPException
public SOAPException(String reason,
Throwable cause) Создает объект SOAPException с заданным String в качестве причины выброшенного исключения и заданным объектом Throwable в качестве вложенного исключения.
- Параметры:
-
reason- описание причины исключения -
cause- объектThrowable, который должен быть вложен в этот объектSOAPException
SOAPException
public SOAPException(Throwable cause)
Создает объект SOAPException, инициализированный заданным объектом Throwable.
Методы
getMessage
public String getMessage()
Возвращает сообщение об ошибке для этого объекта SOAPException.
Если есть вложенный объект Throwable, и если у объекта SOAPException нет собственного сообщения об ошибке, этот метод вернет сообщение об ошибке из вложенного объекта Throwable.
- Переопределяет:
-
getMessageв классеThrowable - Возвращает:
- сообщение об ошибке или предупреждении для этого объекта
SOAPExceptionили, если его нет, сообщение вложенного объектаThrowableпри его наличии
getCause
public Throwable getCause()
Возвращает объект Throwable вложенный в этот объект SOAPException, если он есть. В противном случае этот метод возвращает null.
- Переопределяет:
-
getCauseв классеThrowable - Возвращает:
- вложенный объект
Throwableилиnull, если его нет
initCause
public Throwable initCause(Throwable cause)
Инициализирует поле cause этого объекта SOAPException заданным объектом Throwable.
Этот метод может быть вызван не более одного раза. Обычно он вызывается из конструктора или сразу после возврата конструктором нового объекта SOAPException. Если этот объект SOAPException был создан с конструктором SOAPException(Throwable) или SOAPException(String,Throwable), то есть его поле cause уже имеет значение, этот метод не может быть вызван ни разу.
- Переопределяет:
-
initCauseв классеThrowable - Параметры:
-
cause- объектThrowable, который вызвал выброс этого объектаSOAPException. Значение этого параметра сохраняется для последующего извлечения методомgetCause(). Разрешается значениеnull, что указывает на отсутствие или неизвестность причины. - Возвращает:
- ссылка на этот экземпляр
SOAPException - Исключение:
-
IllegalArgumentException- еслиcauseявляется этим объектомThrowable. (ОбъектThrowableне может быть своей собственной причиной.) -
IllegalStateException- если причина для этого объектаSOAPExceptionуже была инициализирована
© 1993, 2020, 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.