org.apache.felix.scr.impl.helper

Interface Logger

All Known Subinterfaces:

ComponentActivator

All Known Implementing Classes:

BundleComponentActivator

public interface Logger

The Logger interface defines a simple API to enable some logging in the XML Parser and ComponentMetadata handling classes and at the same time not be too intrusive for the unit tests.

Method Summary

Modifier and Type	Method and Description
boolean	isLogEnabled(int level) Returns true if logging for the given level is enabled.
void	log(int level, java.lang.String message, ComponentMetadata metadata, java.lang.Long componentId, java.lang.Throwable ex) Writes a messages for the given ComponentMetadata.
void	log(int level, java.lang.String pattern, java.lang.Object[] arguments, ComponentMetadata metadata, java.lang.Long componentId, java.lang.Throwable ex) Method to actually emit the log message.

Method Detail

isLogEnabled

boolean isLogEnabled(int level)

Returns true if logging for the given level is enabled.

log

void log(int level,
         java.lang.String pattern,
         java.lang.Object[] arguments,
         ComponentMetadata metadata,
         java.lang.Long componentId,
         java.lang.Throwable ex)

Method to actually emit the log message. If the LogService is available, the message will be logged through the LogService. Otherwise the message is logged to stdout (or stderr in case of LOG_ERROR level messages),

Parameters:

level - The log level to log the message at

pattern - The java.text.MessageFormat message format string for preparing the message

arguments - The format arguments for the pattern string.

metadata - component metadata if known

componentId - component ID if known

ex - An optional Throwable whose stack trace is written,

log

void log(int level,
         java.lang.String message,
         ComponentMetadata metadata,
         java.lang.Long componentId,
         java.lang.Throwable ex)

Writes a messages for the given ComponentMetadata.

Parameters:

level - The log level of the messages. This corresponds to the log levels defined by the OSGi LogService.

message - The message to print

metadata - The ComponentMetadata whose processing caused the message. This may be null if the component metadata is not known or applicable.

componentId -

ex - The Throwable causing the message to be logged.