JavaException Classe

Definizione

Spazio dei nomi:

Java.Interop

Assembly:

Java.Interop.dll

La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio 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

Ereditarietà

Exception

JavaException

Derivato

Java.Lang.Throwable

Attributi

JniTypeSignatureAttribute

Implementazioni

IJavaPeerable IDisposable

Commenti

La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java. Solo gli oggetti che sono istanze di questa classe (o una delle relative sottoclassi) vengono generati dalla macchina virtuale Java o possono essere generati dall'istruzione throw Java. Analogamente, solo questa classe o una delle relative sottoclassi può essere il tipo di argomento in una clausola catch. Ai fini del controllo in fase di compilazione delle eccezioni, Throwable e qualsiasi sottoclasse di Throwable che non è anche una sottoclasse di RuntimeException o Error sono considerate eccezioni controllate. Le istanze di due sottoclassi, Error ed Exception, vengono usate convenzionalmente per indicare che si sono verificate situazioni eccezionali. In genere, queste istanze vengono create appena nel contesto della situazione eccezionale, in modo da includere informazioni rilevanti, ad esempio i dati di analisi dello stack. Un'eccezione generabile contiene uno snapshot dello stack di esecuzione del thread al momento della creazione. Può anche contenere una stringa di messaggio che fornisce altre informazioni sull'errore. Nel corso del tempo, un'eccezione throwable può impedire la propagazione di altri throwable. Infine, il throwable può contenere anche una causa: un altro throwable che ha causato la costruzione di questo throwable. La registrazione di queste informazioni causali viene definita struttura di eccezione concatenato, in quanto la causa può, a sua volta, avere una causa e così via, portando a una "catena" di eccezioni, ognuna causata da un'altra. Un motivo per cui un'eccezione generata può avere una causa è che la classe che lo genera viene creata in cima a un'astrazione a più livelli inferiore e un'operazione sul livello superiore ha esito negativo a causa di un errore nel livello inferiore. Sarebbe una progettazione non valida per consentire la generazione generata dal livello inferiore propagando verso l'esterno, in quanto in genere non è correlata all'astrazione fornita dal livello superiore. Inoltre, in questo modo, l'API del livello superiore viene condata ai dettagli dell'implementazione, presupponendo che l'eccezione del livello inferiore fosse un'eccezione controllata. La generazione di un'"eccezione di cui è stato eseguito il wrapping", ovvero un'eccezione contenente una causa, consente al livello superiore di comunicare i dettagli dell'errore al chiamante senza incorrere in una di queste carenze. Mantiene la flessibilità necessaria per modificare l'implementazione del livello superiore senza modificarne l'API ( in particolare, il set di eccezioni generate dai relativi metodi). Un secondo motivo per cui un'eccezione generata può avere una causa è che il metodo che lo genera deve essere conforme a un'interfaccia per utilizzo generico che non consente al metodo di generare direttamente la causa. Si supponga, ad esempio, che una raccolta persistente sia conforme all'interfaccia Collection e che la relativa persistenza venga implementata in cima java.io. Si supponga che gli interni del metodo add possano generare un'eccezione IOException. L'implementazione può comunicare i dettagli dell'eccezione IOException al chiamante durante la conformità all'interfaccia Collection eseguendo il wrapping dell'eccezione IOException in un'eccezione non selezionata appropriata. La specifica per la raccolta persistente deve indicare che è in grado di generare tali eccezioni. Una causa può essere associata a un'eccezione generata in due modi: tramite un costruttore che accetta la causa come argomento o tramite il metodo initCause(Throwable). Le nuove classi generabili che desiderano consentire l'associazione di cause devono fornire costruttori che accettano una causa e un delegato (forse indirettamente) a uno dei costruttori Throwable che accettano una causa. Poiché il metodo initCause è pubblico, consente di associare una causa a qualsiasi eccezione generata, anche a un 'throwable legacy' la cui implementazione precede l'aggiunta del meccanismo di concatenamento delle eccezioni a Throwable. Per convenzione, la classe Throwable e le relative sottoclassi hanno due costruttori, uno che non accetta argomenti e uno che accetta un argomento String che può essere usato per generare un messaggio di dettaglio. Inoltre, le sottoclassi che potrebbero avere una causa associata a tali sottoclassi devono avere altri due costruttori, uno che accetta un'eccezione Throwable (la causa) e una che accetta una stringa (il messaggio di dettaglio) e un'eccezione Throwable (la causa).

Java informazioni di riferimento per java.lang.Throwable.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Costruttori

Nome	Descrizione
JavaException()	Costruisce un nuovo oggetto throwable con null come messaggio di dettaglio.
JavaException(JniObjectReference, JniObjectReferenceOptions)	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
JavaException(String, Exception)	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
JavaException(String)	Costruisce un nuovo oggetto generabile con il messaggio di dettaglio specificato.

Campi

Nome	Descrizione
InvalidJniObjectReference	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.

Proprietà

Nome	Descrizione
JavaStackTrace	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
JniIdentityHashCode	Restituisce lo stesso codice hash per l'oggetto specificato come verrebbe restituito dal metodo predefinito hashCode(), indipendentemente dal fatto che la classe dell'oggetto specificato esempe hashCode().
JniManagedPeerState	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
JniPeerMembers	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
PeerReference	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
StackTrace	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.

Metodi

Nome	Descrizione
Construct(JniObjectReference, JniObjectReferenceOptions)	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
Dispose()	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
Dispose(Boolean)	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
DisposeUnlessReferenced()	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
Equals(Object)	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
Finalize()	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
GetHashCode()	Restituisce un valore di codice hash per l'oggetto .
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
UnregisterFromRuntime()	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IJavaPeerable.Disposed()	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
IJavaPeerable.Finalized()	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
IJavaPeerable.SetJniIdentityHashCode(Int32)	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.
IJavaPeerable.SetPeerReference(JniObjectReference)	La classe Throwable è la superclasse di tutti gli errori ed eccezioni nel linguaggio Java.

Metodi di estensione

Nome	Descrizione
GetJniTypeName(IJavaPeerable)	Ottiene il nome JNI del tipo dell'istanza selfdi .
JavaAs<TResult>(IJavaPeerable)	Provare a digitare selfTResult, verificando che la coercizione sia valida sul lato Java.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Provare a digitare selfTResult, verificando che la coercizione sia valida sul lato Java.