INTEGRATION: CWS sdblogging (1.9.58); FILE MERGED

2007/04/12 09:17:05 fs 1.9.58.1: #i76119# deprecate in favor of css.logging.*

udkapi/com/sun/star/util/logging/XLoggerRemote.idl

@@ -4,9 +4,9 @@
  *
  *  $RCSfile: XLoggerRemote.idl,v $
  *
- *  $Revision: 1.9 $
+ *  $Revision: 1.10 $
  *
- *  last change: $Author: rt $ $Date: 2005-09-09 16:43:02 $
+ *  last change: $Author: hr $ $Date: 2007-06-27 14:52:32 $
  *
  *  The Contents of this file are made available subject to
  *  the terms of GNU Lesser General Public License Version 2.1.
@@ -49,97 +49,31 @@
 module com { module sun { module star { module util { module logging {
 
 //=============================================================================
-/** 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.
+/** deprecated API - use <type scope="com::sun::star::logging">XLogger</type> instead
 
+    @deprecated
     @since OOo 1.1.2
 */
-
 published interface XLoggerRemote: com::sun::star::uno::XInterface
 {
-    /** gets logging level of this XLoggerRemote
-
-        @returns logging level of this XLoggerRemote
-    */
-
+    /// @deprecated
     long getLevel();
 
-    //-------------------------------------------------------------------------
-
-    /** gets name of this XLoggerRemote
-
-        @returns name of this XLoggerRemote
-    */
-
+    /// @deprecated
     string getName();
 
-    //-------------------------------------------------------------------------
-
-    /** 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
-
-        @param level
-        level to be checked against
-
-        @returns true if there will be some output for this XLoggerRemote for the given level,
-                 false otherwise
-    */
-
+    /// @deprecated
     boolean isLoggable( [in] long level );
 
-    //-------------------------------------------------------------------------
-
-    /** Log a message. The p in logp is derived from "precise" as given
-        is the java.util.logging API
-
-        @param level
-        the log level of this message
-
-        @param sourceClass
-        name of class that issued the logging request
-
-        @param sourceMethod
-        name of method that issued the logging request
-
-        @param msg
-        the string message
-
-        @param thread
-        client thread that initially called this method
-    */
-
+    /// @deprecated
     [oneway] void logp( [in] long   level,
                         [in] string sourceClass,
                         [in] string sourceMethod,
                         [in] string msg,
                         [in] string thread );
 
-    //-------------------------------------------------------------------------
-
-    /** 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.
-
-        @param listener
-        properties change listener
-    */
-
+    /// @deprecated
     [oneway] void addPropertiesChangeListener(
                 [in] com::sun::star::beans::XPropertiesChangeListener listener);
 };