org.jboss.messaging.core.impl
Class FirstReceiverDistributor

java.lang.Object
  org.jboss.messaging.core.impl.FirstReceiverDistributor

All Implemented Interfaces:

Distributor, Receiver

public class FirstReceiverDistributor
extends java.lang.Object
implements Distributor

It will always favour the first receiver in the internal list of receivers, but will retry the next one (and the next one...) if a previous one does not want to accept the message. If the router has several receivers (e.g. the case of multiple consumers on a queue) then if the consumers are fast then the first receiver will tend to get most or all of the references

Version:

$Revision: 1174 $ $Id: PointToPointRouter.java 1174 2006-08-02 14:14:32Z timfox $

Author:

Ovidiu Feodorov, Tim Fox

Constructor Summary

FirstReceiverDistributor()

Method Summary

boolean	add(Receiver r) Add a local receiver to this distributor.
void	clear() Remove all receivers.
boolean	contains(Receiver r) Does the distributor already contain the specified Receiver?
int	getNumberOfReceivers()
Delivery	handle(DeliveryObserver observer, MessageReference ref, Transaction tx) A receiver can return an active, "done" or null delivery.
java.util.Iterator	iterator()
boolean	remove(Receiver r) Remove a local receiver from this distributor.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FirstReceiverDistributor

public FirstReceiverDistributor()

Method Detail

handle

public Delivery handle(DeliveryObserver observer,
                       MessageReference ref,
                       Transaction tx)

Description copied from interface: Receiver

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).

Specified by:

handle in interface Receiver

Parameters:

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

See Also:

Delivery, DeliveryObserver

add

public boolean add(Receiver r)

Description copied from interface: Distributor

Add a local receiver to this distributor.

Specified by:

add in interface Distributor

Returns:

true if the distributor did not already contain the specified receiver and the receiver was added to the distributor, false otherwise.

remove

public boolean remove(Receiver r)

Description copied from interface: Distributor

Remove a local receiver from this distributor.

Specified by:

remove in interface Distributor

Returns:

true if this distributor contained the specified receiver.

clear

public void clear()

Description copied from interface: Distributor

Remove all receivers.

Specified by:

clear in interface Distributor

contains

public boolean contains(Receiver r)

Description copied from interface: Distributor

Does the distributor already contain the specified Receiver?

Specified by:

contains in interface Distributor

Returns:

iterator

public java.util.Iterator iterator()

Specified by:

iterator in interface Distributor

Returns:

an iterator of receivers

getNumberOfReceivers

public int getNumberOfReceivers()

Specified by:

getNumberOfReceivers in interface Distributor

Returns:

The number of receivers in the distributor