Interface LogService
LogService
methods are provided to log messages; optionally with a
ServiceReference
object or an exception.
Bundles must log messages in the OSGi environment with a severity level according to the following hierarchy:
- Version:
- $Revision: 5654 $
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int
A debugging message (Value 4).static final int
An error message (Value 1).static final int
An informational message (Value 3).static final int
A warning message (Value 2). -
Method Summary
Modifier and TypeMethodDescriptionvoid
Logs a message.void
Logs a message with an exception.void
Logs a message associated with a specificServiceReference
object.void
Logs a message with an exception associated and aServiceReference
object.
-
Field Details
-
LOG_ERROR
static final int LOG_ERRORAn error message (Value 1).This log entry indicates the bundle or service may not be functional.
- See Also:
-
LOG_WARNING
static final int LOG_WARNINGA 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:
-
LOG_INFO
static final int LOG_INFOAn 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:
-
LOG_DEBUG
static final int LOG_DEBUGA debugging message (Value 4).This log entry is used for problem determination and may be irrelevant to anyone but the bundle developer.
- See Also:
-
-
Method Details
-
log
Logs a message.The
ServiceReference
field and theThrowable
field of theLogEntry
object will be set tonull
.- 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 ornull
.- See Also:
-
log
Logs a message with an exception.The
ServiceReference
field of theLogEntry
object will be set tonull
.- 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 ornull
.exception
- The exception that reflects the condition ornull
.- See Also:
-
log
Logs a message associated with a specificServiceReference
object.The
Throwable
field of theLogEntry
will be set tonull
.- Parameters:
sr
- TheServiceReference
object of the service that this message is associated with ornull
.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 ornull
.- See Also:
-
log
Logs a message with an exception associated and aServiceReference
object.- Parameters:
sr
- TheServiceReference
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 ornull
.exception
- The exception that reflects the condition ornull
.- See Also:
-