org.axonframework.queryhandling

Class LoggingQueryInvocationErrorHandler

java.lang.Object

org.axonframework.queryhandling.LoggingQueryInvocationErrorHandler

All Implemented Interfaces:

QueryInvocationErrorHandler

public class LoggingQueryInvocationErrorHandler
extends Object
implements QueryInvocationErrorHandler

Implementation of the QueryInvocationErrorHandler that logs all errors to a given Logger.

Since:

3.1

Author:

Allard Buijze

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LoggingQueryInvocationErrorHandler.Builder Builder class to instantiate a LoggingQueryInvocationErrorHandler.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LoggingQueryInvocationErrorHandler(LoggingQueryInvocationErrorHandler.Builder builder) Instantiate a LoggingQueryInvocationErrorHandler based on the fields contained in the LoggingQueryInvocationErrorHandler.Builder.

Method Summary

Modifier and Type	Method and Description
static LoggingQueryInvocationErrorHandler.Builder	builder() Instantiate a Builder to be able to create a LoggingQueryInvocationErrorHandler.
void	onError(Throwable error, QueryMessage<?,?> queryMessage, MessageHandler messageHandler) Invoked when an error occurred while invoking a message handler in a scatter-gather query.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LoggingQueryInvocationErrorHandler

protected LoggingQueryInvocationErrorHandler(LoggingQueryInvocationErrorHandler.Builder builder)

Instantiate a LoggingQueryInvocationErrorHandler based on the fields contained in the LoggingQueryInvocationErrorHandler.Builder.

Parameters:

builder - the LoggingQueryInvocationErrorHandler.Builder used to instantiate a LoggingQueryInvocationErrorHandler instance

Method Detail

builder

public static LoggingQueryInvocationErrorHandler.Builder builder()

Instantiate a Builder to be able to create a LoggingQueryInvocationErrorHandler.

The Logger is defaulted to a LoggerFactory.getLogger(Class) call using LoggingQueryInvocationErrorHandler.class.

Returns:

a Builder to be able to create a LoggingQueryInvocationErrorHandler

onError

public void onError(Throwable error,
                    QueryMessage<?,?> queryMessage,
                    MessageHandler messageHandler)

Description copied from interface: QueryInvocationErrorHandler

Invoked when an error occurred while invoking a message handler in a scatter-gather query. Implementations may throw an exception to propagate the error to the caller. In that case, the QueryBus implementation will receive the exception, and may choose to propagate the error to the sender of the query.

Note that this handler is not used for point-to-point queries. In that case, exceptions are reported directly to the invoker. Query Bus implementation may choose to implement point-to-point queries as scatter-gather, and only reporting the first answer returned. In that case, this method is invoked, and any propagated exceptions may or may not be reported to the sender of the query.

Specified by:

onError in interface QueryInvocationErrorHandler

Parameters:

error - The error that occurred

queryMessage - The message causing the exception in the handler

messageHandler - The handler that reported the exception