net.sf.jomic.tools
Class ErrorTools

java.lang.Object
  net.sf.jomic.tools.ErrorTools

public final class ErrorTools
extends java.lang.Object

Tools for error handling and reporting. This class is self contained and does not require any other classes from the tools package, therefor its methods can be used to handle errors right from the beginning.

Author:

Thomas Aglassinger

Method Summary

void	centerUp(java.awt.Component frame) Center frame in upper half of the screen.
javax.swing.JDialog	createDialog(javax.swing.JFrame owner, int type, java.lang.String message, java.lang.Throwable error, boolean modal) Create error dialog.
java.lang.String	getDetailedExceptionMessage(java.lang.Throwable error) Get detailed exception message by concatenating getMessage() of error and all nested exceptions.
int	getMessageCount() Get number of message dialogs shown so far.
java.lang.String	getStackTrace(java.lang.Throwable error) Stack trace as string.
java.lang.String	getTitle(int type)
static ErrorTools	instance()
void	setCannotChangePropertyText(java.lang.String newCannotChangePropertyText)
void	setCannotProcessActionCommand(java.lang.String newCannotProcessActionCommand)
void	setCannotProcessActionEvent(java.lang.String newCannotProcessActionEvent)
void	setShowStackTraceText(java.lang.String newText) Set text for "Show stack trace button" in dialogs.
void	setTitle(int type, java.lang.String title) Set title for dialog of a certain type.
void	showError(java.awt.event.ActionEvent event, java.lang.Throwable error) Show error message for being unable to process event (which may be null).
void	showError(java.beans.PropertyChangeEvent event, java.lang.Throwable error) Show error message for being unable to change property according to event.
void	showErrorMessage(javax.swing.JFrame owner, java.lang.String message, java.lang.Throwable error) Show error dialog.
void	showMessage(javax.swing.JFrame owner, int type, java.lang.String message, java.lang.Throwable error, boolean modal) Show error dialog, optionally allowing user to inspect call stack.
java.lang.String	titled(java.lang.String some) Some as some, but with the first character converted to title case.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

setCannotChangePropertyText

public void setCannotChangePropertyText(java.lang.String newCannotChangePropertyText)

setCannotProcessActionCommand

public void setCannotProcessActionCommand(java.lang.String newCannotProcessActionCommand)

setCannotProcessActionEvent

public void setCannotProcessActionEvent(java.lang.String newCannotProcessActionEvent)

setShowStackTraceText

public void setShowStackTraceText(java.lang.String newText)

Set text for "Show stack trace button" in dialogs.

See Also:

createDialog(JFrame, int, String, Throwable, boolean)

setTitle

public void setTitle(int type,
                     java.lang.String title)

Set title for dialog of a certain type.

Parameters:

type - one of JOptionPane.*_MESSAGE

See Also:

JOptionPane

getDetailedExceptionMessage

public java.lang.String getDetailedExceptionMessage(java.lang.Throwable error)

Get detailed exception message by concatenating getMessage() of error and all nested exceptions.

See Also:

Throwable.getCause()

getMessageCount

public int getMessageCount()

Get number of message dialogs shown so far.

getStackTrace

public java.lang.String getStackTrace(java.lang.Throwable error)

Stack trace as string.

getTitle

public java.lang.String getTitle(int type)

instance

public static ErrorTools instance()

centerUp

public void centerUp(java.awt.Component frame)

Center frame in upper half of the screen.

createDialog

public javax.swing.JDialog createDialog(javax.swing.JFrame owner,
                                        int type,
                                        java.lang.String message,
                                        java.lang.Throwable error,
                                        boolean modal)

Create error dialog.

Parameters:

owner - Frame to which error belongs, or null

type - one of JOptionPane.*_MESSAGE

error - null or stack that caused error

showError

public void showError(java.beans.PropertyChangeEvent event,
                      java.lang.Throwable error)

Show error message for being unable to change property according to event.

showError

public void showError(java.awt.event.ActionEvent event,
                      java.lang.Throwable error)

Show error message for being unable to process event (which may be null).

showErrorMessage

public void showErrorMessage(javax.swing.JFrame owner,
                             java.lang.String message,
                             java.lang.Throwable error)

Show error dialog.

See Also:

showErrorMessage(JFrame, String, Throwable)

showMessage

public void showMessage(javax.swing.JFrame owner,
                        int type,
                        java.lang.String message,
                        java.lang.Throwable error,
                        boolean modal)

Show error dialog, optionally allowing user to inspect call stack.

Parameters:

owner - Frame to which error belongs, or null

type - one of JOptionPane.*_MESSAGE

error - Throwable that caused the error, or null

modal - true to wait for user to click dialog away

See Also:

JOptionPane, createDialog(JFrame, int, String, Throwable, boolean)

titled

public java.lang.String titled(java.lang.String some)

Some as some, but with the first character converted to title case.

See Also:

Character.toTitleCase(char)