multex
Class Msg

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

public class Msg

extends java.lang.Object

Services for low-level reporting of any exception. The destinations can be of types OutputStream, Writer, String, and StringBuffer. The exception can be

• with parameters (subclass of Exc)
• with cause chain and parameters (subclass of Failure)
• or any standard Java exception (other subclass of java.lang.Throwable)

Field Summary

static java.lang.String

stackTraceFollows The String used to separate the message chain of an exception from the stack trace of it.

Method Summary

static java.lang.String	getMessages(java.lang.Throwable i_throwable) Returns the message texts of i_throwable and its chained causing exceptions.
static java.lang.String	getReport(java.lang.Throwable i_throwable) Returns the report of i_throwable and its chained causing exceptions.
static java.lang.String	getStackTrace(java.lang.Throwable i_throwable) Returns the compactified stack trace of i_throwable and its chained causing Throwable exceptions.
static void	printMessages(java.io.PrintStream io_destination, java.lang.Throwable i_throwable) Reports the message texts of i_throwable and its chained causing exceptions to io_destination
static void	printMessages(java.io.PrintWriter io_destination, java.lang.Throwable i_throwable) Reports the message texts of i_throwable and its chained causing exceptions to io_destination
static void	printMessages(java.lang.StringBuffer io_destination, java.lang.Throwable i_throwable) Appends the message texts of i_throwable and its chained causing exceptions to io_destination.
static void	printMessages(java.lang.StringBuffer io_destination, java.lang.Throwable i_throwable, MultexLocale i_locale, java.lang.String i_lineSeparator) Prints the message texts of i_throwable and its chained causing exceptions, detail description here.
static void	printMessages(java.lang.Throwable i_throwable) Reports the message texts of i_throwable and its chained causing exceptions to System.err
static void	printReport(java.io.PrintStream io_destination, java.lang.Throwable i_throwable) Reports i_throwable and its chained causing exceptions to io_destination
static void	printReport(java.io.PrintWriter io_destination, java.lang.Throwable i_throwable) Reports i_throwable and its chained causing exceptions to io_destination
static void	printReport(java.lang.StringBuffer io_destination, java.lang.Throwable i_throwable) Reports i_throwable and its chained causing exceptions to io_destination, detail description here.
static void	printReport(java.lang.Throwable i_throwable) Reports i_throwable and its chained causing exceptions to System.err
static void	printStackTrace(java.io.PrintStream io_destination, java.lang.Throwable i_throwable) Prints the compactified stack trace of i_throwable and its chained causing Throwable exceptions to io_destination.
static void	printStackTrace(java.io.PrintWriter io_destination, java.lang.Throwable i_throwable) Prints the compactified stack trace of i_throwable and its chained causing Throwable exceptions to io_destination.
static void	printStackTrace(java.lang.StringBuffer io_destination, java.lang.Throwable i_throwable) Prints the compactified stack trace of i_throwable and its chained causing Throwable exceptions appending it to io_destination with the default platform line separator.
static void	printStackTrace(java.lang.StringBuffer io_destination, java.lang.Throwable i_throwable, java.lang.String i_lineSeparator) Prints the compactified stack trace of i_throwable and all its chained causing Throwable exceptions appending it to io_destination, detail description here.
static void	printStackTrace(java.lang.Throwable i_throwable) Prints the compactified stack trace of i_throwable and its chained causing Throwable exceptions to System.err.

Methods inherited from class java.lang.Object

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

Field Detail

stackTraceFollows

public static java.lang.String stackTraceFollows

The String used to separate the message chain of an exception from the stack trace of it.

Method Detail

printReport

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

Reports i_throwable and its chained causing exceptions to System.err

See Also:

printReport(StringBuffer,Throwable)

printReport

public static void printReport(java.io.PrintStream io_destination,
                               java.lang.Throwable i_throwable)

Reports i_throwable and its chained causing exceptions to io_destination

See Also:

printReport(StringBuffer,Throwable)

printReport

public static void printReport(java.io.PrintWriter io_destination,
                               java.lang.Throwable i_throwable)

Reports i_throwable and its chained causing exceptions to io_destination

See Also:

printReport(StringBuffer,Throwable)

printReport

public static void printReport(java.lang.StringBuffer io_destination,
                               java.lang.Throwable i_throwable)

Reports i_throwable and its chained causing exceptions to io_destination, detail description here. Reports the message chain of i_throwable by printMessages(StringBuffer,Throwable) and the stack trace of i_throwable by printStackTrace(StringBuffer,Throwable). The report is appended to io_destination.

getReport

public static java.lang.String getReport(java.lang.Throwable i_throwable)

Returns the report of i_throwable and its chained causing exceptions.

See Also:

printReport(StringBuffer,Throwable)

printMessages

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

Reports the message texts of i_throwable and its chained causing exceptions to System.err

See Also:

printMessages(StringBuffer,Throwable)

printMessages

public static void printMessages(java.io.PrintStream io_destination,
                                 java.lang.Throwable i_throwable)

Reports the message texts of i_throwable and its chained causing exceptions to io_destination

See Also:

printMessages(StringBuffer,Throwable)

printMessages

public static void printMessages(java.io.PrintWriter io_destination,
                                 java.lang.Throwable i_throwable)

Reports the message texts of i_throwable and its chained causing exceptions to io_destination

See Also:

printMessages(StringBuffer,Throwable)

getMessages

public static java.lang.String getMessages(java.lang.Throwable i_throwable)

Returns the message texts of i_throwable and its chained causing exceptions.

See Also:

printMessages(StringBuffer,Throwable)

printMessages

public static void printMessages(java.lang.StringBuffer io_destination,
                                 java.lang.Throwable i_throwable)

Appends the message texts of i_throwable and its chained causing exceptions to io_destination.

See Also:

printMessages(StringBuffer,Throwable,MultexLocale,String)

printMessages

public static void printMessages(java.lang.StringBuffer io_destination,
                                 java.lang.Throwable i_throwable,
                                 MultexLocale i_locale,
                                 java.lang.String i_lineSeparator)

Prints the message texts of i_throwable and its chained causing exceptions, detail description here. Reports the parameterized textual message of i_throwable, or if this is not available, the name and parameters of i_throwable. Reports the same for each in the chain of the eventually existing causing Throwable exceptions. The message texts for the exceptions are taken by MsgText.appendMessageChain(java.lang.StringBuffer, java.lang.Throwable, java.lang.String). The concept of chaining causing exceptions is described in the class Failure.

Parameters:

io_destination - Where the messages are appended to.

i_throwable - The exception, which is printed with its causal chain.

i_locale - How to localize the exception message, parameters and cause marker. For default localization without a message text file take MultexLocale.nullLocale.

i_lineSeparator - What separates the lines in the messages. If null, defaults to Failure.lineSeparator.

printStackTrace

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

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

See Also:

printStackTrace(StringBuffer,Throwable)

printStackTrace

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

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

See Also:

printStackTrace(StringBuffer,Throwable)

printStackTrace

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

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

See Also:

printStackTrace(StringBuffer,Throwable)

getStackTrace

public static java.lang.String getStackTrace(java.lang.Throwable i_throwable)

Returns the compactified stack trace of i_throwable and its chained causing Throwable exceptions.

See Also:

printStackTrace(StringBuffer,Throwable)

printStackTrace

public static void printStackTrace(java.lang.StringBuffer io_destination,
                                   java.lang.Throwable i_throwable)

Prints the compactified stack trace of i_throwable and its chained causing Throwable exceptions appending it to io_destination with the default platform line separator.

See Also:

printStackTrace(StringBuffer,Throwable,String)

printStackTrace

public static void printStackTrace(java.lang.StringBuffer io_destination,
                                   java.lang.Throwable i_throwable,
                                   java.lang.String i_lineSeparator)

Prints the compactified stack trace of i_throwable and all its chained causing Throwable exceptions appending it to io_destination, detail description here. All redundant location lines in the stack traces therein are suppressed.

Parameters:

io_destination - Where to append the compactified stack trace.

i_throwable - The exception to report, possibly containing a chain of nested cause exceptions.

i_lineSeparator - The String following each of the stack trace lines, if null defaults to the standard platform line separator.

See Also:

Failure.lineSeparator