Package ru.yoomoney.tech.dbqueue.config.impl

Class CompositeTaskLifecycleListener

java.lang.Object

ru.yoomoney.tech.dbqueue.config.impl.CompositeTaskLifecycleListener

All Implemented Interfaces:

TaskLifecycleListener

public class CompositeTaskLifecycleListener
extends java.lang.Object
implements TaskLifecycleListener

Composite listener. It allows combining several listeners into one. Listeners for picked and started events are executed in straight order. Listeners for executed, finished and crashed events are executed in reverse order.

Since:

11.06.2021

Constructor Summary

Constructors

Constructor	Description
CompositeTaskLifecycleListener(java.util.List<TaskLifecycleListener> listeners)	Constructor

Method Summary

Modifier and Type	Method	Description
void	crashed(QueueShardId shardId, QueueLocation location, TaskRecord taskRecord, java.lang.Exception exc)	Event for abnormal queue processing.
void	executed(QueueShardId shardId, QueueLocation location, TaskRecord taskRecord, TaskExecutionResult executionResult, long processTaskTime)	Event for completion of client logic when task processing.
void	finished(QueueShardId shardId, QueueLocation location, TaskRecord taskRecord)	Event for completion the task execution in the queue.
void	picked(QueueShardId shardId, QueueLocation location, TaskRecord taskRecord, long pickTaskTime)	Event of task picking from the queue.
void	started(QueueShardId shardId, QueueLocation location, TaskRecord taskRecord)	The start event of task processing.

Methods inherited from class java.lang.Object

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

Constructor Detail

CompositeTaskLifecycleListener

public CompositeTaskLifecycleListener(@Nonnull
                                      java.util.List<TaskLifecycleListener> listeners)

Constructor

Parameters:

listeners - task listeners

Method Detail

picked

public void picked(@Nonnull
                   QueueShardId shardId,
                   @Nonnull
                   QueueLocation location,
                   @Nonnull
                   TaskRecord taskRecord,
                   long pickTaskTime)

Description copied from interface: TaskLifecycleListener

Event of task picking from the queue.

Triggered when there is a task in the queue, which is ready for processing.

Might be useful for monitoring problems with database performance.

Specified by:

picked in interface TaskLifecycleListener

Parameters:

shardId - Shard identifier, which processes the queue.

location - Queue location.

taskRecord - Raw task data.

pickTaskTime - Time spent on picking the task from the queue in millis.

started

public void started(@Nonnull
                    QueueShardId shardId,
                    @Nonnull
                    QueueLocation location,
                    @Nonnull
                    TaskRecord taskRecord)

Description copied from interface: TaskLifecycleListener

The start event of task processing.

Always triggered when task was picked.

Might be useful for updating a logging context.

Specified by:

started in interface TaskLifecycleListener

Parameters:

shardId - Shard identifier, which processes the queue.

location - Queue location.

taskRecord - Raw task data.

executed

public void executed(@Nonnull
                     QueueShardId shardId,
                     @Nonnull
                     QueueLocation location,
                     @Nonnull
                     TaskRecord taskRecord,
                     @Nonnull
                     TaskExecutionResult executionResult,
                     long processTaskTime)

Description copied from interface: TaskLifecycleListener

Event for completion of client logic when task processing.

Always triggered when task processing has completed successfully.

Might be useful for monitoring successful execution of client logic.

Specified by:

executed in interface TaskLifecycleListener

Parameters:

shardId - Shard identifier, which processes the queue.

location - Queue location.

taskRecord - Raw task data.

executionResult - Result of task processing.

processTaskTime - Time spent on task processing in millis, without the time for task picking from the queue.

finished

public void finished(@Nonnull
                     QueueShardId shardId,
                     @Nonnull
                     QueueLocation location,
                     @Nonnull
                     TaskRecord taskRecord)

Description copied from interface: TaskLifecycleListener

Event for completion the task execution in the queue.

Always triggered when task was picked up for processing. Called even after TaskLifecycleListener.crashed(ru.yoomoney.tech.dbqueue.config.QueueShardId, ru.yoomoney.tech.dbqueue.settings.QueueLocation, ru.yoomoney.tech.dbqueue.api.TaskRecord, java.lang.Exception).

Might be useful for recovery of initial logging context state.

Specified by:

finished in interface TaskLifecycleListener

Parameters:

shardId - Shard identifier, which processes the queue.

location - Queue location.

taskRecord - Raw task data.

crashed

public void crashed(@Nonnull
                    QueueShardId shardId,
                    @Nonnull
                    QueueLocation location,
                    @Nonnull
                    TaskRecord taskRecord,
                    @Nullable
                    java.lang.Exception exc)

Description copied from interface: TaskLifecycleListener

Event for abnormal queue processing.

Triggered when unexpected error occurs during task processing.

Might be useful for tracking and monitoring errors in the system.

Specified by:

crashed in interface TaskLifecycleListener

Parameters:

shardId - Shard identifier, which processes the queue.

location - Queue location.

taskRecord - Raw task data.

exc - An error caused the crash.