JavaException Класс

Определение

Пространство имен:: Java.Interop

Сборка:: Java.Interop.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.

[Java.Interop.JniTypeSignature("java/lang/Throwable", GenerateJavaPeer=false)]
public class JavaException : Exception, IDisposable, Java.Interop.IJavaPeerable

[<Java.Interop.JniTypeSignature("java/lang/Throwable", GenerateJavaPeer=false)>]
type JavaException = class
    inherit Exception
    interface IJavaPeerable
    interface IDisposable

Наследование: Exception
JavaException

Производный: Java.Lang.Throwable

Атрибуты: JniTypeSignatureAttribute

Реализации: IJavaPeerable IDisposable

Класс Throwable — это суперкласс всех ошибок и исключений на языке Java. Только объекты, которые являются экземплярами этого класса (или одним из его подклассов), создаются Java виртуальной машиной или могут быть вызваны инструкцией Java создания. Аналогичным образом, только этот класс или один из его подклассов может быть типом аргумента в предложении catch. Для целей проверки исключений во время компиляции, Throwable и любого подкласса Throwable, который также не является подклассом среды выполненияException или Error, считаются проверенными исключениями. Экземпляры двух подклассов, ошибки и исключения обычно используются для обозначения того, что произошли исключительные ситуации. Как правило, эти экземпляры создаются в контексте исключительной ситуации, чтобы включить соответствующую информацию (например, данные трассировки стека). Исключение содержит моментальный снимок стека выполнения потока во время его создания. Он также может содержать строку сообщения, которая предоставляет дополнительные сведения об ошибке. С течением времени бросаемый может подавлять другие бросаемые элементы от распространения. Наконец, бросаемый может также содержать причину: еще один бросаемый, который вызвал это бросаемое создание. Запись этой причинной информации называется цепочкой исключения, так как причина может, сама по себе, иметь причину и т. д., что приводит к "цепочке" исключений, каждая из которых вызвана другим. Одна из причин, по которой может возникнуть исключение, заключается в том, что класс, который создает его на вершине нижнего слоя абстракции, и операция на верхнем слое завершается сбоем из-за сбоя в нижнем слое. Это было бы плохой дизайн, чтобы позволить бросаемым, создаваемым нижним слоем распространяться наружу, так как обычно это не связано с абстракцией, предоставляемой верхним слоем. Кроме того, это привязывает API верхнего слоя к деталям его реализации, предполагая, что исключение нижнего слоя было проверено. Создание "завернутого исключения" (т. е. исключение, содержащее причину), позволяет верхнему уровню передавать сведения о неудаче вызывающей функции без возникновения каких-либо из этих недостатков. Она сохраняет гибкость для изменения реализации верхнего слоя, не изменяя его API (в частности, набор исключений, создаваемых его методами). Вторая причина, по которой может возникнуть исключение, заключается в том, что метод, который вызывает его, должен соответствовать интерфейсу общего назначения, который не позволяет методу напрямую вызывать причину. Например, предположим, что постоянная коллекция соответствует интерфейсу коллекции и что ее сохраняемость реализуется на вершине java.io. Предположим, что внутренние компоненты метода добавления могут вызывать ioException. Реализация может передавать сведения о ioException вызывающей объекту при соответствии интерфейсу коллекции, упаковав IOException в соответствующее исключение без проверки. (Спецификация сохраняемой коллекции должна указывать на то, что она может вызывать такие исключения.) Причина может быть связана с бросаемым методом двумя способами: с помощью конструктора, который принимает причину в качестве аргумента или с помощью метода initCause(Throwable). Новые бросаемые классы, которые хотят разрешить их связать с ними, должны предоставить конструкторам, которые принимают причину и делегат (возможно, косвенно) одному из конструкторов Throwable, которые принимают причину. Так как метод initCause является общедоступным, он позволяет связать причину с любым бросаемым, даже "устаревшим бросаемым", реализация которого предшествует добавлению механизма цепочки исключений в Throwable. По соглашению класс Throwable и его подклассы имеют два конструктора, один из которых не принимает аргументы и принимает аргумент String, который можно использовать для создания подробного сообщения. Кроме того, эти подклассы, которые могут иметь причину, связанную с ними, должны иметь два дополнительных конструктора, один из которых принимает бросаемый (причину), и тот, который принимает строку (сообщение подробности) и бросаемый (причина).

Java справочные материалы.java.lang.Throwable

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Конструкторы

Имя.	Описание
JavaException()	Создает новый бросаемый объект с значением NULL в качестве его подробного сообщения.
JavaException(JniObjectReference, JniObjectReferenceOptions, JniObjectReference)	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
JavaException(JniObjectReference, JniObjectReferenceOptions)	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
JavaException(String, Exception)	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
JavaException(String)	Создает новый бросаемый объект с указанным сообщением сведений.

Поля

Имя.	Описание
InvalidJniObjectReference	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.

Свойства

Имя.	Описание
JavaStackTrace	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
JniIdentityHashCode	Возвращает тот же хэш-код для данного объекта, что и возвращается методом hashCode(), независимо от того, переопределяет ли класс данного объекта хэшКод().
JniManagedPeerState	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
JniPeerMembers	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
PeerReference	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
StackTrace	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.

Методы

Имя.	Описание
Construct(JniObjectReference, JniObjectReferenceOptions)	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
Dispose()	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
Dispose(Boolean)	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
DisposeUnlessReferenced()	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
Equals(Object)	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
Finalize()	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
GetHashCode()	Возвращает хэш-значение кода для объекта.
SetJavaStackTrace(JniObjectReference)	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
UnregisterFromRuntime()	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.

Явные реализации интерфейса

Имя.	Описание
IJavaPeerable.Disposed()	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
IJavaPeerable.Finalized()	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
IJavaPeerable.JniObjectReferenceControlBlock	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
IJavaPeerable.SetJniIdentityHashCode(Int32)	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.
IJavaPeerable.SetPeerReference(JniObjectReference)	Класс Throwable — это суперкласс всех ошибок и исключений на языке Java.

Методы расширения

Имя.	Описание
GetJniTypeName(IJavaPeerable)	Возвращает имя JNI типа экземпляра `self`.
JavaAs<TResult>(IJavaPeerable)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.

Применяется к