Package org.glassfish.jersey.logging

Class LoggingFeature

java.lang.Object

org.glassfish.jersey.logging.LoggingFeature

All Implemented Interfaces:

javax.ws.rs.core.Feature

public class LoggingFeature
extends java.lang.Object
implements javax.ws.rs.core.Feature

This feature enables logging request and/or response on client-side and/or server-side depending on the context's RuntimeType.

The feature may be register programmatically like other features by calling any of Configurable register(...) method, i.e. Configurable.register(Class) or by setting any of the configuration property listed bellow.

Common configurable properties applies for both client and server and are following:

• LOGGING_FEATURE_LOGGER_NAME
• LOGGING_FEATURE_LOGGER_LEVEL
• LOGGING_FEATURE_VERBOSITY
• LOGGING_FEATURE_MAX_ENTITY_SIZE

If any of the configuration value is not set, following default values are applied:

• logger name: org.glassfish.jersey.logging.LoggingFeature
• logger level: Level.FINE
• verbosity: LoggingFeature.Verbosity.PAYLOAD_TEXT
• maximum entity size: 8192

Server configurable properties:

• LOGGING_FEATURE_LOGGER_NAME_SERVER
• LOGGING_FEATURE_LOGGER_LEVEL_SERVER
• LOGGING_FEATURE_VERBOSITY_SERVER
• LOGGING_FEATURE_MAX_ENTITY_SIZE_SERVER

Client configurable properties:

• LOGGING_FEATURE_LOGGER_NAME_CLIENT
• LOGGING_FEATURE_LOGGER_LEVEL_CLIENT
• LOGGING_FEATURE_VERBOSITY_CLIENT
• LOGGING_FEATURE_MAX_ENTITY_SIZE_CLIENT

Since:

2.23

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	LoggingFeature.Verbosity	Verbosity determines how detailed message will be logged.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	DEFAULT_LOGGER_LEVEL	Default logger level which will be used for logging request and response messages.
static java.lang.String	DEFAULT_LOGGER_NAME	Default logger name to log request and response messages.
static int	DEFAULT_MAX_ENTITY_SIZE	Default maximum entity bytes to be logged.
static LoggingFeature.Verbosity	DEFAULT_VERBOSITY	Default verbosity for entity logging.
private java.util.logging.Logger	filterLogger
private java.util.logging.Level	level
private static java.lang.String	LOGGER_LEVEL_POSTFIX
private static java.lang.String	LOGGER_NAME_POSTFIX
private static java.lang.String	LOGGING_FEATURE_CLIENT_PREFIX
private static java.lang.String	LOGGING_FEATURE_COMMON_PREFIX
static java.lang.String	LOGGING_FEATURE_LOGGER_LEVEL	Common logger level property.
static java.lang.String	LOGGING_FEATURE_LOGGER_LEVEL_CLIENT	Client logger level property.
static java.lang.String	LOGGING_FEATURE_LOGGER_LEVEL_SERVER	Server logger level property.
static java.lang.String	LOGGING_FEATURE_LOGGER_NAME	Common logger name property.
static java.lang.String	LOGGING_FEATURE_LOGGER_NAME_CLIENT	Client logger name property.
static java.lang.String	LOGGING_FEATURE_LOGGER_NAME_SERVER	Server logger name property.
static java.lang.String	LOGGING_FEATURE_MAX_ENTITY_SIZE	Common property for configuring a maximum number of bytes of entity to be logged.
static java.lang.String	LOGGING_FEATURE_MAX_ENTITY_SIZE_CLIENT	Client property for configuring a maximum number of bytes of entity to be logged.
static java.lang.String	LOGGING_FEATURE_MAX_ENTITY_SIZE_SERVER	Server property for configuring a maximum number of bytes of entity to be logged.
private static java.lang.String	LOGGING_FEATURE_SERVER_PREFIX
static java.lang.String	LOGGING_FEATURE_VERBOSITY	Common property for configuring a verbosity of entity.
static java.lang.String	LOGGING_FEATURE_VERBOSITY_CLIENT	Client property for configuring a verbosity of entity.
static java.lang.String	LOGGING_FEATURE_VERBOSITY_SERVER	Server property for configuring a verbosity of entity.
private static java.lang.String	MAX_ENTITY_POSTFIX
private java.lang.Integer	maxEntitySize
private LoggingFeature.Verbosity	verbosity
private static java.lang.String	VERBOSITY_POSTFIX

Constructor Summary

Constructors

Constructor	Description
LoggingFeature()	Creates the feature with default values.
LoggingFeature(java.util.logging.Logger logger)	Creates the feature with custom logger.
LoggingFeature(java.util.logging.Logger logger, java.lang.Integer maxEntitySize)	Creates the feature with custom logger and maximum number of bytes of entity to log.
LoggingFeature(java.util.logging.Logger logger, java.util.logging.Level level, LoggingFeature.Verbosity verbosity, java.lang.Integer maxEntitySize)	Creates the feature with custom logger, it's level, message verbosity and maximum number of bytes of entity to log.
LoggingFeature(java.util.logging.Logger logger, LoggingFeature.Verbosity verbosity)	Creates the feature with custom logger and verbosity.

Method Summary

Modifier and Type	Method	Description
boolean	configure(javax.ws.rs.core.FeatureContext context)
private LoggingInterceptor	createLoggingFilter(javax.ws.rs.core.FeatureContext context, javax.ws.rs.RuntimeType runtimeType)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_LOGGER_NAME

public static final java.lang.String DEFAULT_LOGGER_NAME

Default logger name to log request and response messages.

DEFAULT_LOGGER_LEVEL

public static final java.lang.String DEFAULT_LOGGER_LEVEL

Default logger level which will be used for logging request and response messages.

DEFAULT_MAX_ENTITY_SIZE

public static final int DEFAULT_MAX_ENTITY_SIZE

Default maximum entity bytes to be logged.

See Also:

Constant Field Values

DEFAULT_VERBOSITY

public static final LoggingFeature.Verbosity DEFAULT_VERBOSITY

Default verbosity for entity logging. See LoggingFeature.Verbosity.

LOGGER_NAME_POSTFIX

private static final java.lang.String LOGGER_NAME_POSTFIX

See Also:

Constant Field Values

LOGGER_LEVEL_POSTFIX

private static final java.lang.String LOGGER_LEVEL_POSTFIX

See Also:

Constant Field Values

VERBOSITY_POSTFIX

private static final java.lang.String VERBOSITY_POSTFIX

See Also:

Constant Field Values

MAX_ENTITY_POSTFIX

private static final java.lang.String MAX_ENTITY_POSTFIX

See Also:

Constant Field Values

LOGGING_FEATURE_COMMON_PREFIX

private static final java.lang.String LOGGING_FEATURE_COMMON_PREFIX

See Also:

Constant Field Values

LOGGING_FEATURE_LOGGER_NAME

public static final java.lang.String LOGGING_FEATURE_LOGGER_NAME

Common logger name property.

See Also:

Constant Field Values

LOGGING_FEATURE_LOGGER_LEVEL

public static final java.lang.String LOGGING_FEATURE_LOGGER_LEVEL

Common logger level property.

See Also:

Constant Field Values

LOGGING_FEATURE_VERBOSITY

public static final java.lang.String LOGGING_FEATURE_VERBOSITY

Common property for configuring a verbosity of entity.

See Also:

Constant Field Values

LOGGING_FEATURE_MAX_ENTITY_SIZE

public static final java.lang.String LOGGING_FEATURE_MAX_ENTITY_SIZE

Common property for configuring a maximum number of bytes of entity to be logged.

See Also:

Constant Field Values

LOGGING_FEATURE_SERVER_PREFIX

private static final java.lang.String LOGGING_FEATURE_SERVER_PREFIX

See Also:

Constant Field Values

LOGGING_FEATURE_LOGGER_NAME_SERVER

public static final java.lang.String LOGGING_FEATURE_LOGGER_NAME_SERVER

Server logger name property.

See Also:

Constant Field Values

LOGGING_FEATURE_LOGGER_LEVEL_SERVER

public static final java.lang.String LOGGING_FEATURE_LOGGER_LEVEL_SERVER

Server logger level property.

See Also:

Constant Field Values

LOGGING_FEATURE_VERBOSITY_SERVER

public static final java.lang.String LOGGING_FEATURE_VERBOSITY_SERVER

Server property for configuring a verbosity of entity.

See Also:

Constant Field Values

LOGGING_FEATURE_MAX_ENTITY_SIZE_SERVER

public static final java.lang.String LOGGING_FEATURE_MAX_ENTITY_SIZE_SERVER

Server property for configuring a maximum number of bytes of entity to be logged.

See Also:

Constant Field Values

LOGGING_FEATURE_CLIENT_PREFIX

private static final java.lang.String LOGGING_FEATURE_CLIENT_PREFIX

See Also:

Constant Field Values

LOGGING_FEATURE_LOGGER_NAME_CLIENT

public static final java.lang.String LOGGING_FEATURE_LOGGER_NAME_CLIENT

Client logger name property.

See Also:

Constant Field Values

LOGGING_FEATURE_LOGGER_LEVEL_CLIENT

public static final java.lang.String LOGGING_FEATURE_LOGGER_LEVEL_CLIENT

Client logger level property.

See Also:

Constant Field Values

LOGGING_FEATURE_VERBOSITY_CLIENT

public static final java.lang.String LOGGING_FEATURE_VERBOSITY_CLIENT

Client property for configuring a verbosity of entity.

See Also:

Constant Field Values

LOGGING_FEATURE_MAX_ENTITY_SIZE_CLIENT

public static final java.lang.String LOGGING_FEATURE_MAX_ENTITY_SIZE_CLIENT

Client property for configuring a maximum number of bytes of entity to be logged.

See Also:

Constant Field Values

filterLogger

private final java.util.logging.Logger filterLogger

verbosity

private final LoggingFeature.Verbosity verbosity

maxEntitySize

private final java.lang.Integer maxEntitySize

level

private final java.util.logging.Level level

Constructor Detail

LoggingFeature

public LoggingFeature()

Creates the feature with default values.

LoggingFeature

public LoggingFeature(java.util.logging.Logger logger)

Creates the feature with custom logger.

Parameters:

logger - the logger to log requests and responses.

LoggingFeature

public LoggingFeature(java.util.logging.Logger logger,
                      LoggingFeature.Verbosity verbosity)

Creates the feature with custom logger and verbosity.

Parameters:

logger - the logger to log requests and responses.

verbosity - verbosity of logged messages. See LoggingFeature.Verbosity.

LoggingFeature

public LoggingFeature(java.util.logging.Logger logger,
                      java.lang.Integer maxEntitySize)

Creates the feature with custom logger and maximum number of bytes of entity to log.

Parameters:

logger - the logger to log requests and responses.

maxEntitySize - maximum number of entity bytes to be logged (and buffered) - if the entity is larger, logging filter will print (and buffer in memory) only the specified number of bytes and print "...more..." string at the end. Negative values are interpreted as zero.

LoggingFeature

public LoggingFeature(java.util.logging.Logger logger,
                      java.util.logging.Level level,
                      LoggingFeature.Verbosity verbosity,
                      java.lang.Integer maxEntitySize)

Creates the feature with custom logger, it's level, message verbosity and maximum number of bytes of entity to log.

Parameters:

logger - the logger to log requests and responses.

level - level on which the messages will be logged.

verbosity - verbosity of logged messages. See LoggingFeature.Verbosity.

maxEntitySize - maximum number of entity bytes to be logged (and buffered) - if the entity is larger, logging filter will print (and buffer in memory) only the specified number of bytes and print "...more..." string at the end. Negative values are interpreted as zero.

Method Detail

configure

public boolean configure(javax.ws.rs.core.FeatureContext context)

Specified by:

configure in interface javax.ws.rs.core.Feature

createLoggingFilter

private LoggingInterceptor createLoggingFilter(javax.ws.rs.core.FeatureContext context,
                                               javax.ws.rs.RuntimeType runtimeType)