DefaultThreadContextStack (Apache Log4j API 2.12.0 API)

java.lang.Object
- org.apache.logging.log4j.spi.DefaultThreadContextStack

All Implemented Interfaces:

Serializable, Iterable<String>, Collection<String>, ThreadContextStack, ThreadContext.ContextStack, StringBuilderFormattable
```
public class DefaultThreadContextStack
extends Object
implements ThreadContextStack, StringBuilderFormattable
```
A copy-on-write thread-safe variant of org.apache.logging.log4j.spi.ThreadContextStack in which all mutative operations (add, pop, and so on) are implemented by making a fresh copy of the underlying list.

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description

DefaultThreadContextStack(boolean useStack)

Constructors
Constructor and Description
`DefaultThreadContextStack(boolean useStack)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`add(String s)`
`boolean`	`addAll(Collection<? extends String> strings)`
`List<String>`	`asList()` Returns all the elements in the stack in a List.
`void`	`clear()`
`boolean`	`contains(Object o)`
`boolean`	`containsAll(Collection<?> objects)`
`ThreadContextStack`	`copy()` Returns a copy of the ContextStack.
`boolean`	`equals(Object obj)`
`void`	`formatTo(StringBuilder buffer)` Writes a text representation of this object into the specified `StringBuilder`, ideally without allocating temporary objects.
`int`	`getDepth()` Returns the number of elements in the stack.
`ThreadContext.ContextStack`	`getImmutableStackOrNull()` Returns a ContextStack with the same contents as this ContextStack or `null`.
`int`	`hashCode()`
`boolean`	`isEmpty()`
`Iterator<String>`	`iterator()`
`String`	`peek()` Returns the element at the top of the stack without removing it or null if the stack is empty.
`String`	`pop()` Returns the element at the top of the stack.
`void`	`push(String message)` Pushes an element onto the stack.
`boolean`	`remove(Object o)`
`boolean`	`removeAll(Collection<?> objects)`
`boolean`	`retainAll(Collection<?> objects)`
`int`	`size()`
`Object[]`	`toArray()`
`<T> T[]`	`toArray(T[] ts)`
`String`	`toString()`
`void`	`trim(int depth)` Trims elements from the end of the stack.

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

Methods inherited from interface java.util.Collection
parallelStream, removeIf, spliterator, stream

Methods inherited from interface java.lang.Iterable
forEach

- Constructor Detail
  - DefaultThreadContextStack
```
public DefaultThreadContextStack(boolean useStack)
```
- Method Detail
  - add
```
public boolean add(String s)
```
    Specified by:
    
    add in interface Collection<String>
  - addAll
```
public boolean addAll(Collection<? extends String> strings)
```
    Specified by:
    
    addAll in interface Collection<String>
  - asList
```
public List<String> asList()
```
    Description copied from interface: ThreadContext.ContextStack
    
    Returns all the elements in the stack in a List.
    
    Specified by:
    
    asList in interface ThreadContext.ContextStack
    
    Returns:
    
    all the elements in the stack in a List.
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface Collection<String>
  - contains
```
public boolean contains(Object o)
```
    Specified by:
    
    contains in interface Collection<String>
  - containsAll
```
public boolean containsAll(Collection<?> objects)
```
    Specified by:
    
    containsAll in interface Collection<String>
  - copy
```
public ThreadContextStack copy()
```
    Description copied from interface: ThreadContext.ContextStack
    
    Returns a copy of the ContextStack.
    
    Specified by:
    
    copy in interface ThreadContext.ContextStack
    
    Returns:
    
    a copy of the ContextStack.
  - equals
```
public boolean equals(Object obj)
```
    Specified by:
    
    equals in interface Collection<String>
    
    Overrides:
    
    equals in class Object
  - getDepth
```
public int getDepth()
```
    Description copied from interface: ThreadContext.ContextStack
    
    Returns the number of elements in the stack.
    
    Specified by:
    
    getDepth in interface ThreadContext.ContextStack
    
    Returns:
    
    the number of elements in the stack.
  - hashCode
```
public int hashCode()
```
    Specified by:
    
    hashCode in interface Collection<String>
    
    Overrides:
    
    hashCode in class Object
  - isEmpty
```
public boolean isEmpty()
```
    Specified by:
    
    isEmpty in interface Collection<String>
  - iterator
```
public Iterator<String> iterator()
```
    Specified by:
    
    iterator in interface Iterable<String>
    
    Specified by:
    
    iterator in interface Collection<String>
  - peek
```
public String peek()
```
    Description copied from interface: ThreadContext.ContextStack
    
    Returns the element at the top of the stack without removing it or null if the stack is empty.
    
    Specified by:
    
    peek in interface ThreadContext.ContextStack
    
    Returns:
    
    the element at the top of the stack or null if the stack is empty.
  - pop
```
public String pop()
```
    Description copied from interface: ThreadContext.ContextStack
    
    Returns the element at the top of the stack.
    
    Specified by:
    
    pop in interface ThreadContext.ContextStack
    
    Returns:
    
    The element at the top of the stack.
  - push
```
public void push(String message)
```
    Description copied from interface: ThreadContext.ContextStack
    
    Pushes an element onto the stack.
    
    Specified by:
    
    push in interface ThreadContext.ContextStack
    
    Parameters:
    
    message - The element to add.
  - remove
```
public boolean remove(Object o)
```
    Specified by:
    
    remove in interface Collection<String>
  - removeAll
```
public boolean removeAll(Collection<?> objects)
```
    Specified by:
    
    removeAll in interface Collection<String>
  - retainAll
```
public boolean retainAll(Collection<?> objects)
```
    Specified by:
    
    retainAll in interface Collection<String>
  - size
```
public int size()
```
    Specified by:
    
    size in interface Collection<String>
  - toArray
```
public Object[] toArray()
```
    Specified by:
    
    toArray in interface Collection<String>
  - toArray
```
public <T> T[] toArray(T[] ts)
```
    Specified by:
    
    toArray in interface Collection<String>
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - formatTo
```
public void formatTo(StringBuilder buffer)
```
    Description copied from interface: StringBuilderFormattable
    
    Writes a text representation of this object into the specified StringBuilder, ideally without allocating temporary objects.
    
    Specified by:
    
    formatTo in interface StringBuilderFormattable
    
    Parameters:
    
    buffer - the StringBuilder to write into
  - trim
```
public void trim(int depth)
```
    Description copied from interface: ThreadContext.ContextStack
    
    Trims elements from the end of the stack.
    
    Specified by:
    
    trim in interface ThreadContext.ContextStack
    
    Parameters:
    
    depth - The maximum number of items in the stack to keep.
  - getImmutableStackOrNull
```
public ThreadContext.ContextStack getImmutableStackOrNull()
```
    Description copied from interface: ThreadContext.ContextStack
    
    Returns a ContextStack with the same contents as this ContextStack or null. Attempts to modify the returned stack may or may not throw an exception, but will not affect the contents of this ContextStack.
    
    Specified by:
    
    getImmutableStackOrNull in interface ThreadContext.ContextStack
    
    Returns:
    
    a ContextStack with the same contents as this ContextStack or null.

Copyright © 1999-2019 The Apache Software Foundation. All Rights Reserved.
Apache Logging, Apache Log4j, Log4j, Apache, the Apache feather logo, the Apache Logging project logo, and the Apache Log4j logo are trademarks of The Apache Software Foundation.

Class DefaultThreadContextStack

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Collection

Methods inherited from interface java.lang.Iterable

Constructor Detail

DefaultThreadContextStack

Method Detail

add

addAll

asList

clear

contains

containsAll

copy

equals

getDepth

hashCode

isEmpty

iterator

peek

pop

push

remove

removeAll

retainAll

size

toArray

toArray

toString

formatTo

trim

getImmutableStackOrNull