OSGi 8.1.0 · org.osgi.service.log.LogService · APIdia, the JavaDoc alternative

Modifier and Type	Field and Description
public static final int	LOG_DEBUG Deprecated Since 1.4. Replaced by `LogLevel#DEBUG`. A debugging message (Value 4).
public static final int	LOG_ERROR Deprecated Since 1.4. Replaced by `LogLevel#ERROR`. An error message (Value 1).
public static final int	LOG_INFO Deprecated Since 1.4. Replaced by `LogLevel#INFO`. An informational message (Value 3).
public static final int	LOG_WARNING Deprecated Since 1.4. Replaced by `LogLevel#WARN`. A warning message (Value 2).

Method Summary

Modifier and Type	Method and Description
public void	log(int 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. level, String Human readable string describing the condition or `null`. message) Deprecated Since 1.4. Replaced by `Logger`. See `LoggerFactory`. Logs a message.
public void	log(int 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. level, String The human readable string describing the condition or `null`. message, Throwable The exception that reflects the condition or `null`. exception) Deprecated Since 1.4. Replaced by `Logger`. See `LoggerFactory`. Logs a message with an exception.
public void	log(ServiceReference<?> The `ServiceReference` object of the service that this message is associated with or `null`. sr, int 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. level, String Human readable string describing the condition or `null`. message) Deprecated Since 1.4. Replaced by `Logger`. See `LoggerFactory`. Logs a message associated with a specific `ServiceReference` object.
public void	log(ServiceReference<?> The `ServiceReference` object of the service that this message is associated with. sr, int 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. level, String Human readable string describing the condition or `null`. message, Throwable The exception that reflects the condition or `null`. exception) Deprecated Since 1.4. Replaced by `Logger`. See `LoggerFactory`. Logs a message with an exception associated and a `ServiceReference` object.

Inherited from org.osgi.service.log.LoggerFactory:: getLogger getLogger getLogger getLogger getLogger

LOG_DEBUG	back to summary
public 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. Annotations @Deprecated

LOG_ERROR	back to summary
public 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. Annotations @Deprecated

LOG_INFO	back to summary
public 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. Annotations @Deprecated

LOG_WARNING	back to summary
public 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. Annotations @Deprecated

Method Detail

log back to summary

log	back to summary
public void log(int level, 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:int 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:String Human readable string describing the condition or `null`. Annotations @Deprecated

public void log(int level, 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:

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

Parameters

level:int: 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:String: Human readable string describing the condition or null.

Annotations

@Deprecated

log back to summary

log	back to summary
public void log(int level, String message, 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:int 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:String The human readable string describing the condition or `null`. exception:Throwable The exception that reflects the condition or `null`. Annotations @Deprecated

public void log(int level, String message, 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:

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

Parameters

level:int: 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:String: The human readable string describing the condition or null.
exception:Throwable: The exception that reflects the condition or null.

Annotations

@Deprecated

log back to summary

log	back to summary
public void log(ServiceReference<?> sr, int level, 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:ServiceReference<?> The `ServiceReference` object of the service that this message is associated with or `null`. level:int 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:String Human readable string describing the condition or `null`. Annotations @Deprecated

public void log(ServiceReference<?> sr, int level, 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:

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

Parameters

sr:ServiceReference<?>: The ServiceReference object of the service that this message is associated with or null.
level:int: 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:String: Human readable string describing the condition or null.

Annotations

@Deprecated

log back to summary

log	back to summary
public void log(ServiceReference<?> sr, int level, String message, 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:ServiceReference<?> The `ServiceReference` object of the service that this message is associated with. level:int 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:String Human readable string describing the condition or `null`. exception:Throwable The exception that reflects the condition or `null`. Annotations @Deprecated

public void log(ServiceReference<?> sr, int level, String message, 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:

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

Parameters

sr:ServiceReference<?>: The ServiceReference object of the service that this message is associated with.
level:int: 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:String: Human readable string describing the condition or null.
exception:Throwable: The exception that reflects the condition or null.

Annotations

@Deprecated

public Interface LogService

Field Summary

Method Summary

Field Detail

Method Detail