Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15

API

SDK

Tips ‘n’ Tricks

Miscellaneous


:: com :: sun :: star :: logging ::

interface XLogger
Description
implemented by a component which is able to log events.

This interface is roughly designed after the Java Logging API. However, there are some differences, the major ones being:

  • There's no support (yet) for filtering log events.
  • There ain't no convenience menthods for logging.
  • There's no localization support.
  • Logger instances do not form a hierarchy.

Since
OOo 2.3

Methods' Summary
addLogHandler adds the given handler to the list of handlers.  
removeLogHandler removes the given handler from the list of handlers.  
isLoggable determines whether logger instance would produce any output for the given level.  
log logs a given message  
logp logs a given message, detailing the source class and method at which the logged event occured.  
Attributes' Summary
Name denotes the name of the logger.  
Level specifies which log events are logged or ignored.  
Methods' Details
addLogHandler
void
addLogHandler( [in] XLogHandler  LogHandler );

Description
adds the given handler to the list of handlers.

When an event is logged, the logger will create a LogRecord for this event, and pass this record to all registered handlers. Single handlers might or might not log those records at their own discretion, and depending on additional restrictions such as filters specified at handler level.

Note: The log level of the given handler (XLogHandler::Level) will not be touched. In particular, it will not be set to the logger's log level. It's the responsibility of the component which knits a logger with one or more log handlers to ensure that all loggers have appropriate levels set.

Parameter LogHandler
the handler to add to the list of handlers. The call is ignored if this parameter is NULL.
removeLogHandler
void
removeLogHandler( [in] XLogHandler  LogHandler );

Description
removes the given handler from the list of handlers.
Parameter LogHandler
the handler to remove from the list of handlers. The call is ignored if this parameter is NULL, or if the handler has not previously beed added.
isLoggable
boolean
isLoggable( [in] long  Level );

Description
determines whether logger instance would produce any output for the given level.

The method can be used to optimize performance as maybe complex parameter evaluation in the log calls can be omitted if isLoggable evaluates to false.

Parameter Level
level to be checked against
Returns
true if there would be some output for this XLogger for the given level, false otherwise. Note that a return value of false could also indicate that the logger does not have any log handlers associated with it.
See also
addLogHandler, removeLogHandler
log
void
log( [in] long  Level,
[in] string  Message );

Description
logs a given message
Parameter Level
the log level of this message. If this level is smaller than the logger's Level attribute, then the call will be ignored.
Parameter Message
the message to log
logp
void
logp( [in] long  Level,
[in] string  SourceClassName,
[in] string  SourceMethodName,
[in] string  Message );

Description
logs a given message, detailing the source class and method at which the logged event occured.
Parameter Level
the log level of this message. If this level is smaller than the logger's Level attribute, then the call will be ignored.
Parameter SourceClass
the source class at which the logged event occured.
Parameter SourceMethod
the source class at which the logged event occured.
Parameter Message
the message to log
Attributes' Details
Name
[ readonly ] string Name;
Description
denotes the name of the logger.
Level
long Level;
Description
specifies which log events are logged or ignored.
See also
LogLevel
Top of Page

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.