org.dmd.util.debug

Class DebugManager

java.lang.Object

org.dmd.util.debug.DebugManager

public class DebugManager
extends Object

The DebugManager provides a simple mechanism to access different categories of debug information. Although there are many mechanisms to add logging to a system, those mechanisms tend to relate to an entire system i.e. if you set a logging level to FINE or FINEST, you get all of the logs at that level of granularity. When you're trying to focus on a particular subsystem, that approach can often flood your logs with information that obscures the information you're trying to use to solve a problem.

In other cases, you want to be able to turn on debugging in a particular area while the system is running; this mechanism allows for that as well.

You can also see all categories of logging that are available (for subsystems that use these mechanisms), so it lends itself to being able to have a UI to turn logging on/off for various aspects.

Method Summary

Modifier and Type	Method and Description
DebugChannelIF	advertise(DebugCategoryIF dc)
Iterator<DebugCategoryIF>	getCategories()
Iterator<DebugCategoryIF>	getCategoriesByTag(String tag)
static DebugManager	instance()
void	preregister(DebugHandlerIF handler, String tag) Lets a debug handler preregister interest in categories that have this tag.

Methods inherited from class java.lang.Object

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

Method Detail

instance

public static DebugManager instance()

preregister

public void preregister(DebugHandlerIF handler,
                        String tag)

Lets a debug handler preregister interest in categories that have this tag. When the category is advertised, we'll subscribe any interested handlers.

Parameters:

tag -

advertise

public DebugChannelIF advertise(DebugCategoryIF dc)

getCategoriesByTag

public Iterator<DebugCategoryIF> getCategoriesByTag(String tag)

getCategories

public Iterator<DebugCategoryIF> getCategories()