org.apache.sshd.common.util.logging

Class LoggingUtils

java.lang.Object

org.apache.sshd.common.util.logging.LoggingUtils

public final class LoggingUtils
extends Object

Author:

Apache MINA SSHD Project

Method Summary

Modifier and Type	Method and Description
static Map<Integer,String>	generateMnemonicMap(Class<?> clazz, Predicate<? super Field> acceptor) Scans using reflection API for all numeric public static final fields that are also accepted by the predicate.
static Map<Integer,String>	generateMnemonicMap(Class<?> clazz, String commonPrefix) Scans using reflection API for all fields that are public static final that start with the given common prefix (case sensitive) and are of type Number.
static Map<String,Integer>	getAmbiguousMenmonics(Class<?> clazz, Predicate<? super Field> acceptor) Scans using reflection API for all numeric public static final fields that are also accepted by the predicate and whose value is used by several of the other matching fields
static Map<String,Integer>	getAmbiguousMenmonics(Class<?> clazz, String commonPrefix) Scans using reflection API for all numeric public static final fields that have a common prefix and whose value is used by several of the other matching fields
static Collection<Field>	getMnemonicFields(Class<?> clazz, Predicate<? super Field> acceptor) Scans using reflection API for all numeric public static final fields that are also accepted by the predicate.
static boolean	isLoggable(Level level, Level threshold) Verifies if the given level is above the required threshold for logging.
static boolean	isLoggable(org.slf4j.Logger logger, Level level)
static void	logMessage(org.slf4j.Logger logger, Level level, Object message, Throwable t)
static SimplifiedLog	wrap(org.slf4j.Logger logger)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

generateMnemonicMap

public static Map<Integer,String> generateMnemonicMap(Class<?> clazz,
                                                      String commonPrefix)

Scans using reflection API for all fields that are public static final that start with the given common prefix (case sensitive) and are of type Number.

Parameters:

clazz - The Class to query

commonPrefix - The expected common prefix

Returns:

A Map of all the matching fields, where key=the field's Integer value and mapping=the field's name

See Also:

generateMnemonicMap(Class, Predicate)

generateMnemonicMap

public static Map<Integer,String> generateMnemonicMap(Class<?> clazz,
                                                      Predicate<? super Field> acceptor)

Scans using reflection API for all numeric public static final fields that are also accepted by the predicate. Any field that is not such or fail to retrieve its value, or has a duplicate value is silently skipped.

Parameters:

clazz - The Class to query

acceptor - The Predicate used to decide whether to process the Field (besides being a Number and public static final).

Returns:

A Map of all the matching fields, where key=the field's Integer value and mapping=the field's name

See Also:

getMnemonicFields(Class, Predicate)

getAmbiguousMenmonics

public static Map<String,Integer> getAmbiguousMenmonics(Class<?> clazz,
                                                        String commonPrefix)

Scans using reflection API for all numeric public static final fields that have a common prefix and whose value is used by several of the other matching fields

Parameters:

clazz - The Class to query

commonPrefix - The expected common prefix

Returns:

A Map of all the mnemonic fields names whose value is the same as other fields in this map. The key is the field's name and value is its associated opcode.

See Also:

getAmbiguousMenmonics(Class, Predicate)

getAmbiguousMenmonics

public static Map<String,Integer> getAmbiguousMenmonics(Class<?> clazz,
                                                        Predicate<? super Field> acceptor)

Scans using reflection API for all numeric public static final fields that are also accepted by the predicate and whose value is used by several of the other matching fields

Parameters:

clazz - The Class to query

acceptor - The Predicate used to decide whether to process the Field (besides being a Number and public static final).

Returns:

A Map of all the mnemonic fields names whose value is the same as other fields in this map. The key is the field's name and value is its associated opcode.

See Also:

getMnemonicFields(Class, Predicate)

getMnemonicFields

public static Collection<Field> getMnemonicFields(Class<?> clazz,
                                                  Predicate<? super Field> acceptor)

Scans using reflection API for all numeric public static final fields that are also accepted by the predicate.

Parameters:

clazz - The Class to query

acceptor - The Predicate used to decide whether to process the Field (besides being a Number and public static final).

Returns:

A Collection of all the fields that have satisfied all conditions

isLoggable

public static boolean isLoggable(Level level,
                                 Level threshold)

Verifies if the given level is above the required threshold for logging.

Parameters:

level - The Level to evaluate

threshold - The threshold Level

Returns:

true if the evaluated level is above the required threshold.

Note(s):

• If either argument is null then result is false.

• If the evaluated level is Level.OFF then result is false regardless of the threshold.

• If the threshold is Level.ALL and the evaluated level is not Level.OFF the result is true.

• Otherwise, the evaluated level Level.intValue() must be greater or equal to the threshold.

wrap

public static SimplifiedLog wrap(org.slf4j.Logger logger)

logMessage

public static void logMessage(org.slf4j.Logger logger,
                              Level level,
                              Object message,
                              Throwable t)

isLoggable

public static boolean isLoggable(org.slf4j.Logger logger,
                                 Level level)

Parameters:

logger - The Logger instance - ignored if null

level - The validate log Level - ignored if null

Returns:

true if the level is enabled for the logger. The mapping of the level to the logger is as follows:

• Level.OFF always returns false
• Level.SEVERE returns Logger.isErrorEnabled()
• Level.WARNING returns Logger.isWarnEnabled()
• Level.INFO and Level.ALL returns Logger.isInfoEnabled()
• Level.CONFIG and Level.FINE returns Logger.isDebugEnabled()
• All other levels return Logger.isTraceEnabled()