SwingX - JXErrorPane

O objetivo do JXErrorPane é mostrar mensagens de erro, advertências e a ocorrência de fatal errors aos usuários. JXErrorPane tem o foco em erros irrecuperáveis.

Pode ser configurado para permitir ao usuário relatar o ocorrido ao desenvolvedor do software em questão através de um botão Report.

O usuário pode ver os detalhes relacionados ao erro através do botão Details.

JXErrorPane in Action (1)

É simples e direto utilizar o JXErrorPane. Veja o código abaixo.

try {
.....// Alguma coisa deu errado aqui.
} catch (Exception Ex) {
.....// ErrorInfo encapsula dados sobre o erro.
.....ErrorInfo info = new ErrorInfo(
....................// Título da janela.
...................."Erro ao Tentar Navegar para o Item.",
....................// Breve descrição do erro.
...................."Esse item não existe.",
....................// Descrição detalhada do erro.
....................null,
....................// Categoria, serve para identificar onde o erro ocorreu.
....................// É recomendável utilizar o mesmo nome que teria utilizando logging.
...................."org.testswingx.jxerrorpane",
....................// Throwable, utilizado para obter informações sobre o erro úteis para os desenvolvedores.
....................ex,
....................// Nível do erro.
....................org.jdesktop.swingx.error.ErrorLevel.SEVERE,
....................// O estado do aplicativo no momento em que o erro ocorreu.
....................null);
.....JXErrorPane.showDialog(null, info);
}

Basta encapsular os detalhes do erro em org.jdesktop.swingx.error.ErrorInfo e utilizar o método showDialog(Component owner, ErrorInfo info) de JXErrorPane.


Pode ser melhor mostrar ao usuário uma mensagem mais amigável que o stack trace do erro.

try {
.....// Alguma coisa deu errado aqui.
} catch (Exception Ex) {
.....ErrorInfo info = new ErrorInfo(
..................."Erro ao Tentar Navegar para o Item.",
..................."Esse item não existe.",
....................// Mensagem mais amigável ao usuário, pode inclusive contar com tags html.
..................."Por favor, contate o administrador do sistema.",
..................."org.testswingx.jxerrorpane",
....................null,
....................org.jdesktop.swingx.error.ErrorLevel.SEVERE,
....................null);
.....JXErrorPane.showDialog(null, info);
}


Em situações críticas, é possível encerrar a execução do aplicativo. Basta ajustar o nível de erro em ErrorInfo para ErrorLevel.FATAL.


JXErrorPane in Action (2)

A funcionalidade de maior destaque do JXErrorPane é a possibilidade do usuário do aplicativo relatar o erro ao desenvolvedor do software por e-mail, RSS, ou o que for mais adequado, através de um botão Report.

Basta implementar o método reportError(ErrorInfo info) da interface org.jdesktop.swingx.error.ErrorReporter, e chamar o método setErrorReporter(ErrorReporter reporter) numa instância de JXErrorPane.

private final JXErrorPane errorPane = new JXErrorPane();
. . .
errorPane.setErrorReporter(new EmailErrorReporter());
errorPane.setErrorInfo(info);
JXErrorPane.showDialog(null, errorPane);


Veja outros componentes SwingX em:

• SwingX

Referências:

• org.jdesktop.swingx.JXErrorPane
• org.jdesktop.swingx.error.ErrorInfo
• org.jdesktop.swingx.error.ErrorReporter