InRouteConfigurator

public interface InRouteConfigurator extends RouteConfigurator<InConnector>

Implementing classes provide ingoing communication routes for rsb.Participants. The methods handlerAdded(Handler,boolean) and handlerRemoved(Handler,boolean) need to be callable before and after calling activate().

Author

jwienke

Methods

filterAdded

void filterAdded(Filter filter)

Called in case a new filter was added and should be reflected by this route.

Parameters

filter – the added filter

filterRemoved

boolean filterRemoved(Filter filter)

Called in a case a filter should be removed from the route.

Parameters

filter – the filter to remove

Returns

true if the filter was already active and was removed now, else false

handlerAdded

void handlerAdded(Handler handler, boolean wait)

Called in case a Handler was added to the participant for which the route is being configured. This method should incorporate that handler into the route.

Parameters

• handler – the added handler

• wait – if true, this method must wait with returning until the handler is fully active and can receive the next event. Otherwise it might return earlier.

Throws

InterruptedException – interrupted while waiting for the handler to be fully removed

handlerRemoved

boolean handlerRemoved(Handler handler, boolean wait)

Called in case a Handler was remove from the participant for which the route is being configured. This method should remove that handler from the route.

Parameters

• handler – the removed handler

• wait – if true, this method must wait with returning until the handler is fully removed and will not receive any more events.. Otherwise it might return earlier.

Throws

InterruptedException – interrupted while waiting for the handler to be fully removed

Returns

true if the handler was already available and is now removed, else false

setEventReceivingStrategy

void setEventReceivingStrategy(EventReceivingStrategy strategy)

Defines the EventReceivingStrategy to use by the configurator. Must be called directly after construction before any other method was called.

Parameters

strategy – the new strategy