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

interface XLoggerRemote
Description
Remote logging interface. The twin of XLogger. This interface will do the remote communication. Differences compared with XLogger: getLogger() is omitted as createInstance will suffice here. No need to obey to the java API here. getName() and isLoggable() are added here just in case. Normally these two can be handled by XLogger without using this interface. logp() contains an additional parameter "thread" which enables the server to display the client thread of this call addPropertiesChangeListener() is used to register a call back with the server. This enables ther server to communicate any changes in the configuration to the client. The client can use this info to do some prechecks thus avoiding unneccessary remote calls.
Since
OpenOffice 1.1.2

Methods' Summary
getLevel gets logging level of this XLoggerRemote  
getName gets name of this XLoggerRemote  
isLoggable will this XLoggerRemote produce any output for the given level? can be used to optimize performance as maybe complex parameter evaluation in the logp call can be omitted if isLoggable evaluates to false  
logp Log a message. The p in logp is derived from "precise" as given is the java.util.logging API  
addPropertiesChangeListener adds a properties change listener that informs the client if some performance relevant data changed on server side. For now we just transmit the LogLevel thus we do not need any remote calls just for checking the need to log.  
Methods' Details
getLevel
long
getLevel();

Description
gets logging level of this XLoggerRemote
Returns
logging level of this XLoggerRemote
getName
string
getName();

Description
gets name of this XLoggerRemote
Returns
name of this XLoggerRemote
isLoggable
boolean
isLoggable( [in] long  level );

Description
will this XLoggerRemote produce any output for the given level? can be used to optimize performance as maybe complex parameter evaluation in the logp call can be omitted if isLoggable evaluates to false
Parameter level
level to be checked against
Returns
true if there will be some output for this XLoggerRemote for the given level, false otherwise
logp
[oneway] void
logp( [in] long  level,
[in] string  sourceClass,
[in] string  sourceMethod,
[in] string  msg,
[in] string  thread );

Description
Log a message. The p in logp is derived from "precise" as given is the java.util.logging API
Parameter level
the log level of this message
Parameter sourceClass
name of class that issued the logging request
Parameter sourceMethod
name of method that issued the logging request
Parameter msg
the string message
Parameter thread
client thread that initially called this method
addPropertiesChangeListener
[oneway] void
addPropertiesChangeListener( [in] ::com::sun::star::beans::XPropertiesChangeListener  listener );

Description
adds a properties change listener that informs the client if some performance relevant data changed on server side. For now we just transmit the LogLevel thus we do not need any remote calls just for checking the need to log.
Parameter listener
properties change listener
Top of Page