org.apache.activemq.artemis.core.postoffice

Interface PostOffice

All Superinterfaces:

ActiveMQComponent

All Known Implementing Classes:

PostOfficeImpl

public interface PostOffice
extends ActiveMQComponent

A PostOffice instance maintains a mapping of a String address to a Queue. Multiple Queue instances can be bound with the same String address. Given a message and an address a PostOffice instance will route that message to all the Queue instances that are registered with that address. Addresses can be any String instance. A Queue instance can only be bound against a single address in the post office.

Method Summary

Modifier and Type	Method and Description
boolean	addAddressInfo(AddressInfo addressInfo)
void	addBinding(Binding binding)
Set<SimpleString>	getAddresses()
AddressInfo	getAddressInfo(SimpleString address)
Map<SimpleString,Binding>	getAllBindings()
Binding	getBinding(SimpleString uniqueName)
Bindings	getBindingsForAddress(SimpleString address) Differently to lookupBindings, this will always create a new element on the Queue if non-existent
Bindings	getDirectBindings(SimpleString address)
DuplicateIDCache	getDuplicateIDCache(SimpleString address)
Bindings	getMatchingBindings(SimpleString address)
SimpleString	getMatchingQueue(SimpleString address, RoutingType routingType)
SimpleString	getMatchingQueue(SimpleString address, SimpleString queueName, RoutingType routingType)
Object	getNotificationLock()
boolean	isAddressBound(SimpleString address)
List<Queue>	listQueuesForAddress(SimpleString address)
Bindings	lookupBindingsForAddress(SimpleString address) It will lookup the Binding without creating an item on the Queue if non-existent
void	processRoute(Message message, RoutingContext context, boolean direct)
Pair<RoutingContext,Message>	redistribute(Message message, Queue originatingQueue, Transaction tx)
default void	reloadAddressInfo(AddressInfo addressInfo)
AddressInfo	removeAddressInfo(SimpleString address)
AddressInfo	removeAddressInfo(SimpleString address, boolean force)
Binding	removeBinding(SimpleString uniqueName, Transaction tx, boolean deleteData)
MessageReference	reroute(Message message, Queue queue, Transaction tx)
RoutingStatus	route(Message message, boolean direct)
RoutingStatus	route(Message message, RoutingContext context, boolean direct)
RoutingStatus	route(Message message, RoutingContext context, boolean direct, boolean rejectDuplicates, Binding binding)
RoutingStatus	route(Message message, Transaction tx, boolean direct)
RoutingStatus	route(Message message, Transaction tx, boolean direct, boolean rejectDuplicates)
RoutingStatus	route(Message message, Transaction tx, boolean direct, boolean rejectDuplicates, Binding binding)
void	sendQueueInfoToQueue(SimpleString queueName, SimpleString address)
void	startExpiryScanner()
AddressInfo	updateAddressInfo(SimpleString addressName, EnumSet<RoutingType> routingTypes)
void	updateMessageLoadBalancingTypeForAddress(SimpleString address, MessageLoadBalancingType messageLoadBalancingType)
QueueBinding	updateQueue(SimpleString name, RoutingType routingType, Integer maxConsumers, Boolean purgeOnNoConsumers, Boolean exclusive)

Methods inherited from interface org.apache.activemq.artemis.core.server.ActiveMQComponent

isStarted, start, stop

Method Detail

addAddressInfo

boolean addAddressInfo(AddressInfo addressInfo)
                throws Exception

Parameters:

addressInfo -

Returns:

true if the address was added, false if it wasn't added

Throws:

Exception

reloadAddressInfo

default void reloadAddressInfo(AddressInfo addressInfo)
                        throws Exception

Throws:

Exception

removeAddressInfo

AddressInfo removeAddressInfo(SimpleString address)
                       throws Exception

Throws:

Exception

removeAddressInfo

AddressInfo removeAddressInfo(SimpleString address,
                              boolean force)
                       throws Exception

Throws:

Exception

getAddressInfo

AddressInfo getAddressInfo(SimpleString address)

updateAddressInfo

AddressInfo updateAddressInfo(SimpleString addressName,
                              EnumSet<RoutingType> routingTypes)
                       throws Exception

Throws:

Exception

updateQueue

QueueBinding updateQueue(SimpleString name,
                         RoutingType routingType,
                         Integer maxConsumers,
                         Boolean purgeOnNoConsumers,
                         Boolean exclusive)
                  throws Exception

Throws:

Exception

listQueuesForAddress

List<Queue> listQueuesForAddress(SimpleString address)
                          throws Exception

Throws:

Exception

addBinding

void addBinding(Binding binding)
         throws Exception

Throws:

Exception

removeBinding

Binding removeBinding(SimpleString uniqueName,
                      Transaction tx,
                      boolean deleteData)
               throws Exception

Throws:

Exception

lookupBindingsForAddress

Bindings lookupBindingsForAddress(SimpleString address)
                           throws Exception

It will lookup the Binding without creating an item on the Queue if non-existent

Parameters:

address -

Throws:

Exception

getBindingsForAddress

Bindings getBindingsForAddress(SimpleString address)
                        throws Exception

Differently to lookupBindings, this will always create a new element on the Queue if non-existent

Parameters:

address -

Throws:

Exception

getBinding

Binding getBinding(SimpleString uniqueName)

getMatchingBindings

Bindings getMatchingBindings(SimpleString address)
                      throws Exception

Throws:

Exception

getDirectBindings

Bindings getDirectBindings(SimpleString address)
                    throws Exception

Throws:

Exception

getAllBindings

Map<SimpleString,Binding> getAllBindings()

getMatchingQueue

SimpleString getMatchingQueue(SimpleString address,
                              RoutingType routingType)
                       throws Exception

Throws:

Exception

getMatchingQueue

SimpleString getMatchingQueue(SimpleString address,
                              SimpleString queueName,
                              RoutingType routingType)
                       throws Exception

Throws:

Exception

route

RoutingStatus route(Message message,
                    boolean direct)
             throws Exception

Throws:

Exception

route

RoutingStatus route(Message message,
                    Transaction tx,
                    boolean direct)
             throws Exception

Throws:

Exception

route

RoutingStatus route(Message message,
                    Transaction tx,
                    boolean direct,
                    boolean rejectDuplicates)
             throws Exception

Throws:

Exception

route

RoutingStatus route(Message message,
                    Transaction tx,
                    boolean direct,
                    boolean rejectDuplicates,
                    Binding binding)
             throws Exception

Throws:

Exception

route

RoutingStatus route(Message message,
                    RoutingContext context,
                    boolean direct)
             throws Exception

Throws:

Exception

route

RoutingStatus route(Message message,
                    RoutingContext context,
                    boolean direct,
                    boolean rejectDuplicates,
                    Binding binding)
             throws Exception

Throws:

Exception

reroute

MessageReference reroute(Message message,
                         Queue queue,
                         Transaction tx)
                  throws Exception

Throws:

Exception

redistribute

Pair<RoutingContext,Message> redistribute(Message message,
                                          Queue originatingQueue,
                                          Transaction tx)
                                   throws Exception

Throws:

Exception

processRoute

void processRoute(Message message,
                  RoutingContext context,
                  boolean direct)
           throws Exception

Throws:

Exception

getDuplicateIDCache

DuplicateIDCache getDuplicateIDCache(SimpleString address)

sendQueueInfoToQueue

void sendQueueInfoToQueue(SimpleString queueName,
                          SimpleString address)
                   throws Exception

Throws:

Exception

getNotificationLock

Object getNotificationLock()

startExpiryScanner

void startExpiryScanner()

isAddressBound

boolean isAddressBound(SimpleString address)
                throws Exception

Throws:

Exception

getAddresses

Set<SimpleString> getAddresses()

updateMessageLoadBalancingTypeForAddress

void updateMessageLoadBalancingTypeForAddress(SimpleString address,
                                              MessageLoadBalancingType messageLoadBalancingType)
                                       throws Exception

Throws:

Exception