org.osgi.service.log

Interface LogService

All Superinterfaces:

LoggerFactory

@ProviderType
public interface LogService
extends LoggerFactory

LogService for logging information.

Replaced by LoggerFactory.

"ThreadSafe"

Field Summary

Fields

Modifier and Type	Field and Description
static int	LOG_DEBUG Deprecated. Since 1.4. Replaced by LogLevel.DEBUG.
static int	LOG_ERROR Deprecated. Since 1.4. Replaced by LogLevel.ERROR.
static int	LOG_INFO Deprecated. Since 1.4. Replaced by LogLevel.INFO.
static int	LOG_WARNING Deprecated. Since 1.4. Replaced by LogLevel.WARN.

Method Summary

Modifier and Type	Method and Description
void	log(int level, java.lang.String message) Deprecated. Since 1.4. Replaced by Logger. See LoggerFactory.
void	log(int level, java.lang.String message, java.lang.Throwable exception) Deprecated. Since 1.4. Replaced by Logger. See LoggerFactory.
void	log(ServiceReference<?> sr, int level, java.lang.String message) Deprecated. Since 1.4. Replaced by Logger. See LoggerFactory.
void	log(ServiceReference<?> sr, int level, java.lang.String message, java.lang.Throwable exception) Deprecated. Since 1.4. Replaced by Logger. See LoggerFactory.

Methods inherited from interface org.osgi.service.log.LoggerFactory

getLogger, getLogger, getLogger, getLogger, getLogger

Field Detail

LOG_ERROR

@Deprecated
static final int LOG_ERROR

Deprecated. Since 1.4. Replaced by LogLevel.ERROR.

An error message (Value 1).

This log entry indicates the bundle or service may not be functional.

See Also:

Constant Field Values

LOG_WARNING

@Deprecated
static final int LOG_WARNING

Deprecated. Since 1.4. Replaced by LogLevel.WARN.

A warning message (Value 2).

This log entry indicates a bundle or service is still functioning but may experience problems in the future because of the warning condition.

See Also:

Constant Field Values

LOG_INFO

@Deprecated
static final int LOG_INFO

Deprecated. Since 1.4. Replaced by LogLevel.INFO.

An informational message (Value 3).

This log entry may be the result of any change in the bundle or service and does not indicate a problem.

See Also:

Constant Field Values

LOG_DEBUG

@Deprecated
static final int LOG_DEBUG

Deprecated. Since 1.4. Replaced by LogLevel.DEBUG.

A debugging message (Value 4).

This log entry is used for problem determination and may be irrelevant to anyone but the bundle developer.

See Also:

Constant Field Values

Method Detail

log

@Deprecated
void log(int level,
                     java.lang.String message)

Deprecated. Since 1.4. Replaced by Logger. See LoggerFactory.

Logs a message.

The ServiceReference field and the Throwable field of the LogEntry object will be set to null.

This method will log to the bundle's Logger named "LogService.<bsn>" where <bsn> is the Bundle Symbolic Name of the bundle.

The specified level is mapped to a LogLevel as follows:

• LOG_ERROR - LogLevel.ERROR
• LOG_WARNING - LogLevel.WARN
• LOG_INFO - LogLevel.INFO
• LOG_DEBUG - LogLevel.DEBUG
• Any other value - LogLevel.TRACE

In the generated log entry, LogEntry.getLevel() must return the specified level.

Parameters:

level - The severity of the message. This should be one of the defined log levels but may be any integer that is interpreted in a user defined way.

message - Human readable string describing the condition or null.

log

@Deprecated
void log(int level,
                     java.lang.String message,
                     java.lang.Throwable exception)

Deprecated. Since 1.4. Replaced by Logger. See LoggerFactory.

Logs a message with an exception.

The ServiceReference field of the LogEntry object will be set to null.

This method will log to the bundle's Logger named "LogService.<bsn>" where <bsn> is the Bundle Symbolic Name of the bundle.

The specified level is mapped to a LogLevel as follows:

• LOG_ERROR - LogLevel.ERROR
• LOG_WARNING - LogLevel.WARN
• LOG_INFO - LogLevel.INFO
• LOG_DEBUG - LogLevel.DEBUG
• Any other value - LogLevel.TRACE

In the generated log entry, LogEntry.getLevel() must return the specified level.

Parameters:

level - The severity of the message. This should be one of the defined log levels but may be any integer that is interpreted in a user defined way.

message - The human readable string describing the condition or null.

exception - The exception that reflects the condition or null.

log

@Deprecated
void log(ServiceReference<?> sr,
                     int level,
                     java.lang.String message)

Deprecated. Since 1.4. Replaced by Logger. See LoggerFactory.

Logs a message associated with a specific ServiceReference object.

The Throwable field of the LogEntry will be set to null.

This method will log to the bundle's Logger named "LogService.<bsn>" where <bsn> is the Bundle Symbolic Name of the bundle.

The specified level is mapped to a LogLevel as follows:

• LOG_ERROR - LogLevel.ERROR
• LOG_WARNING - LogLevel.WARN
• LOG_INFO - LogLevel.INFO
• LOG_DEBUG - LogLevel.DEBUG
• Any other value - LogLevel.TRACE

In the generated log entry, LogEntry.getLevel() must return the specified level.

Parameters:

sr - The ServiceReference object of the service that this message is associated with or null.

level - The severity of the message. This should be one of the defined log levels but may be any integer that is interpreted in a user defined way.

message - Human readable string describing the condition or null.

log

@Deprecated
void log(ServiceReference<?> sr,
                     int level,
                     java.lang.String message,
                     java.lang.Throwable exception)

Deprecated. Since 1.4. Replaced by Logger. See LoggerFactory.

Logs a message with an exception associated and a ServiceReference object.

This method will log to the bundle's Logger named "LogService.<bsn>" where <bsn> is the Bundle Symbolic Name of the bundle.

The specified level is mapped to a LogLevel as follows:

• LOG_ERROR - LogLevel.ERROR
• LOG_WARNING - LogLevel.WARN
• LOG_INFO - LogLevel.INFO
• LOG_DEBUG - LogLevel.DEBUG
• Any other value - LogLevel.TRACE

In the generated log entry, LogEntry.getLevel() must return the specified level.

Parameters:

sr - The ServiceReference object of the service that this message is associated with.

level - The severity of the message. This should be one of the defined log levels but may be any integer that is interpreted in a user defined way.

message - Human readable string describing the condition or null.

exception - The exception that reflects the condition or null.