Logger.h

// Copyright (c) ZeroC, Inc.
 
#ifndef ICE_LOGGER_H
#define ICE_LOGGER_H
 
#include "Config.h"
 
#include <memory>
#include <string>
 
namespace Ice
{
    class Logger;
 
    /// A shared pointer to a Logger.
    using LoggerPtr = std::shared_ptr<Logger>;
 
    /// Represents Ice's abstraction for logging and tracing. Applications can provide their own logger by
    /// implementing this abstraction and setting a logger on the communicator.
    /// @see InitializationData
    /// @headerfile Ice/Ice.h
    class ICE_API Logger
    {
    public:
        virtual ~Logger();
 
        // We use const std::string& and not std::string_view for the log messages because implementations commonly
        // send the message to C APIs that require null-terminated strings.
        // The message itself is also often constructed from a string produced by an ostringstream.
 
        /// Prints a message. The message is printed literally, without any decorations such as executable name or
        /// timestamp.
        /// @param message The message to log.
        virtual void print(const std::string& message) = 0;
 
        /// Logs trace message.
        /// @param category The trace category.
        /// @param message The trace message to log.
        virtual void trace(const std::string& category, const std::string& message) = 0;
 
        /// Logs a warning message.
        /// @param message The warning message to log.
        /// @see #error
        virtual void warning(const std::string& message) = 0;
 
        /// Logs an error message.
        /// @param message The error message to log.
        /// @see #warning
        virtual void error(const std::string& message) = 0;
 
        /// Returns this logger's prefix.
        /// @return The prefix.
        virtual std::string getPrefix() = 0;
 
        /// Returns a clone of the logger with a new prefix.
        /// @param prefix The new prefix for the logger.
        /// @return A logger instance.
        virtual LoggerPtr cloneWithPrefix(std::string prefix) = 0;
    };
}
 
#endif