org.jboss.messaging.core
Interface Receiver

All Known Subinterfaces:

Channel, ClusteredQueue, ClusterRouter, Queue, Router

All Known Implementing Classes:

ChannelSupport, DefaultRouter, FirstReceiverPointToPointRouter, LocalClusteredQueue, PagingFilteredQueue, RemoteQueueStub, RoundRobinPointToPointRouter, RoundRobinRouter, ServerConsumerEndpoint

public interface Receiver

A component that handles routable instances. Handling means consumption or synchronous/asynchronous forwarding to another receiver(s).

Version:

$Revision: 2202 $ $Id: Receiver.java 2202 2007-02-08 10:50:26Z 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

public 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