genius.core.exceptions

Class Warning

java.lang.Object

genius.core.exceptions.Warning

public class Warning
extends java.lang.Object

Warning objects handle warning messages. These objects also count how many times a particular type of message has been issued already. You can ask for a stack dump as well.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Warning.MyWarningException

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_SUPPRESSION_NUMBER

Constructor Summary

Constructors

Constructor and Description
Warning(java.lang.String warning) Default warning: Print warning message at most 5 times.
Warning(java.lang.String warning, boolean showstack, int suppressat) The location of the error will be reported as the code location where this warning is placed.
Warning(java.lang.String pWarning, java.lang.Exception err)
Warning(java.lang.String pWarning, java.lang.Exception err, boolean pShowStack, int pSuppressAt) Note that this is not useful if you are converting an exception into a warning.

Method Summary

Modifier and Type	Method and Description
void	makeWarning(java.lang.String pWarning, java.lang.Exception e, boolean pDumpStack, int pSuppressAt) Add warning to static hashtable used to keep track of all warnings issued so far.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_SUPPRESSION_NUMBER

public static final int DEFAULT_SUPPRESSION_NUMBER

See Also:

Constant Field Values

Constructor Detail

Warning

public Warning(java.lang.String warning)

Default warning: Print warning message at most 5 times. Stack trace is not printed.

Warning

public Warning(java.lang.String warning,
               boolean showstack,
               int suppressat)

The location of the error will be reported as the code location where this warning is placed. Note that this is not useful if you are converting an exception into a warning. In that case, you better use Warning(warning, Exception).

Parameters:

warning - is the message to be shown

showstack - is true if you want to show a stack dump as well. Then, stack dump will be made for location where WARNING occurs

suppressat - is the maximum number of this warning you want to appear

Warning

public Warning(java.lang.String pWarning,
               java.lang.Exception err)

Warning

public Warning(java.lang.String pWarning,
               java.lang.Exception err,
               boolean pShowStack,
               int pSuppressAt)

Note that this is not useful if you are converting an exception into a warning. In that case, you better use Warning(warning, Exception)

Parameters:

pWarning - is the message to be shown

err - is the exception that caused the rise of this warning. this will be used to inform the user about where the problem occured.

pShowStack - is true if you want to show a stack dump as well. If set, stack dump will be made for location where WARNING occurs.

pSuppressAt - is the maximum number of this warning you want to appear

Method Detail

makeWarning

public void makeWarning(java.lang.String pWarning,
                        java.lang.Exception e,
                        boolean pDumpStack,
                        int pSuppressAt)

Add warning to static hashtable used to keep track of all warnings issued so far. Only show warning if message has not appeared more than 'fSuppressAt' times.

Parameters:

e - is exception that caused the problem. Use null to avoid stack dump.