com.comphenix.protocol.error

Class DetailedErrorReporter

java.lang.Object

com.comphenix.protocol.error.DetailedErrorReporter

All Implemented Interfaces:

ErrorReporter

public class DetailedErrorReporter
extends java.lang.Object
implements ErrorReporter

Internal class used to handle exceptions.

Author:

Kristian

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	apacheCommonsMissing
static int	DEFAULT_MAX_ERROR_COUNT
static java.lang.String	DEFAULT_PREFIX
static java.lang.String	DEFAULT_SUPPORT_URL
protected boolean	detailedReporting
static java.lang.String	ERROR_PERMISSION
protected java.util.Map<java.lang.String,java.lang.Object>	globalParameters
protected java.util.concurrent.atomic.AtomicInteger	internalErrorCount
protected java.util.logging.Logger	logger
protected int	maxErrorCount
protected java.lang.String	pluginName
protected java.lang.ref.WeakReference<org.bukkit.plugin.Plugin>	pluginReference
protected java.lang.String	prefix
static ReportType	REPORT_EXCEPTION_COUNT Report format for printing the current exception count.
static java.lang.String	SECOND_LEVEL_PREFIX
protected java.lang.String	supportURL

Constructor Summary

Constructors

Constructor and Description
DetailedErrorReporter(org.bukkit.plugin.Plugin plugin) Create a default error reporting system.
DetailedErrorReporter(org.bukkit.plugin.Plugin plugin, java.lang.String prefix, java.lang.String supportURL) Create a central error reporting system.
DetailedErrorReporter(org.bukkit.plugin.Plugin plugin, java.lang.String prefix, java.lang.String supportURL, int maxErrorCount, java.util.logging.Logger logger) Create a central error reporting system.

Method Summary

Methods

Modifier and Type	Method and Description
void	addGlobalParameter(java.lang.String key, java.lang.Object value) Adds the given global parameter.
protected java.lang.String	addPrefix(java.lang.String text, java.lang.String prefix) Adds the given prefix to every line in the text.
void	clearGlobalParameters() Reset all global parameters.
int	getErrorCount() Retrieve the current number of errors printed through reportDetailed(Object, Report).
java.lang.Object	getGlobalParameter(java.lang.String key) Retrieve a global parameter by its key.
java.util.logging.Logger	getLogger() Retrieve the current logger that is used to print all reports.
int	getMaxErrorCount() Retrieve the maximum number of errors we can print before we begin suppressing errors.
java.lang.String	getPrefix() Retrieve the prefix to apply to every line in the error reports.
protected java.lang.String	getStringDescription(java.lang.Object value) Retrieve a string representation of the given object.
java.lang.String	getSupportURL() Retrieve the support URL that will be added to all detailed reports.
java.util.Set<java.lang.String>	globalParameters() Retrieve a set of every registered global parameter.
boolean	isDetailedReporting() Determine if we're using detailed error reporting.
protected boolean	isSimpleType(java.lang.Object test) Determine if the given object is a wrapper for a primitive/simple type or not.
void	reportDebug(java.lang.Object sender, Report.ReportBuilder builder) Prints a debug message from the current sender.
void	reportDebug(java.lang.Object sender, Report report) Prints a debug message from the current sender.
void	reportDetailed(java.lang.Object sender, Report.ReportBuilder reportBuilder) Prints a detailed error report about an unhandled exception.
void	reportDetailed(java.lang.Object sender, Report report) Prints a detailed error report about an unhandled exception.
void	reportMinimal(org.bukkit.plugin.Plugin sender, java.lang.String methodName, java.lang.Throwable error) Prints a small minimal error report regarding an exception from another plugin.
void	reportMinimal(org.bukkit.plugin.Plugin sender, java.lang.String methodName, java.lang.Throwable error, java.lang.Object... parameters) Prints a small minimal error report regarding an exception from another plugin.
boolean	reportMinimalNoSpam(org.bukkit.plugin.Plugin sender, java.lang.String methodName, java.lang.Throwable error) Report a problem with a given method and plugin, ensuring that we don't exceed the maximum number of error reports.
void	reportWarning(java.lang.Object sender, Report.ReportBuilder reportBuilder) Prints a warning message from the current plugin.
void	reportWarning(java.lang.Object sender, Report report) Prints a warning message from the current plugin.
void	setDetailedReporting(boolean detailedReporting) Set whether or not to use detailed error reporting.
void	setErrorCount(int errorCount) Set the number of errors printed.
void	setLogger(java.util.logging.Logger logger) Set the current logger that is used to print all reports.
void	setMaxErrorCount(int maxErrorCount) Set the maximum number of errors we can print before we begin suppressing errors.
void	setPrefix(java.lang.String prefix) Set the prefix to apply to every line in the error reports.
void	setSupportURL(java.lang.String supportURL) Set the support URL that will be added to all detailed reports.

Methods inherited from class java.lang.Object

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

Field Detail

REPORT_EXCEPTION_COUNT

public static final ReportType REPORT_EXCEPTION_COUNT

Report format for printing the current exception count.

SECOND_LEVEL_PREFIX

public static final java.lang.String SECOND_LEVEL_PREFIX

See Also:

Constant Field Values

DEFAULT_PREFIX

public static final java.lang.String DEFAULT_PREFIX

See Also:

Constant Field Values

DEFAULT_SUPPORT_URL

public static final java.lang.String DEFAULT_SUPPORT_URL

See Also:

Constant Field Values

ERROR_PERMISSION

public static final java.lang.String ERROR_PERMISSION

See Also:

Constant Field Values

DEFAULT_MAX_ERROR_COUNT

public static final int DEFAULT_MAX_ERROR_COUNT

See Also:

Constant Field Values

prefix

protected java.lang.String prefix

supportURL

protected java.lang.String supportURL

internalErrorCount

protected java.util.concurrent.atomic.AtomicInteger internalErrorCount

maxErrorCount

protected int maxErrorCount

logger

protected java.util.logging.Logger logger

pluginReference

protected java.lang.ref.WeakReference<org.bukkit.plugin.Plugin> pluginReference

pluginName

protected java.lang.String pluginName

apacheCommonsMissing

protected boolean apacheCommonsMissing

detailedReporting

protected boolean detailedReporting

globalParameters

protected java.util.Map<java.lang.String,java.lang.Object> globalParameters

Constructor Detail

DetailedErrorReporter

public DetailedErrorReporter(org.bukkit.plugin.Plugin plugin)

Create a default error reporting system.

DetailedErrorReporter

public DetailedErrorReporter(org.bukkit.plugin.Plugin plugin,
                     java.lang.String prefix,
                     java.lang.String supportURL)

Create a central error reporting system.

Parameters:

plugin - - the plugin owner.

prefix - - default line prefix.

supportURL - - URL to report the error.

DetailedErrorReporter

public DetailedErrorReporter(org.bukkit.plugin.Plugin plugin,
                     java.lang.String prefix,
                     java.lang.String supportURL,
                     int maxErrorCount,
                     java.util.logging.Logger logger)

Create a central error reporting system.

Parameters:

plugin - - the plugin owner.

prefix - - default line prefix.

supportURL - - URL to report the error.

maxErrorCount - - number of errors to print before giving up.

logger - - current logger.

Method Detail

isDetailedReporting

public boolean isDetailedReporting()

Determine if we're using detailed error reporting.

Returns:

TRUE if we are, FALSE otherwise.

setDetailedReporting

public void setDetailedReporting(boolean detailedReporting)

Set whether or not to use detailed error reporting.

Parameters:

detailedReporting - - TRUE to enable it, FALSE otherwise.

reportMinimal

public void reportMinimal(org.bukkit.plugin.Plugin sender,
                 java.lang.String methodName,
                 java.lang.Throwable error,
                 java.lang.Object... parameters)

Description copied from interface: ErrorReporter

Prints a small minimal error report regarding an exception from another plugin.

Specified by:

reportMinimal in interface ErrorReporter

Parameters:

sender - - the other plugin.

methodName - - name of the caller method.

error - - the exception itself.

parameters - - any relevant parameters to print.

reportMinimal

public void reportMinimal(org.bukkit.plugin.Plugin sender,
                 java.lang.String methodName,
                 java.lang.Throwable error)

Description copied from interface: ErrorReporter

Prints a small minimal error report regarding an exception from another plugin.

Specified by:

reportMinimal in interface ErrorReporter

Parameters:

sender - - the other plugin.

methodName - - name of the caller method.

error - - the exception itself.

reportMinimalNoSpam

public boolean reportMinimalNoSpam(org.bukkit.plugin.Plugin sender,
                          java.lang.String methodName,
                          java.lang.Throwable error)

Report a problem with a given method and plugin, ensuring that we don't exceed the maximum number of error reports.

Parameters:

sender - - the component that observed this exception.

methodName - - the method name.

error - - the error itself.

Returns:

TRUE if the error was printed, FALSE if it was suppressed.

reportDebug

public void reportDebug(java.lang.Object sender,
               Report.ReportBuilder builder)

Description copied from interface: ErrorReporter

Prints a debug message from the current sender.

Specified by:

reportDebug in interface ErrorReporter

Parameters:

sender - - the sender.

reportDebug

public void reportDebug(java.lang.Object sender,
               Report report)

Description copied from interface: ErrorReporter

Prints a debug message from the current sender.

Most users will not see this message.

Specified by:

reportDebug in interface ErrorReporter

Parameters:

sender - - the sender.

report - - the report.

reportWarning

public void reportWarning(java.lang.Object sender,
                 Report.ReportBuilder reportBuilder)

Description copied from interface: ErrorReporter

Prints a warning message from the current plugin.

Specified by:

reportWarning in interface ErrorReporter

Parameters:

sender - - the object containing the caller method.

reportBuilder - - an error report builder that will be used to get the report.

reportWarning

public void reportWarning(java.lang.Object sender,
                 Report report)

Description copied from interface: ErrorReporter

Prints a warning message from the current plugin.

Specified by:

reportWarning in interface ErrorReporter

Parameters:

sender - - the object containing the caller method.

report - - an error report to include.

reportDetailed

public void reportDetailed(java.lang.Object sender,
                  Report.ReportBuilder reportBuilder)

Description copied from interface: ErrorReporter

Prints a detailed error report about an unhandled exception.

Specified by:

reportDetailed in interface ErrorReporter

Parameters:

sender - - the object containing the caller method.

reportBuilder - - an error report builder that will be used to get the report.

reportDetailed

public void reportDetailed(java.lang.Object sender,
                  Report report)

Description copied from interface: ErrorReporter

Prints a detailed error report about an unhandled exception.

Specified by:

reportDetailed in interface ErrorReporter

Parameters:

sender - - the object containing the caller method.

report - - an error report to include.

addPrefix

protected java.lang.String addPrefix(java.lang.String text,
                         java.lang.String prefix)

Adds the given prefix to every line in the text.

Parameters:

text - - text to modify.

prefix - - prefix added to every line in the text.

Returns:

The modified text.

getStringDescription

protected java.lang.String getStringDescription(java.lang.Object value)

Retrieve a string representation of the given object.

Parameters:

value - - object to convert.

Returns:

String representation.

isSimpleType

protected boolean isSimpleType(java.lang.Object test)

Determine if the given object is a wrapper for a primitive/simple type or not.

Parameters:

test - - the object to test.

Returns:

TRUE if this object is simple enough to simply be printed, FALSE othewise.

getErrorCount

public int getErrorCount()

Retrieve the current number of errors printed through reportDetailed(Object, Report).

Returns:

Number of errors printed.

setErrorCount

public void setErrorCount(int errorCount)

Set the number of errors printed.

Parameters:

errorCount - - new number of errors printed.

getMaxErrorCount

public int getMaxErrorCount()

Retrieve the maximum number of errors we can print before we begin suppressing errors.

Returns:

Maximum number of errors.

setMaxErrorCount

public void setMaxErrorCount(int maxErrorCount)

Set the maximum number of errors we can print before we begin suppressing errors.

Parameters:

maxErrorCount - - new max count.

addGlobalParameter

public void addGlobalParameter(java.lang.String key,
                      java.lang.Object value)

Adds the given global parameter. It will be included in every error report.

Both key and value must be non-null.

Parameters:

key - - name of parameter.

value - - the global parameter itself.

getGlobalParameter

public java.lang.Object getGlobalParameter(java.lang.String key)

Retrieve a global parameter by its key.

Parameters:

key - - key of the parameter to retrieve.

Returns:

The value of the global parameter, or NULL if not found.

clearGlobalParameters

public void clearGlobalParameters()

Reset all global parameters.

globalParameters

public java.util.Set<java.lang.String> globalParameters()

Retrieve a set of every registered global parameter.

Returns:

Set of all registered global parameters.

getSupportURL

public java.lang.String getSupportURL()

Retrieve the support URL that will be added to all detailed reports.

Returns:

Support URL.

setSupportURL

public void setSupportURL(java.lang.String supportURL)

Set the support URL that will be added to all detailed reports.

Parameters:

supportURL - - the new support URL.

getPrefix

public java.lang.String getPrefix()

Retrieve the prefix to apply to every line in the error reports.

Returns:

Error report prefix.

setPrefix

public void setPrefix(java.lang.String prefix)

Set the prefix to apply to every line in the error reports.

Parameters:

prefix - - new prefix.

getLogger

public java.util.logging.Logger getLogger()

Retrieve the current logger that is used to print all reports.

Returns:

The current logger.

setLogger

public void setLogger(java.util.logging.Logger logger)

Set the current logger that is used to print all reports.

Parameters:

logger - - new logger.