public class NullLoggingContextFacilityImpl extends Object implements LoggingContextFacility
| Modifier and Type | Field and Description |
|---|---|
static NullLoggingContextFacilityImpl |
INSTANCE |
CONFIG_PROPERTY_NAME| Modifier and Type | Method and Description |
|---|---|
void |
clearThreadContext()
Clears the current thread’s logging context.
|
Map<String,String> |
getImmutableActivityContext(ActivityHandle activityHandle)
Gets an immutable copy of the activity’s logging context.
|
Map<String,String> |
getImmutableThreadContext()
Gets an immutable copy of the current thread’s logging context.
|
void |
put(ActivityHandle activityHandle,
String key,
String value)
Add a key value pair to this activity’s logging context.
|
void |
put(String key,
String value)
Add a single key/value pair to the current thread’s logging context.
|
void |
putAll(ActivityHandle activityHandle,
Map<String,String> entries)
Put all context entries into the current logging context.
|
void |
putAll(Map<String,String> entries)
Add a map of key/value pairs to the current thread’s logging context.
|
void |
remove(ActivityHandle activityHandle,
String key)
Remove an entry from the logging context.
|
void |
remove(String key)
Remove a key from the current thread’s logging context.
|
public static NullLoggingContextFacilityImpl INSTANCE
public Map<String,String> getImmutableActivityContext(ActivityHandle activityHandle) throws UnrecognizedActivityHandleException
LoggingContextFacilityGets an immutable copy of the activity’s logging context.
Intended for use when calling up from the network, to fetch the existing state of an activity, once the activity is known.
getImmutableActivityContext in interface LoggingContextFacilityactivityHandle - Activity handle for the activity to get the Logging context for.UnrecognizedActivityHandleExceptionpublic Map<String,String> getImmutableThreadContext()
LoggingContextFacilityGets an immutable copy of the current thread’s logging context.
Intended for use by components with internal thread pools, to manage moving a logging context between an RA internal thread, and an activity plus rhino thread.
getImmutableThreadContext in interface LoggingContextFacilitypublic void clearThreadContext()
LoggingContextFacilityClears the current thread’s logging context.
Provided for use by components with internal thread pools, to remove the logging context from an RA internal thread when the thread has completed work associated with an activity.
clearThreadContext in interface LoggingContextFacilitypublic void put(String key, String value)
LoggingContextFacilityAdd a single key/value pair to the current thread’s logging context. This does not modify the logging context of any activities directly. Provided for use by RAs before an activity has been started/located, for example in a network IO thread.
put in interface LoggingContextFacilitykey - String context key to add to the thread’s logging contextvalue - String context value to add to the thread’s logging contextpublic void putAll(Map<String,String> entries)
LoggingContextFacilityAdd a map of key/value pairs to the current thread’s logging context. This does not modify the logging context of any activities directly. Provided for use by RAs before an activity has been started/located, for example in a network IO thread.
putAll in interface LoggingContextFacilityentries - Map of key, value pairs to add to the thread’s logging contextpublic void remove(String key)
LoggingContextFacilityRemove a key from the current thread’s logging context. This does not modify the logging context of any activities directly. Provided for use by RAs before an activity has been started/located, for example in a network IO thread.
remove in interface LoggingContextFacilitykey - String key to remove from the thread’s logging contextpublic void put(ActivityHandle activityHandle, String key, String value) throws UnrecognizedActivityHandleException
LoggingContextFacilityAdd a key value pair to this activity’s logging context. It will be logged in all subsequent log statements for this activity.
Care must be taken to not overload the context with too many entries.
put in interface LoggingContextFacilitykey - String key to add.value - String value to add.UnrecognizedActivityHandleException - if the handle is null, or does not point to a live activitypublic void putAll(ActivityHandle activityHandle, Map<String,String> entries) throws UnrecognizedActivityHandleException
LoggingContextFacilityPut all context entries into the current logging context. It will be logged in all subsequent log statements for this activity.
Care must be taken to not overload the context with too many entries.
putAll in interface LoggingContextFacilityentries - String key and value pairs to addUnrecognizedActivityHandleException - if the handle is null, or does not point to a live activitypublic void remove(ActivityHandle activityHandle, String key) throws UnrecognizedActivityHandleException
LoggingContextFacilityRemove an entry from the logging context. This entry will not be logged after this call.
remove in interface LoggingContextFacilitykey - String key to remove.UnrecognizedActivityHandleException - if the handle is null, or does not point to a live activity