io.smallrye.reactive.messaging.IncomingInterceptor Maven / Gradle / Ivy
package io.smallrye.reactive.messaging;
import jakarta.enterprise.inject.spi.Prioritized;
import org.eclipse.microprofile.reactive.messaging.Message;
import io.smallrye.common.annotation.Experimental;
/**
* Interceptor for incoming messages on connector channels.
*
* To register an outgoing interceptor, expose a managed bean, implementing this interface,
* and qualified with {@code @Identifier} with the targeted channel name.
*
* Only one interceptor is allowed to be bound for interception per incoming channel.
* When multiple interceptors are available, implementation should override the {@link #getPriority()} method.
*/
@Experimental("Smallrye-only feature")
public interface IncomingInterceptor extends Prioritized {
@Override
default int getPriority() {
return -1;
}
/**
* Called after message received
*
* @param message received message
* @return the message to dispatch for consumer methods, possibly mutated
*/
default Message afterMessageReceive(Message message) {
return message;
}
/**
* Called after message acknowledgment
*
* @param message acknowledged message
*/
void onMessageAck(Message message);
/**
* Called after message negative-acknowledgement
*
* @param message message to negative-acknowledge
* @param failure failure
*/
void onMessageNack(Message message, Throwable failure);
}