第一個嘗試

我的第一個嘗試參考了 Boost.Log 文件中關於擴充程式庫的範例 ，重點在於提供自訂的 formatter 和 formatter_factory：

class LogLevelFormatter
{
public:
    typedef void result_type;

    explicit LogLevelFormatter(const std::string& format)
        : useColor_(format == "color")
    {}

    void operator() (blog::formatting_ostream& strm,
                     const blog::value_ref<LogLevel>& value)
    {
        if (value) {
            LogLevel level = value.get();
            if (useColor_) {
                switch (level) {
                case LOG_DEBUG:
                    strm << ANSI_GREEN;
                    break;
                case LOG_ERROR:
                    .....
                }
                strm << level << ANSI_CLEAR;
            } else {
                strm << level;
            }
        }
    }

private:
    bool useColor_;
};


class LogLevelFormatterFactory
    : public blog::basic_formatter_factory<char, LogLevel>
{
public:
    formatter_type create_formatter(
                const blog::attribute_name& name,
                const args_map& args)
    {
        args_map::const_iterator it = args.find("format");
        if (it != args.end()) {
            return boost::phoenix::bind(
                        LogLevelFormatter(it->second),
                        expr::stream,
                        expr::attr<LogLevel>(name));
        } else {
            return expr::stream << expr::attr<LogLevel>(name);
        }
    }
};

然後 initConsoleLog() 大致上像這樣：

void initConsoleLog(bool useColor = true)
{
    blog::register_formatter_factory(
            "Severity", boost::make_shared<LogLevelFormatterFactory>());

    if (useColor) {
        blog::add_console_log(
                std::clog,
                keywords::format = "<%TimeStamp%> [%Severity(format=\"color\")%] %Message%");
    } else {
        blog::add_console_log(
                std::clog,
                keywords::format = "<%TimeStamp%> [%Severity%] %Message%");
    }
}

這個做法看起來有點小麻煩，而且如果不只想幫 Severity 這個屬性加顏色，還希望將整條訊息用花俏的方式上色（例如，遇到 fatal 就把整條訊息的背景換成紅色），這個方法就顯得很吃力。

這個方法最大的好處在於，只要 formatter factory 設定好，我們可以利用 boost::log::init_from_stream() 直接從設定檔載入所有設定，後續的改變某種程度上不需要改動程式碼。

第二種做法

我比較喜歡簡單的方法：

void consoleColorFormatter(blog::record_view const& rec, blog::formatting_ostream& strm)
{
    blog::formatter timestampFormat =
            expr::stream
                << expr::format_date_time<boost::posix_time::ptime>(
                    "TimeStamp", "<%Y-%m-%d %H:%M:%S>");

    timestampFormat(rec, strm);

    // If further formatting is not needed.
    // strm << blog::extract<boost::posix_time::ptime>("TimeStamp", rec).get();

    LogLevel level = blog::extract<LogLevel>("Severity", rec).get();
    switch (level) {
    case LOG_DEBUG:
        strm << ANSI_GREEN;
        break;
    case LOG_ERROR:
        .....
    }

    strm << " [" << level << "] " << ANSI_CLEAR;
    strm << rec[expr::smessage];
}

void initConsoleLog(bool useColor = true)
{
    using boost::shared_ptr;
    typedef sinks::text_ostream_backend Backend;
    typedef sinks::synchronous_sink<Backend> Sink;

    shared_ptr<Sink> sink = blog::add_console_log(std::clog);
    if (useColor) {
        sink->set_formatter(&consoleColorFormatter);
    } else {
        sink->set_formatter( /*...whatever...*/ );
    }
}

這裡唯一需要注意的是，expr::stream 並不直接輸出，而是產生一個 function object。這個方法的優缺點剛好和第一種方法相反，愛怎麼上色就怎麼上色，但格式就綁在程式碼中了。

我沒有仔細研究過能不能直接用 Boost.Log 的 lambda expression 實作，畢竟三不五時學一下這種自有品牌的 lambda expression 是一件很惱人的事。