T - the entity typepublic abstract class WrappedMessageHandlingMember<T> extends Object implements MessageHandlingMember<T>
MessageHandlingMember that delegates to a wrapped MessageHandlingMember. Extend
this class to provide additional functionality to the delegate member.| Modifier | Constructor and Description |
|---|---|
protected |
WrappedMessageHandlingMember(MessageHandlingMember<T> delegate)
Initializes the member using the given
delegate. |
| Modifier and Type | Method and Description |
|---|---|
Optional<Map<String,Object>> |
annotationAttributes(Class<? extends Annotation> annotationType)
Get the attributes of an annotation of given
annotationType on the method of the target entity. |
<R> Optional<R> |
attribute(String attributeKey)
Retrieve a single attributes for the given
attributeKey. |
boolean |
canHandle(Message<?> message)
Checks if this handler is capable of handling the given
message. |
boolean |
canHandleMessageType(Class<? extends Message> messageType)
Checks if this handlers is capable of handling
Message implementations of the given messageType. |
boolean |
canHandleType(Class<?> payloadType)
Checks if this handler is capable of handling messages with the given
payloadType. |
Object |
handle(Message<?> message,
T target)
Handles the given
message by invoking the appropriate method on given target. |
boolean |
hasAnnotation(Class<? extends Annotation> annotationType)
Checks whether the method of the target entity contains the given
annotationType. |
Class<?> |
payloadType()
Returns the payload type of messages that can be processed by this handler.
|
int |
priority()
Returns a number representing the priority of this handler over other handlers capable of processing the same
message.
|
<HT> Optional<HT> |
unwrap(Class<HT> handlerType)
Returns the wrapped handler object if its type is an instance of the given
handlerType. |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitdeclaringClass, signatureprotected WrappedMessageHandlingMember(MessageHandlingMember<T> delegate)
delegate.delegate - the actual message handling member to delegate topublic Class<?> payloadType()
MessageHandlingMemberpayloadType in interface MessageHandlingMember<T>public int priority()
MessageHandlingMemberIn general, a handler with a higher priority will receive the message before (or instead of) handlers with a lower priority. However, the priority value may not be the only indicator that is used to determine the order of invocation. For instance, a message processor may decide to ignore the priority value if one message handler is a more specific handler of the message than another handler.
priority in interface MessageHandlingMember<T>public boolean canHandle(@Nonnull Message<?> message)
MessageHandlingMembermessage.canHandle in interface MessageHandlingMember<T>message - The message that is to be handledtrue if the handler is capable of handling the message, false otherwisepublic Object handle(@Nonnull Message<?> message, T target) throws Exception
MessageHandlingMembermessage by invoking the appropriate method on given target. This may result in
an exception if the given target is not capable of handling the message or if an exception is thrown during
invocation of the method.handle in interface MessageHandlingMember<T>message - The message to handletarget - The target to handle the messageException - when there was a problem that prevented invocation of the method or if an exception was thrown
from the invoked methodpublic boolean canHandleType(@Nonnull Class<?> payloadType)
MessageHandlingMemberpayloadType.canHandleType in interface MessageHandlingMember<T>payloadType - The payloadType of a message that is to be handledtrue if the handler is capable of handling the message with given type, false otherwisepublic boolean canHandleMessageType(@Nonnull Class<? extends Message> messageType)
MessageHandlingMemberMessage implementations of the given messageType.
It is recommended to suppress the raw type use validation of the messageType parameter when implementing
this method, as usage of this method with a Message generic would required reflection or casting
otherwise.
canHandleMessageType in interface MessageHandlingMember<T>messageType - the Message's type to check if it can be handled by this handlertrue if this handler can handle the given messageType, false otherwisepublic <HT> Optional<HT> unwrap(Class<HT> handlerType)
MessageHandlingMemberhandlerType. For instance, if
this method is invoked with Executable and the message is handled by a method of the
target entity, then this method will return the method handle as a Method.unwrap in interface MessageHandlingMember<T>HT - The wrapped handler typehandlerType - The expected type of the wrapped handlerpublic Optional<Map<String,Object>> annotationAttributes(Class<? extends Annotation> annotationType)
MessageHandlingMemberannotationType on the method of the target entity. If the
annotation is present on the target method an Optional is returned containing the properties mapped by their
name. If the annotation is not present an empty Optional is returned.annotationAttributes in interface MessageHandlingMember<T>annotationType - The annotation to check for on the target methodpublic boolean hasAnnotation(Class<? extends Annotation> annotationType)
MessageHandlingMemberannotationType.hasAnnotation in interface MessageHandlingMember<T>annotationType - Annotation to check for on the target methodtrue if the annotation is present on the target method, false otherwisepublic <R> Optional<R> attribute(String attributeKey)
MessageHandlingMemberattributeKey. If this MessageHandlingMember does not
hold a value referencing the attributeKey, an Optional.empty() is returned. Otherwise a non-empty
Optional containing the attribute will be provided.
When using the method, consider checking the HandlerAttributes for a list of
common handler attributes.
attribute in interface MessageHandlingMember<T>attributeKey - the key to retrieve an attribute forOptional of the attribute referencing the given attributeKey. Otherwise an
Optional.empty() will be returnedCopyright © 2010–2023. All rights reserved.