Class TimeStampingBrokerPlugin

  extended by
      extended by
          extended by
All Implemented Interfaces:
Broker, BrokerPlugin, Region, Service

public class TimeStampingBrokerPlugin
extends BrokerPluginSupport

A Broker interceptor which updates a JMS Client's timestamp on the message with a broker timestamp. Useful when the clocks on client machines are known to not be correct and you can only trust the time set on the broker machines. Enabling this plugin will break JMS compliance since the timestamp that the producer sees on the messages after as send() will be different from the timestamp the consumer will observe when he receives the message. This plugin is not enabled in the default ActiveMQ configuration. 2 new attributes have been added which will allow the administrator some override control over the expiration time for incoming messages: Attribute 'zeroExpirationOverride' can be used to apply an expiration time to incoming messages with no expiration defined (messages that would never expire) Attribute 'ttlCeiling' can be used to apply a limit to the expiration time

Field Summary
Fields inherited from class
Constructor Summary
Method Summary
 void send(ProducerBrokerExchange producerExchange, Message message)
          Send a message to the broker to using the specified destination.
 void setFutureOnly(boolean futureOnly)
 void setProcessNetworkMessages(Boolean processNetworkMessages)
 void setTtlCeiling(long ttlCeiling)
          setter method for ttlCeiling
 void setZeroExpirationOverride(long ttl)
          setter method for zeroExpirationOverride
Methods inherited from class
installPlugin, start, stop
Methods inherited from class
acknowledge, addBroker, addConnection, addConsumer, addDestination, addDestinationInfo, addProducer, addSession, beginTransaction, brokerServiceStarted, commitTransaction, fastProducer, forgetTransaction, gc, getAdaptor, getAdminConnectionContext, getBrokerId, getBrokerName, getBrokerSequenceId, getBrokerService, getClients, getDestinationMap, getDestinations, getDestinations, getDurableDestinations, getExecutor, getNext, getPeerBrokerInfos, getPreparedTransactions, getRoot, getScheduler, getTempDataStore, getVmConnectorURI, isExpired, isFaultTolerantConfiguration, isFull, isStopped, messageConsumed, messageDelivered, messageDiscarded, messageExpired, messagePull, networkBridgeStarted, networkBridgeStopped, nowMasterBroker, postProcessDispatch, prepareTransaction, preProcessDispatch, processConsumerControl, processDispatchNotification, removeBroker, removeConnection, removeConsumer, removeDestination, removeDestinationInfo, removeProducer, removeSession, removeSubscription, rollbackTransaction, sendToDeadLetterQueue, setAdminConnectionContext, setNext, slowConsumer
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail


public TimeStampingBrokerPlugin()
Method Detail


public void setZeroExpirationOverride(long ttl)
setter method for zeroExpirationOverride


public void setTtlCeiling(long ttlCeiling)
setter method for ttlCeiling


public void setFutureOnly(boolean futureOnly)


public void setProcessNetworkMessages(Boolean processNetworkMessages)


public void send(ProducerBrokerExchange producerExchange,
                 Message message)
          throws Exception
Description copied from interface: Region
Send a message to the broker to using the specified destination. The destination specified in the message does not need to match the destination the message is sent to. This is handy in case the message is being sent to a dead letter destination.

Specified by:
send in interface Region
send in class MutableBrokerFilter
producerExchange - the environment the operation is being executed under.
Exception - TODO

Copyright © 2005–2013 The Apache Software Foundation. All rights reserved.