Package eu.bandm.tools.message

Class Message

java.lang.Object
eu.bandm.tools.message.Message
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
SimpleMessage
public abstract class Message extends Object implements Serializable
Abstract base class of the metatools message architecture.
Does have as attributes only a Kind, a timestamp and a cause. All message processing classes in this package (derived from MessageReceiver) operate on this data, resp. on a subclass thereof.
See Also:

  • Field Details

    • kind

      protected final Message.Kind kind
      The kind of the message.

    • timestamp

      protected long timestamp
      The system time when this message is created.

    • cause

      @Opt protected @Opt Throwable cause
      A throwable which has been caught and thus caused this message.

    • DEFAULT_LEVEL

      public static final int DEFAULT_LEVEL
      Value of level, unless explicitly given.
      See Also:

    • level

      protected int level
      Numeric qualification, can by used to realize levels of verbosity.
      See Also:

    • emptyStackTrace

      public static final StackTraceElement[] emptyStackTrace
      An empty stack trace.

  • Constructor Details

    • Message

      protected Message(Message.Kind k)
      Create a message with only kind and timestamp set.
      Parameters:
      k - the kind of the message.

    • Message

      protected Message(Message.Kind k, @Opt @Opt Throwable e)
      Create a message with kind, cause, and timestamp set.
      Parameters:
      k - the kind of the message.
      e - the cause of the message.

    • Message

      protected Message(Message.Kind k, int v)
      Create a message with kind, level, and timestamp set.
      Parameters:
      k - the kind of the message.
      v - the level of the message.

    • Message

      protected Message(Message.Kind k, int v, @Opt @Opt Throwable e)
      Create a message with kind, level, cause, and timestamp set.
      Parameters:
      k - the kind of the message.
      v - the level of the message.
      e - the cause of the message.

    • Message

      protected Message(@Opt @Opt Throwable e)
      Creates a message of Message.Kind.failure kind.
      Parameters:
      e - the cause of the message.

    • Message

      protected Message(Message original)
      Creates a clone, but with newer date,
      Parameters:
      original - the message to clone.

  • Method Details

    • getKind

      public final Message.Kind getKind()
      Returns the kind of the message.
      Returns:
      the kind of the message.

    • getLevel

      public final int getLevel()
      Returns the level of the message.
      Returns:
      the level of the message.

    • adjustTimeStamp

      void adjustTimeStamp(long ts)
      Not public, only for internal re-adjustment after a clone.
      Parameters:
      ts - the new value of the time stamp.

    • isCritical

      public final boolean isCritical()
      Distinguishes between Message.Kind.error and Message.Kind.failure as "critical" and all others as "uncritical".
      Returns:
      whether the message is of kind failure or error.
      See Also:

    • getTimeStamp

      public final long getTimeStamp()
      Returns the time when this message was constructed. It is encoded according to System.currentTimeMillis().
      Returns:
      the time when this message was constructed.

    • getCause

      @Opt public final @Opt Throwable getCause()
      Returns the cause of the message.
      Returns:
      the cause of the message.

    • getStackTrace

      public final StackTraceElement[] getStackTrace()
      Returns a StackTraceElement[] taken from the "cause", if there is one.

      The "cause" is the Throwable returned by getCause(). Iff this is null, the method returns an empty array.

      Returns:
      the stack trace form the ".cause", if there is any,

    • toString

      public String toString()
      Delivers a primitive visualisation, required for tracing and debugging. An actual user-level MessagePrinter or sim., will provide much more elaborate rendering.
      Overrides:
      toString in class Object

    • explode

      public RuntimeException explode()
      Throws an exception carrying this message.
      Returns:
      nothing; the return type is RuntimeException nevertheless. The calling code can use this method as the argument to a throw statement to inform the Java compiler's control flow analysis that the call never completes normally.
      Throws:
      MessageException - which encapsulates this Message