org.jboss.messaging.core.contract
Interface Receiver

All Known Subinterfaces:

Channel, Distributor, Queue

All Known Implementing Classes:

ChannelSupport, ClusterRoundRobinDistributor, FirstReceiverDistributor, MessagingQueue, MessagingQueue.DistributorWrapper, PagingChannelSupport, RoundRobinDistributor, ServerConsumerEndpoint

public interface Receiver

A component that handles MessageReferences. Handling means consumption or forwarding to another receiver(s). Handling can be done transactionally or non transactionally

Version:

$Revision: 2868 $ $Id: Receiver.java 2868 2007-07-10 20:22:16Z timfox $

Author:

Ovidiu Feodorov, Tim Fox

Method Summary

Delivery

handle(DeliveryObserver observer, MessageReference reference, Transaction tx) A receiver can return an active, "done" or null delivery.

Method Detail

handle

Delivery handle(DeliveryObserver observer,
                MessageReference reference,
                Transaction tx)

A receiver can return an active, "done" or null delivery. The method returns null in case the receiver doesn't accept the message. The return value is unspecified when the message is submitted in the context of a transaction (tx not null).

Parameters:

observer - - the component the delivery should be acknowledged to.

See Also:

Delivery, DeliveryObserver