multex
Class Msg

java.lang.Object
  |
  +--multex.Msg

public class Msg

extends java.lang.Object

Services for reporting messages for exceptions

• with parameters (subclasses of Exc)
• with cause chain and parameters (subclasses of Failure)
• and standard Java exceptions (other subclasses of java.lang.Throwable)

Method Summary

static void	printStackTrace(java.io.PrintStream io_printer, java.lang.Throwable i_throwable) Prints the compactified stack trace of i_throwable and its chained causing exceptions to io_printer.
static void	printStackTrace(java.io.PrintWriter io_printer, java.lang.Throwable i_throwable) Prints the compactified stack trace of i_throwable and its chained causing exceptions to io_printer.
static void	printStackTrace(java.lang.Throwable i_throwable) Prints the compactified stack trace of i_throwable and its chained causing exceptions to System.err.
static void	report(java.applet.Applet io_owner, java.lang.Throwable i_throwable) Reports i_throwable from Applet io_owner.
static void	report(java.awt.Dialog io_owner, java.lang.Throwable i_throwable) Reports i_throwable blocking io_owner.
static void	report(java.awt.Frame io_owner, java.lang.Throwable i_throwable) Reports i_throwable blocking io_owner.
static void	report(java.io.PrintStream io_printer, java.lang.Throwable i_throwable) Reports i_throwable to io_printer
static void	report(java.io.PrintWriter io_printer, java.lang.Throwable i_throwable) Reports i_throwable to io_printer, detail description here.
static void	report(java.lang.Throwable i_throwable) Reports i_throwable to System.err

Methods inherited from class java.lang.Object

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

Method Detail

report

public static void report(java.awt.Dialog io_owner,
                          java.lang.Throwable i_throwable)

Reports i_throwable blocking io_owner. Reports the same contents as report(Frame, Throwable).

See Also:

report(java.awt.Frame,Throwable)

report

public static void report(java.applet.Applet io_owner,
                          java.lang.Throwable i_throwable)

Reports i_throwable from Applet io_owner. Reports the same contents as report(Frame, Throwable). It seems impossible to block further input to io_owner. But nevertheless closing of the browser will close this dialog window, too.

See Also:

report(java.awt.Frame,Throwable)

report

public static void report(java.awt.Frame io_owner,
                          java.lang.Throwable i_throwable)

Reports i_throwable blocking io_owner. Firstly reports the same as report(PrintWriter, Throwable) into a modal pop-up window of appropriate size. Accepting the message is done by

• clicking on the "close window" icon, or
• clicking on the OK-button, or
• typing on the OK-button

Each of these will close the dialog box.

The Button "Show Stack Trace" will add the compactified stack trace including the chain of all causing exceptions to the message dialog box. The contents of the compact stack trace are described at method Failure.printCompactStackTrace(StringBuffer,Throwable,Exception).

Blocks further input to io_owner, until this message window will be closed.

In an application this method should not be called directly from a GUI class, but the author of each GUI class should set up a method

private void _report(Throwable e){Msg.report(this,e);}

, which will be called from each catch-clause in the event listeners and adds the actual GUI class as the owner of the message dialog.

See Also:

report(java.io.PrintWriter,Throwable), Failure.printCompactStackTrace(StringBuffer,Throwable,Exception)

report

public static void report(java.lang.Throwable i_throwable)

Reports i_throwable to System.err

See Also:

report(java.io.PrintWriter,Throwable)

report

public static void report(java.io.PrintStream io_printer,
                          java.lang.Throwable i_throwable)

Reports i_throwable to io_printer

See Also:

report(java.io.PrintWriter,Throwable)

report

public static void report(java.io.PrintWriter io_printer,
                          java.lang.Throwable i_throwable)

Reports i_throwable to io_printer, detail description here. Reports the paramerized textual message of i_throwable, or if this is not available, the name and parameters of i_throwable. Reports the same for each of the eventually existing chain of causing Exception-s. The message texts for the exceptions are taken via MsgText.getMessageLine. The concept of chaining causing exceptions is described in the class Failure.

See Also:

MsgText.getMessageLine(Throwable), Failure

printStackTrace

public static void printStackTrace(java.lang.Throwable i_throwable)

Prints the compactified stack trace of i_throwable and its chained causing exceptions to System.err.

See Also:

printStackTrace(java.io.PrintWriter,Throwable)

printStackTrace

public static void printStackTrace(java.io.PrintStream io_printer,
                                   java.lang.Throwable i_throwable)

Prints the compactified stack trace of i_throwable and its chained causing exceptions to io_printer.

See Also:

printStackTrace(java.io.PrintWriter,Throwable)

printStackTrace

public static void printStackTrace(java.io.PrintWriter io_printer,
                                   java.lang.Throwable i_throwable)

Prints the compactified stack trace of i_throwable and its chained causing exceptions to io_printer. The contents is provided by the method Failure.printCompactStackTrace.

See Also:

Failure.printCompactStackTrace(StringBuffer,Throwable,Exception)