JavaException Classe

Definição

Namespace:

Java.Interop

Assembly:

Java.Interop.dll

A classe Throwable é a superclasse de todos os erros e exceções na linguagem 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

Herança

Exception

JavaException

Derivado

Java.Lang.Throwable

Atributos

JniTypeSignatureAttribute

Implementações

IJavaPeerable IDisposable

Comentários

A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java. Somente os objetos que são instâncias dessa classe (ou uma de suas subclasses) são lançados pela máquina virtual Java ou podem ser gerados pela instrução Java throw. Da mesma forma, somente essa classe ou uma de suas subclasses pode ser o tipo de argumento em uma cláusula catch. Para fins de verificação de tempo de compilação de exceções, Throwable e qualquer subclasse de Throwable que também não seja uma subclasse de RuntimeException ou Error são consideradas exceções verificadas. Instâncias de duas subclasses, Erro e Exceção, são usadas convencionalmente para indicar que situações excepcionais ocorreram. Normalmente, essas instâncias são criadas recentemente no contexto da situação excepcional, de modo a incluir informações relevantes (como dados de rastreamento de pilha). Um throwable contém um instantâneo da pilha de execução de seu thread no momento em que foi criado. Ele também pode conter uma cadeia de caracteres de mensagem que fornece mais informações sobre o erro. Com o tempo, um throwable pode suprimir outros throwables de serem propagados. Por fim, o throwable também pode conter uma causa: outra que causou a construção desse throwable. A gravação dessas informações causais é conhecida como a instalação de exceção encadeada, pois a causa pode, por si só, ter uma causa, e assim por diante, levando a uma "cadeia" de exceções, cada uma causada por outra. Um motivo pelo qual um arremessável pode ter uma causa é que a classe que o lança é construída sobre uma abstração em camadas inferiores e uma operação na camada superior falha devido a uma falha na camada inferior. Seria um projeto ruim deixar o arremessável lançado pela camada inferior se propagar para fora, pois geralmente não está relacionado à abstração fornecida pela camada superior. Além disso, isso vincularia a API da camada superior aos detalhes de sua implementação, supondo que a exceção da camada inferior fosse uma exceção verificada. Lançar uma "exceção encapsulada" (ou seja, uma exceção contendo uma causa) permite que a camada superior comunique os detalhes da falha ao chamador sem incorrer em nenhuma dessas deficiências. Ele preserva a flexibilidade para alterar a implementação da camada superior sem alterar sua API (em particular, o conjunto de exceções geradas por seus métodos). Uma segunda razão pela qual um arremessável pode ter uma causa é que o método que o lança deve estar em conformidade com uma interface de propósito geral que não permite que o método lance a causa diretamente. Por exemplo, suponha que uma coleção persistente esteja em conformidade com a interface collection e que sua persistência seja implementada em cima de java.io. Suponha que os internos do método add possam gerar uma IOException. A implementação pode comunicar os detalhes do IOException ao chamador enquanto estiver em conformidade com a interface collection encapsulando a IOException em uma exceção desmarcada apropriada. (A especificação da coleção persistente deve indicar que ela é capaz de gerar essas exceções.) Uma causa pode ser associada a um throwable de duas maneiras: por meio de um construtor que usa a causa como um argumento ou por meio do método initCause(Throwable). Novas classes jogáveis que desejam permitir que as causas sejam associadas a elas devem fornecer construtores que levam uma causa e delegam (talvez indiretamente) a um dos construtores que utilizam uma causa. Como o método initCause é público, ele permite que uma causa seja associada a qualquer jogo, até mesmo um "throwable herdado" cuja implementação antecede a adição do mecanismo de encadeamento de exceções ao Throwable. Por convenção, a classe Throwable e suas subclasses têm dois construtores, um que não aceita argumentos e outro que usa um argumento String que pode ser usado para produzir uma mensagem de detalhes. Além disso, essas subclasses que provavelmente têm uma causa associada a elas devem ter mais dois construtores, um que usa um Throwable (a causa) e um que usa uma cadeia de caracteres (a mensagem de detalhes) e um Throwable (a causa).

Java referência para java.lang.Throwable.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Construtores

Nome	Description
JavaException()	Constrói um novo throwable com nulo como sua mensagem de detalhes.
JavaException(JniObjectReference, JniObjectReferenceOptions, JniObjectReference)	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
JavaException(JniObjectReference, JniObjectReferenceOptions)	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
JavaException(String, Exception)	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
JavaException(String)	Constrói um novo arremessável com a mensagem de detalhe especificada.

Campos

Nome	Description
InvalidJniObjectReference	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.

Propriedades

Nome	Description
JavaStackTrace	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
JniIdentityHashCode	Retorna o mesmo código hash para o objeto fornecido como seria retornado pelo método padrão hashCode(), independentemente de a classe do objeto determinado substituir hashCode().
JniManagedPeerState	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
JniPeerMembers	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
PeerReference	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
StackTrace	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.

Métodos

Nome	Description
Construct(JniObjectReference, JniObjectReferenceOptions)	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
Dispose()	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
Dispose(Boolean)	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
DisposeUnlessReferenced()	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
Equals(Object)	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
Finalize()	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
GetHashCode()	Retorna um valor de código hash para o objeto.
SetJavaStackTrace(JniObjectReference)	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
UnregisterFromRuntime()	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.

Implantações explícitas de interface

Nome	Description
IJavaPeerable.Disposed()	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
IJavaPeerable.Finalized()	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
IJavaPeerable.JniObjectReferenceControlBlock	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
IJavaPeerable.SetJniIdentityHashCode(Int32)	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.
IJavaPeerable.SetPeerReference(JniObjectReference)	A classe Throwable é a superclasse de todos os erros e exceções na linguagem Java.

Métodos de Extensão

Nome	Description
GetJniTypeName(IJavaPeerable)	Obtém o nome JNI do tipo da instância self.
JavaAs<TResult>(IJavaPeerable)	Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.