Class ClientMdc

java.lang.Object

com.loomcache.client.diagnostics.ClientMdc

public final class ClientMdc
extends Object

BLK-2026-04-22-010: small helper that sets/clears the SLF4J MDC fields the client logs use for cross-process trace reconstruction.

Keys mirror the server-side MDC (see CacheNode.handleMessage):

• clientId — the client's own identity
• requestId — the per-request correlation id (sent on the wire, set on the server when the response is processed)
• peer — the host:port of the connection servicing the request

Use the try-with-resources idiom:

try (var ignored = ClientMdc.scope(clientId, correlationId, "node-2:5701")) {
    ... do request work ...
}

The ClientMdc.MdcScope closes restore-or-clear semantics: any MDC fields that existed before the scope are restored on close; new fields set inside the scope are cleared.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	ClientMdc.MdcScope	AutoCloseable MDC scope; safe to nest.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	KEY_CLIENT_ID
static final String	KEY_PEER
static final String	KEY_REQUEST_ID

Method Summary

Modifier and Type	Method	Description
static ClientMdc.MdcScope	scope(String clientId, String requestId, String peer)	Open an MDC scope.

Methods inherited from class Object

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

Field Details

KEY_CLIENT_ID

public static final String KEY_CLIENT_ID

See Also:

• Constant Field Values

KEY_REQUEST_ID

public static final String KEY_REQUEST_ID

See Also:

• Constant Field Values

KEY_PEER

public static final String KEY_PEER

See Also:

• Constant Field Values

Method Details

scope

public static ClientMdc.MdcScope scope(String clientId,
 String requestId,
 String peer)

Open an MDC scope. Each non-null argument becomes an MDC key for the duration of the returned ClientMdc.MdcScope. Pre-existing values for those keys are saved and restored on ClientMdc.MdcScope.close().