com.github.susom.database

Class VertxUtil

java.lang.Object

com.github.susom.database.VertxUtil

public class VertxUtil
extends Object

This is a convenience class to work-around issues with using the SLF4J MDC class. It provides versions of async functionality that preserve the MDC across the event and worker threads.

Author:

garricko

Constructor Summary

Constructors

Constructor and Description
VertxUtil()

Method Summary

Modifier and Type	Method and Description
static <T> void	executeBlocking(io.vertx.core.Vertx vertx, io.vertx.core.Handler<io.vertx.core.Future<T>> future, boolean ordered, io.vertx.core.Handler<io.vertx.core.AsyncResult<T>> handler) Equivalent to Vertx.executeBlocking(Handler, boolean, Handler), but preserves the MDC correctly.
static <T> void	executeBlocking(io.vertx.core.Vertx vertx, io.vertx.core.Handler<io.vertx.core.Future<T>> future, io.vertx.core.Handler<io.vertx.core.AsyncResult<T>> handler) Equivalent to Vertx.executeBlocking(Handler, Handler), but preserves the MDC correctly.
static <T> void	executeBlocking(io.vertx.core.WorkerExecutor executor, io.vertx.core.Handler<io.vertx.core.Future<T>> future, boolean ordered, io.vertx.core.Handler<io.vertx.core.AsyncResult<T>> handler) Equivalent to Vertx.executeBlocking(Handler, boolean, Handler), but preserves the MDC correctly.
static <T> void	executeBlocking(io.vertx.core.WorkerExecutor executor, io.vertx.core.Handler<io.vertx.core.Future<T>> future, io.vertx.core.Handler<io.vertx.core.AsyncResult<T>> handler) Equivalent to Vertx.executeBlocking(Handler, Handler), but preserves the MDC correctly.
static <T> io.vertx.core.Handler<T>	mdc(io.vertx.core.Handler<T> handler) Wrap a Handler in a way that will preserve the SLF4J MDC context.
static <T> io.vertx.core.Handler<T>	mdcEventLoop(io.vertx.core.Handler<T> handler) Wrap a Handler in a way that will preserve the SLF4J MDC context.

Methods inherited from class java.lang.Object

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

Constructor Detail

VertxUtil

public VertxUtil()

Method Detail

mdc

public static <T> io.vertx.core.Handler<T> mdc(io.vertx.core.Handler<T> handler)

Wrap a Handler in a way that will preserve the SLF4J MDC context. The context from the current thread at the time of this method call will be cached and restored within the wrapper at the time the handler is invoked. This version delegates the handler call directly on the thread that calls it.

mdcEventLoop

public static <T> io.vertx.core.Handler<T> mdcEventLoop(io.vertx.core.Handler<T> handler)

Wrap a Handler in a way that will preserve the SLF4J MDC context. The context from the current thread at the time of this method call will be cached and restored within the wrapper at the time the handler is invoked. This version delegates the handler call using Context.runOnContext(Handler) from the current context that calls this method, ensuring the handler call will run on the correct event loop.

executeBlocking

public static <T> void executeBlocking(io.vertx.core.Vertx vertx,
                                       io.vertx.core.Handler<io.vertx.core.Future<T>> future,
                                       io.vertx.core.Handler<io.vertx.core.AsyncResult<T>> handler)

Equivalent to Vertx.executeBlocking(Handler, Handler), but preserves the MDC correctly.

executeBlocking

public static <T> void executeBlocking(io.vertx.core.Vertx vertx,
                                       io.vertx.core.Handler<io.vertx.core.Future<T>> future,
                                       boolean ordered,
                                       io.vertx.core.Handler<io.vertx.core.AsyncResult<T>> handler)

Equivalent to Vertx.executeBlocking(Handler, boolean, Handler), but preserves the MDC correctly.

executeBlocking

public static <T> void executeBlocking(io.vertx.core.WorkerExecutor executor,
                                       io.vertx.core.Handler<io.vertx.core.Future<T>> future,
                                       io.vertx.core.Handler<io.vertx.core.AsyncResult<T>> handler)

Equivalent to Vertx.executeBlocking(Handler, Handler), but preserves the MDC correctly.

executeBlocking

public static <T> void executeBlocking(io.vertx.core.WorkerExecutor executor,
                                       io.vertx.core.Handler<io.vertx.core.Future<T>> future,
                                       boolean ordered,
                                       io.vertx.core.Handler<io.vertx.core.AsyncResult<T>> handler)

Equivalent to Vertx.executeBlocking(Handler, boolean, Handler), but preserves the MDC correctly.