org.apache.logging.log4j

Class CloseableThreadContext

java.lang.Object

org.apache.logging.log4j.CloseableThreadContext

public class CloseableThreadContext
extends Object

Adds entries to the stack or map and them removes them when the object is closed, e.g. as part of a try-with-resources.

Since:

2.6

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CloseableThreadContext.Instance

Method Summary

Methods

Modifier and Type	Method and Description
static CloseableThreadContext.Instance	push(String message) Pushes new diagnostic context information on to the Thread Context Stack.
static CloseableThreadContext.Instance	push(String message, Object... args) Pushes new diagnostic context information on to the Thread Context Stack.
static CloseableThreadContext.Instance	put(String key, String value) Populates the Thread Context Map with the supplied key/value pairs.

Methods inherited from class java.lang.Object

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

Method Detail

push

public static CloseableThreadContext.Instance push(String message)

Pushes new diagnostic context information on to the Thread Context Stack. The information will be popped off when the instance is closed.

Parameters:

message - The new diagnostic context information.

Returns:

a new instance that will back out the changes when closed.

push

public static CloseableThreadContext.Instance push(String message,
                                   Object... args)

Pushes new diagnostic context information on to the Thread Context Stack. The information will be popped off when the instance is closed.

Parameters:

message - The new diagnostic context information.

args - Parameters for the message.

Returns:

a new instance that will back out the changes when closed.

put

public static CloseableThreadContext.Instance put(String key,
                                  String value)

Populates the Thread Context Map with the supplied key/value pairs. Any existing keys in the ThreadContext will be replaced with the supplied values, and restored back to their original values when the instance is closed.

Parameters:

key - The key to be added

value - The value to be added

Returns:

a new instance that will back out the changes when closed.