Package org.apache.qpid.jms.tracing

Interface TraceableMessage

All Known Subinterfaces:
JmsBytesMessageFacade, JmsMapMessageFacade, JmsMessageFacade, JmsObjectMessageFacade, JmsStreamMessageFacade, JmsTextMessageFacade
All Known Implementing Classes:
AmqpJmsBytesMessageFacade, AmqpJmsMapMessageFacade, AmqpJmsMessageFacade, AmqpJmsObjectMessageFacade, AmqpJmsStreamMessageFacade, AmqpJmsTextMessageFacade
public interface TraceableMessage
Interface which allows generic tracing interactions with Messages from the client.

  • Method Details

    • getTracingContext

      Object getTracingContext(String key)
      Gets some trace related context from the message for use by the tracing implementation.

      Allows the Tracing implementation to store context data into the message without the message needing to know what the types or structure of that data is.

      Parameters:
      key - The name of the context element to be looked up.
      Returns:
      the stored tracing context element or null if not present.

    • setTracingContext

      Object setTracingContext(String key, Object value)
      Sets some trace related context from the message for use by the tracing implementation.

      Allows the Tracing implementation to store context data into the message without the message needing to know what the types or structure of that data is.

      Parameters:
      key - The key that the tracing context element should be stored under.
      value - The value to store under the given key.
      Returns:
      the previous value stored under the given key if any present.

    • removeTracingContext

      Object removeTracingContext(String key)
      Removes some trace related context from the message.
      Parameters:
      key - The key of the tracing context element that should be cleared.
      Returns:
      the previous value stored under the given key if any present.

    • getTracingAnnotation

      Object getTracingAnnotation(String key)
      Gets some trace specific message annotation that was previously applied to the given message either locally or by a remote peer.
      Parameters:
      key - The name of the tracing annotation data to retrieve.
      Returns:
      the tracing related annotation data under the given key.

    • removeTracingAnnotation

      Object removeTracingAnnotation(String key)
      Remove some trace specific message annotation that was previously applied to the given message either locally or by a remote peer.
      Parameters:
      key - The name of the tracing annotation data to remove.
      Returns:
      the tracing related annotation data under the given key.

    • setTracingAnnotation

      Object setTracingAnnotation(String key, Object value)
      Sets some trace specific message annotation that was previously applied to the given message either locally or by a remote peer.
      Parameters:
      key - The name of the tracing annotation data to store the trace data under.
      value - The value to store under the given key.
      Returns:
      the previous value stored under the given key if any present.

    • filterTracingAnnotations

      void filterTracingAnnotations(BiConsumer<String,Object> filter)
      Allows the tracing layer to filter out tracing related details from the full set of message annotations that a message might be carrying.
      Parameters:
      filter - The filter used to consume tracing related message annotations of interest.