Errors are managed by implementations of the
errorlist.ErrorSource
abstract class.
Extending this class is a bit involved and requires writing a lot of
low-level code; most
plugins can use the errorlist.DefaultErrorSource
class instead, which provides a very easy-to-use front-end.
The constructor for the DefaultErrorSource
class
accepts one parameter; a string that will identify the error source.
Currently, this identifier is not used, but in the future the ErrorList plugin
might show which error comes from which plugin, for example.
Error sources should be registered when the user first invokes your plugins. A plugin can create any number of error sources. The Console plugin, for example, maintains a separate error source for each console window, and registers an unregisters them as consoles are opened and closed.
To add an error source to the list of registered error sources, you must call
the static registerErrorSource()
method of the
errorlist.ErrorSource
class.
A corresponding unregisterErrorSource()
method must be
called before your plugin is unloaded to avoid leaking memory.