前面做了不少boost log的例子，現在來總結一下，下面是boost log庫的架構圖：

 下面總結一下和這個架構相關的知識：

1. 如何獲得Logging core

#include 
...
boost::shared_ptr core = logging::core::get();

2. 如何安裝Sink物件

一個core可以安裝多個Sink，下面的程式碼假定已經有了兩個Sink物件，將其安裝到core中

core->add_sink(sink1);
...
  core->add_sink(sink2);

3. 如何建立一個Sink物件

需要先建立一個backend物件，然後在建立sink物件的時候，將backend物件傳遞給它。

typedef sinks::synchronous_sink TextSink;
  // init sink1
  boost::shared_ptr backend1 = boost::make_shared(
  keywords::file_name = "sign_%Y-%m-%d_%H-%M-%S.%N.log",
  keywords::rotation_size = 10 * 1024 * 1024,
  keywords::time_based_rotation = sinks::file::rotation_at_time_point(0, 0, 0),
  keywords::min_free_space
 
 = 30 * 1024 * 1024);
  boost::shared_ptr sink1(new TextSink(backend1));

4. 如何建立一個backend物件

指定frontend型別

前面的程式碼中已經演示，注意backend的型別需要制定一個frontend型別作為其模板類。因此，當建立一個backend物件的時候，已經確定了frontend。

這個frontend模板可以用synchronous_sink類，也可以用asynchronous_sink, 後者不會阻塞呼叫程式，會額外的建立執行緒去處理log，不過會慢點，記憶體消耗大點。一般都推薦先用後者。

用keywords構造引數

這裡看到一個概念：keywords. 在boost/log/keywords/目錄下27個hpp檔案：

auto_flush.hpp  facility.hpp   ident.hpp       log_source.hpp      open_mode.hpp        rotation_size.hpp  target.hpp
channel.hpp     file_name.hpp  ip_version.hpp  max_size.hpp        order.hpp            scan_method.hpp    time_based_rotation.hpp
delimiter.hpp   filter.hpp     iteration.hpp   message_file.hpp    ordering_window.hpp  severity.hpp       use_impl.hpp
depth.hpp       format.hpp     log_name.hpp    min_free_space.hpp  registration.hpp     start_thread.hpp

sinks::text_file_backend

參考文件：

注意，text_file_backend的建構函式語法上支援變參，但是語義上只支援有限的keywords：

template< typename ArgsT >
    void construct(ArgsT const& args)
    {
        construct(
            filesystem::path(args[keywords::file_name | filesystem::path()]),
            args[keywords::open_mode | (std::ios_base::trunc | std::ios_base::out)],
            args[keywords::rotation_size | (std::numeric_limits< uintmax_t >::max)()],
            args[keywords::time_based_rotation | time_based_rotation_predicate()],
            args[keywords::auto_flush | false]);
    }

namespace aux {

    //! Creates and returns a file collector with the specified parameters
    BOOST_LOG_API shared_ptr< collector > make_collector(
        filesystem::path const& target_dir,
        uintmax_t max_size,
        uintmax_t min_free_space
    );
    template< typename ArgsT >
    inline shared_ptr< collector > make_collector(ArgsT const& args)
    {
        return aux::make_collector(
            filesystem::path(args[keywords::target]),
            args[keywords::max_size | (std::numeric_limits< uintmax_t >::max)()],
            args[keywords::min_free_space | static_cast< uintmax_t >(0)]);
    }

} // namespace aux

5. 如何在sink中指定格式

下面到了指定日誌格式，這個需要在sink中指定，比如：

sink1->set_formatter (
expr::format("[%1%]<%2%>(%3%): %4%")
% expr::format_date_time< boost::posix_time::ptime>("TimeStamp", "%Y-%m-%d %H:%M:%S")
% expr::attr("Severity")
% expr::attr("ThreadID")
% expr::smessage
);

我使用的是Boost::Format風格。