Package org.jboss.logging
Interface LoggerProvider
-
public interface LoggerProvider
A contract for the log provider implementation.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
clearMdc()
Removes all entries from the message diagnostics context.void
clearNdc()
Clears the nested diagnostics context.Logger
getLogger(String name)
Returns a logger which is backed by a logger from the log provider.Object
getMdc(String key)
Returns the value for the key on the message diagnostics context ornull
if no value was found.Map<String,Object>
getMdcMap()
Returns the map from the context.String
getNdc()
Retrieves the current values set for the nested diagnostics context.int
getNdcDepth()
The current depth of the nested diagnostics context.String
peekNdc()
Peeks at the top value from the stack and returns it.String
popNdc()
Pops top value from the stack and returns it.void
pushNdc(String message)
Pushes a value to the nested diagnostics context stack.Object
putMdc(String key, Object value)
Puts the value onto the message diagnostics context.void
removeMdc(String key)
Removes the value from the message diagnostics context.void
setNdcMaxDepth(int maxDepth)
Sets maximum depth of the stack removing any entries below the maximum depth.
-
-
-
Method Detail
-
getLogger
Logger getLogger(String name)
Returns a logger which is backed by a logger from the log provider.Note: this should never be
null
- Parameters:
name
- the name of the logger- Returns:
- a logger for the log provider logger.
-
clearMdc
void clearMdc()
Removes all entries from the message diagnostics context.
-
putMdc
Object putMdc(String key, Object value)
Puts the value onto the message diagnostics context.- Parameters:
key
- the key for the valuevalue
- the value- Returns:
- the previous value set or
null
if no value was set
-
getMdc
Object getMdc(String key)
Returns the value for the key on the message diagnostics context ornull
if no value was found.- Parameters:
key
- the key to lookup the value for- Returns:
- the value or
null
if not found
-
removeMdc
void removeMdc(String key)
Removes the value from the message diagnostics context.- Parameters:
key
- the key of the value to remove
-
getMdcMap
Map<String,Object> getMdcMap()
Returns the map from the context.Note that in most implementations this is an expensive operation and should be used sparingly.
- Returns:
- the map from the context or an empty map if the context is
null
-
clearNdc
void clearNdc()
Clears the nested diagnostics context.
-
getNdc
String getNdc()
Retrieves the current values set for the nested diagnostics context.- Returns:
- the current value set or
null
if no value was set
-
getNdcDepth
int getNdcDepth()
The current depth of the nested diagnostics context.- Returns:
- the current depth of the stack
-
popNdc
String popNdc()
Pops top value from the stack and returns it.- Returns:
- the top value from the stack or an empty string if no value was set
-
peekNdc
String peekNdc()
Peeks at the top value from the stack and returns it.- Returns:
- the value or an empty string
-
pushNdc
void pushNdc(String message)
Pushes a value to the nested diagnostics context stack.- Parameters:
message
- the message to push
-
setNdcMaxDepth
void setNdcMaxDepth(int maxDepth)
Sets maximum depth of the stack removing any entries below the maximum depth.- Parameters:
maxDepth
- the maximum depth to set
-
-