ThreadContext (milky-thread 1.0.6

java.lang.Object
- cn.sliew.milky.thread.ThreadContext

public final class ThreadContext
extends Object

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface ThreadContext.StoredContext

Nested Classes
Modifier and Type	Class and Description
`static interface`	`ThreadContext.StoredContext`

Field Summary

Fields
Modifier and Type Field and Description

static ThreadContextStack EMPTY_STACK

Fields
Modifier and Type	Field and Description
`static ThreadContextStack`	`EMPTY_STACK`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`clearAll()` Clears the context map and stack.
`static void`	`clearMap()` Clears the context map.
`static void`	`clearStack()` Clears the stack for this thread.
`static ThreadContextStack`	`cloneStack()` Returns a copy of this thread's stack.
`static boolean`	`containsKey(String key)` Determines if the key is in the context.
`static String`	`get(String key)` Gets the context value identified by the `key` parameter.
`static Map<String,String>`	`getContext()` Returns a mutable copy of current thread's context Map.
`static int`	`getDepth()` Gets the current nesting depth of this thread's stack.
`static Map<String,String>`	`getImmutableContext()` Returns an immutable view of the current thread's context Map.
`static ThreadContextStack`	`getImmutableStack()` Gets an immutable copy of this current thread's context stack.
`static ThreadContextMap`	`getThreadContextMap()`
`static boolean`	`isEmpty()` Returns true if the Map is empty.
`Supplier<ThreadContext.StoredContext>`	`newRestorableContext()` Supplier<ThreadContext.StoredContext> restorable = context.newRestorableContext(); new Thread() { public void run() { try (ThreadContext.StoredContext ctx = restorable.get()) { // execute with the parents context and restore the threads context afterwards } } }.start();
`static String`	`peek()` Looks at the last diagnostic context at the top of this NDC without removing it.
`static String`	`pop()` Returns the value of the last item placed on the stack.
`ThreadContext.StoredContext`	`preserveContext()` // current context is stored and replaced with a default context try (StoredContext context = threadContext.preserveContext()) { // execute(); } // previous context is restored on StoredContext#close()
`static void`	`push(String message)` Pushes new diagnostic context information for the current thread.
`static void`	`put(String key, String value)` Puts a context value (the `value` parameter) as identified with the `key` parameter into the current thread's context map.
`static void`	`putAll(Map<String,String> m)` Puts all given context map entries into the current thread's context map.
`static void`	`putIfAbsent(String key, String value)` Puts a context value (the `value` parameter) as identified with the `key` parameter into the current thread's context map if the key does not exist.
`static void`	`remove(String key)` Removes the context value identified by the `key` parameter.
`static void`	`removeAll(Iterable<String> keys)` Removes the context values identified by the `keys` parameter.
`static void`	`removeStack()` Removes the diagnostic context for this thread.
`static void`	`setStack(Collection<String> stack)` Sets this thread's stack.
`ThreadContext.StoredContext`	`storeContext()`
`static void`	`trim(int depth)`
`Supplier<ThreadContext.StoredContext>`	`wrapRestorable(ThreadContext.StoredContext storedContext)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - EMPTY_STACK
```
public static final ThreadContextStack EMPTY_STACK
```
- Method Detail
  - preserveContext
```
public ThreadContext.StoredContext preserveContext()
```
```
     // current context is stored and replaced with a default context
     try (StoredContext context = threadContext.preserveContext()) {
          // execute();
     }
     // previous context is restored on StoredContext#close()
 
```
  - storeContext
```
public ThreadContext.StoredContext storeContext()
```
  - newRestorableContext
```
public Supplier<ThreadContext.StoredContext> newRestorableContext()
```
```
     Supplier<ThreadContext.StoredContext> restorable = context.newRestorableContext();
     new Thread() {
         public void run() {
             try (ThreadContext.StoredContext ctx = restorable.get()) {
                 // execute with the parents context and restore the threads context afterwards
             }
         }

     }.start();
 
```
  - wrapRestorable
```
public Supplier<ThreadContext.StoredContext> wrapRestorable(ThreadContext.StoredContext storedContext)
```
  - put
```
public static void put(String key,
                       String value)
```
    Puts a context value (the value parameter) as identified with the key parameter into the current thread's context map.
    If the current thread does not have a context map it is created as a side effect.
    
    Parameters:
    
    key - The key name.
    
    value - The key value.
  - putIfAbsent
```
public static void putIfAbsent(String key,
                               String value)
```
    Puts a context value (the value parameter) as identified with the key parameter into the current thread's context map if the key does not exist.
    If the current thread does not have a context map it is created as a side effect.
    
    Parameters:
    
    key - The key name.
    
    value - The key value.
  - putAll
```
public static void putAll(Map<String,String> m)
```
    Puts all given context map entries into the current thread's context map.
    If the current thread does not have a context map it is created as a side effect.
    
    Parameters:
    
    m - The map.
  - get
```
public static String get(String key)
```
    Gets the context value identified by the key parameter.
    This method has no side effects.
    
    Parameters:
    
    key - The key to locate.
    
    Returns:
    
    The value associated with the key or null.
  - remove
```
public static void remove(String key)
```
    Removes the context value identified by the key parameter.
    
    Parameters:
    
    key - The key to remove.
  - removeAll
```
public static void removeAll(Iterable<String> keys)
```
    Removes the context values identified by the keys parameter.
    
    Parameters:
    
    keys - The keys to remove.
  - clearMap
```
public static void clearMap()
```
    Clears the context map.
  - clearAll
```
public static void clearAll()
```
    Clears the context map and stack.
  - containsKey
```
public static boolean containsKey(String key)
```
    Determines if the key is in the context.
    
    Parameters:
    
    key - The key to locate.
    
    Returns:
    
    True if the key is in the context, false otherwise.
  - getContext
```
public static Map<String,String> getContext()
```
    Returns a mutable copy of current thread's context Map.
    
    Returns:
    
    a mutable copy of the context.
  - getImmutableContext
```
public static Map<String,String> getImmutableContext()
```
    Returns an immutable view of the current thread's context Map.
    
    Returns:
    
    An immutable view of the ThreadContext Map.
  - getThreadContextMap
```
public static ThreadContextMap getThreadContextMap()
```
  - isEmpty
```
public static boolean isEmpty()
```
    Returns true if the Map is empty.
    
    Returns:
    
    true if the Map is empty, false otherwise.
  - clearStack
```
public static void clearStack()
```
    Clears the stack for this thread.
  - cloneStack
```
public static ThreadContextStack cloneStack()
```
    Returns a copy of this thread's stack.
    
    Returns:
    
    A copy of this thread's stack.
  - getImmutableStack
```
public static ThreadContextStack getImmutableStack()
```
    Gets an immutable copy of this current thread's context stack.
    
    Returns:
    
    an immutable copy of the ThreadContext stack.
  - setStack
```
public static void setStack(Collection<String> stack)
```
    Sets this thread's stack.
    
    Parameters:
    
    stack - The stack to use.
  - getDepth
```
public static int getDepth()
```
    Gets the current nesting depth of this thread's stack.
    
    Returns:
    
    the number of items in the stack.
    
    See Also:
    
    trim(int)
  - pop
```
public static String pop()
```
    Returns the value of the last item placed on the stack.
    The returned value is the value that was pushed last. If no context is available, then the empty string "" is returned.
    
    Returns:
    
    String The innermost diagnostic context.
  - peek
```
public static String peek()
```
    Looks at the last diagnostic context at the top of this NDC without removing it.
    The returned value is the value that was pushed last. If no context is available, then the empty string "" is returned.
    
    Returns:
    
    String The innermost diagnostic context.
  - push
```
public static void push(String message)
```
    Pushes new diagnostic context information for the current thread.
    The contents of the message parameter is determined solely by the client.
    
    Parameters:
    
    message - The new diagnostic context information.
  - removeStack
```
public static void removeStack()
```
    Removes the diagnostic context for this thread.
    Each thread that created a diagnostic context by calling push(java.lang.String) should call this method before exiting. Otherwise, the memory used by the thread cannot be reclaimed by the VM.
    
    As this is such an important problem in heavy duty systems and because it is difficult to always guarantee that the remove method is called before exiting a thread, this method has been augmented to lazily remove references to dead threads. In practice, this means that you can be a little sloppy and occasionally forget to call remove(java.lang.String) before exiting a thread. However, you must call remove sometime. If you never call it, then your application is sure to run out of memory.
  - trim
```
public static void trim(int depth)
```

Class ThreadContext

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EMPTY_STACK

Method Detail

preserveContext

storeContext

newRestorableContext

wrapRestorable

put

putIfAbsent

putAll

get

remove

removeAll

clearMap

clearAll

containsKey

getContext

getImmutableContext

getThreadContextMap

isEmpty

clearStack

cloneStack

getImmutableStack

setStack

getDepth

pop

peek

push

removeStack

trim