Class TraceChannel

java.lang.Object
com.gargoylesoftware.base.trace.TraceChannel

public class TraceChannel extends Object
This class represents a "channel" that diagnostic messages can be written to. The channel will contain zero or more TraceWriters which will be responsible for handling the messages.
Version:
$Revision: 1.3 $
  • Field Details

    • name_

      private final String name_
    • isEnabled_

      private boolean isEnabled_
    • propertyChangeSupport_

      private PropertyChangeSupport propertyChangeSupport_
    • traceWriters_

      private final Set traceWriters_
  • Constructor Details

    • TraceChannel

      public TraceChannel(String name)
      Create a trace channel with the specified name.
      Parameters:
      name - The name of the channel.
  • Method Details

    • getName

      public final String getName()
      Return the name of this trace channel.
      Returns:
      the name.
    • toString

      public String toString()
      Return a string representation of this object.
      Overrides:
      toString in class Object
      Returns:
      a string representation of this object.
    • setEnabled

      public void setEnabled(boolean isEnabled)
      Set whether or not this channel is enabled. If it is not enabled then any requests sent to this channel will be discarded.
      Parameters:
      isEnabled - true if this channel should be enabled.
    • isEnabled

      public boolean isEnabled()
      Return true if this channel is enabled.
      Returns:
      true if this channel is enabled.
    • addPropertyChangeListener

      public void addPropertyChangeListener(PropertyChangeListener listener)
      Add a property change listener.
      Parameters:
      listener - The new listener
    • removePropertyChangeListener

      public void removePropertyChangeListener(PropertyChangeListener listener)
      Remove a property change listener.
      Parameters:
      listener - The listener to remove
    • getTraceWriters

      Set getTraceWriters()
      Return a collection of trace writers
      Returns:
      The trace writers
    • addTraceWriter

      public void addTraceWriter(TraceWriter writer)
      Add a trace writer.
      Parameters:
      writer - A trace writer
    • removeTraceWriter

      public void removeTraceWriter(TraceWriter writer)
      Remove a trace writer.
      Parameters:
      writer - A trace writer
    • assertNotNull

      protected final void assertNotNull(String fieldName, Object fieldValue) throws DetailedNullPointerException
      Verify that the specified value is not null. If it is then throw an exception
      Parameters:
      fieldName - The name of the field to check
      fieldValue - The value of the field to check
      Throws:
      DetailedNullPointerException - If fieldValue is null