Package org.slf4j

Interface Marker

  • All Superinterfaces:
    Serializable
    All Known Implementing Classes:
    BasicMarker

    public interface Marker
    extends Serializable
    Markers are named objects used to enrich log statements. Conforming logging system Implementations of SLF4J determine how information conveyed by markers are used, if at all. In particular, many conforming logging systems ignore marker data.

    Markers can contain references to other markers, which in turn may contain references of their own.

    Author:
    Ceki Gülcü
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static String ANY_MARKER
      This constant represents any marker, including a null marker.
      static String ANY_NON_NULL_MARKER
      This constant represents any non-null marker.
    • Method Summary

      All Methods Instance Methods Abstract Methods Deprecated Methods 
      Modifier and Type Method Description
      void add​(Marker reference)
      Add a reference to another Marker.
      boolean contains​(String name)
      Does this marker contain the marker named 'name'? If 'name' is null the returned value is always false.
      boolean contains​(Marker other)
      Does this marker contain a reference to the 'other' marker? Marker A is defined to contain marker B, if A == B or if B is referenced by A, or if B is referenced by any one of A's references (recursively).
      boolean equals​(Object o)
      Markers are considered equal if they have the same name.
      String getName()
      Get the name of this Marker.
      boolean hasChildren()
      Deprecated.
      Replaced by hasReferences().
      int hashCode()
      Compute the hash code based on the name of this marker.
      boolean hasReferences()
      Does this marker have any references?
      Iterator<Marker> iterator()
      Returns an Iterator which can be used to iterate over the references of this marker.
      boolean remove​(Marker reference)
      Remove a marker reference.
    • Method Detail

      • getName

        String getName()
        Get the name of this Marker.
        Returns:
        name of marker
      • add

        void add​(Marker reference)
        Add a reference to another Marker.
        Parameters:
        reference - a reference to another marker
        Throws:
        IllegalArgumentException - if 'reference' is null
      • remove

        boolean remove​(Marker reference)
        Remove a marker reference.
        Parameters:
        reference - the marker reference to remove
        Returns:
        true if reference could be found and removed, false otherwise.
      • hasReferences

        boolean hasReferences()
        Does this marker have any references?
        Returns:
        true if this marker has one or more references, false otherwise.
      • iterator

        Iterator<Markeriterator()
        Returns an Iterator which can be used to iterate over the references of this marker. An empty iterator is returned when this marker has no references.
        Returns:
        Iterator over the references of this marker
      • contains

        boolean contains​(Marker other)
        Does this marker contain a reference to the 'other' marker? Marker A is defined to contain marker B, if A == B or if B is referenced by A, or if B is referenced by any one of A's references (recursively).
        Parameters:
        other - The marker to test for inclusion.
        Returns:
        Whether this marker contains the other marker.
        Throws:
        IllegalArgumentException - if 'other' is null
      • contains

        boolean contains​(String name)
        Does this marker contain the marker named 'name'? If 'name' is null the returned value is always false.
        Parameters:
        name - The marker name to test for inclusion.
        Returns:
        Whether this marker contains the other marker.
      • equals

        boolean equals​(Object o)
        Markers are considered equal if they have the same name.
        Overrides:
        equals in class Object
        Parameters:
        o -
        Returns:
        true, if this.name equals o.name
        Since:
        1.5.1
      • hashCode

        int hashCode()
        Compute the hash code based on the name of this marker. Note that markers are considered equal if they have the same name.
        Overrides:
        hashCode in class Object
        Returns:
        the computed hashCode
        Since:
        1.5.1