public interface InterceptorRegistry
EventInterceptor
s
and facilitates the introduction of EventInterceptors to EventDispatcher
s.
Registering an EventInterceptor will cause it to be introduced to all
currently registered and future EventDispatchers. EventInterceptors
can assume responsibility for determining whether or not to bind to each
EventDispatcher by implementing
EventDispatcherAwareInterceptor.introduceEventDispatcher(java.lang.String, com.tangosol.net.events.EventDispatcher)
.
The semantics of how to act upon discovering a duplicate interceptor, based
on identifier, can be prescribed via the RegistrationBehavior
enum.
Modifier and Type | Method and Description |
---|---|
EventInterceptor<?> |
getEventInterceptor(String sIdentifier)
Return a registered
EventInterceptor . |
String |
registerEventInterceptor(EventInterceptor<?> interceptor)
Register an
EventInterceptor uniquely identified based on the
presence of an annotation or default to the fully qualified class name. |
String |
registerEventInterceptor(EventInterceptor<?> interceptor,
RegistrationBehavior behavior)
Register an
EventInterceptor uniquely identified based on the
presence of an annotation or default to the fully qualified class name. |
String |
registerEventInterceptor(String sIdentifier,
EventInterceptor<?> interceptor,
RegistrationBehavior behavior)
Register a uniquely identified
EventInterceptor . |
void |
unregisterEventInterceptor(String sIdentifier)
Unregister an
EventInterceptor , and remove it from all EventDispatcher s. |
String registerEventInterceptor(EventInterceptor<?> interceptor)
EventInterceptor
uniquely identified based on the
presence of an annotation
or default to the fully qualified class name. The
EventInterceptor will be introduced to all current and future
EventDispatcher
s.interceptor
- the EventInterceptor to registerIllegalArgumentException
- if an EventInterceptor with the
same identifier is already registeredString registerEventInterceptor(EventInterceptor<?> interceptor, RegistrationBehavior behavior)
EventInterceptor
uniquely identified based on the
presence of an annotation
or default to the fully qualified class name. The RegistrationBehavior
specifies how to act upon registering a duplicate
interceptor. The EventInterceptor will be introduced to all current and
future EventDispatcher
s.interceptor
- the EventInterceptor to registerbehavior
- the behavior enacted upon discovering duplicate
interceptorsIllegalArgumentException
- if an EventInterceptor with the
same identifier is already registeredString registerEventInterceptor(String sIdentifier, EventInterceptor<?> interceptor, RegistrationBehavior behavior)
EventInterceptor
. The
EventInterceptor will be introduced to all current and future
EventDispatcher
s.sIdentifier
- the unique name identifying the EventInterceptorinterceptor
- the EventInterceptor to registerbehavior
- the behavior enacted upon discovering duplicate
interceptorsIllegalArgumentException
- if an EventInterceptor with the same
identifier is already registeredvoid unregisterEventInterceptor(String sIdentifier)
EventInterceptor
, and remove it from all EventDispatcher
s.sIdentifier
- the unique identifier of the interceptor to unregisterEventInterceptor<?> getEventInterceptor(String sIdentifier)
EventInterceptor
.