public interface ThreadState
ThreadState
instance manages any state that might need to be bound and/or restored during a thread's
execution.
bind()
will place state on the currently executing thread to be accessed later during
the thread's execution.
restored
to guarantee all threads stay clean in any thread-pooled environment. This should always
be done in a try/finally
block:
ThreadState state = //acquire or instantiate as necessary try { state.bind(); doSomething(); //execute any logic downstream logic that might need to access the state } finally { state.restore(); }
Modifier and Type | Method and Description |
---|---|
void |
bind()
Binds any state that should be made accessible during a thread's execution.
|
void |
clear()
Completely clears/removes the
ThreadContext state. |
void |
restore()
Restores a thread to its state before bind
bind was invoked. |
void bind()
try/finally
block paired with the restore()
call to guarantee that the thread
is cleanly restored back to its original state. For example:
ThreadState state = //acquire or instantiate as necessary try { state.bind(); doSomething(); //execute any logic downstream logic that might need to access the state } finally { state.restore(); }
void restore()
bind
was invoked. This should typically always be
called in a finally
block to guarantee that the thread is cleanly restored back to its original state
before bind
's bind was called. For example:
ThreadState state = //acquire or instantiate as necessary try { state.bind(); doSomething(); //execute any logic downstream logic that might need to access the state } finally { state.restore(); }
Copyright © 2004–2019 The Apache Software Foundation. All rights reserved.