阅读排行
首页 > 技术文章

boost.log（九） 配置文件

    前面几节中描述了Boost.Log 的基础知识，对Boost.Log 库的操作我们都是在C++代码中进行中，这样就会有一些不便的地方。比如说我们想要更改一下输出格式或者过滤条件，都必须对C++代码进行更改，并且还得编译一次（感觉编译时间还有点长）。其实Boost.Log 里面已经为这个问题提供了一种解决方案，就是通过配置文件来初始化Boost.Log 库，C++这边的代码也比较简单，就是这样的：
  1. std::ifstream settings("settings.txt");
  2. if (!settings.is_open())
  3. 	throw std::runtime_error("Could not open settings.txt file");
  4. logging::init_from_stream(settings);
示例代码：
技术分享

    就这几句代码我们就可以完成对Boost.Log 的简单初始化了，不用自己去写格式化、接收器、过滤条件什么的，非常方便。现在来看看"settings.txt"文件，看看它是怎么让Boost.Log进行初始化的，下面是"settings.txt"文件的内容：
  1. #
  2. #          Copyright Andrey Semashev 2007 - 2014.
  3. # Distributed under the Boost Software License, Version 1.0.
  4. #    (See accompanying file LICENSE_1_0.txt or copy at
  5. #          http://www.boost.org/LICENSE_1_0.txt)
  6. #
  8. [Sinks.TextFileSettings]
  9. Destination=TextFile
  10. FileName=test.log
  11. AutoFlush=true
  12. Format="[%TimeStamp%] [%Severity%]\n%MyScopes%\n\t:: %Message%"
  13. Asynchronous=false

Boost.Log库就是通过读取上面那些选项及所对应的数据来进行初始化操作的，下面列出所有默认的可用选项，并解释一下的常用选项的含义：
  1. // Core 配置
  2. Core
  3. 	// 过滤条件, 例如 "%Severity% >= debug")
  4. 	Filter
  5. 	
  6. 	// 禁用日志, true 或者 flase)
  7. 	DisableLogging
  9. // 接收器配置
  10. Sinks
  11. 	// 输出位置，有五个选项，每个选项对应一系列相应选项
  12. 	Destination(Console/TextFile/Syslog/Debugger/SimpleEventLog)
  13. 	
  14. 	// 控制台对应的选项
  15. 	##Console
  16. 	// 是否宽字节 true 或者 flase
  17. 	Wide
  18. 	// 自动刷新 true 或者 flase
  19. 	AutoFlush
  20. 	// 过滤条件, 例如 "%Severity% >= debug")
  21. 	Filter
  22. 	// 异步方式 true 或者 flase
  23. 	Asynchronous
  24. 	// 格式化 例如 "[%TimeStamp%] [%Severity%]\n%MyScopes%\n\t:: %Message%"
  25. 	Format		
  26. 	
  27. 	// 文件对应的选项	
  28. 	##TextFile
  29. 	// 文件名 可以直接输入文件名也可以输出文件名的格式，例如test.log和"%Y-%m-%d_%N.log"
  30. 	FileName
  31. 	// 单个文件大小，超过此大小自动建立新文件 单位是字节
  32. 	RotationSize
  33. 	// 多久后自动建立新文件 单位是秒
  34. 	RotationInterval
  35. 	// 什么时候自动建立新文件 例如每个0点创建新文件就是："00:00:00"
  36. 	RotationTimePoint
  37. 	AutoFlush
  38. 	// 是否将记录追加到原有文件 true 或者 flase
  39. 	Append
  40. 	// 输出文件夹（有此选项后才能有下列选项）
  41. 	Target
  42. 		// 文件夹最大大小 单位是字节
  43. 		MaxSize
  44. 		// 文件夹最小预留空间 单位是字节
  45. 		MinFreeSpace
  46. 		// 扫描文件 true 或者 flase
  47. 		ScanForFiles(ALL/Matching)
  48. 	Filter
  49. 	Asychronous
  50. 	Format
  51. 	
  52. 	##Syslog
  53. 	LocalAddress
  54. 	TargetAddress
  55. 	Filter
  56. 	Asynchronous
  57. 	Format
  58. 		
  59. 	##Debugger
  60. 	Wide
  61. 	Filter
  62. 	Asynchronous
  63. 	Format
  64. 			
  65. 	##SimpleEventLog
  66. 	Wide
  67. 	LogName
  68. 	LogSource
  69. 	Registration
  70. 	Filter
  71. 	Asynchronous
  72. 	Format
[注意]Format的值不支持==、||、&&等运算符，取而代之的是=、or、and和not。

    上面的代码Format="[%TimeStamp%] [%Severity%]\n%MyScopes%\n\t:: %Message%"， 如果你想在配置文件里面使用%TimeStamp%等属性来格式化记录，那么就必须要在C++里面注册这个属性，并且要在Boost.Log的core里为这个属性注册一个格式工厂。如果你想像Filter="%Severity% >= trace"这样来过滤日志记录，你就得在Boost.Log的core里为这个属性注册一个过滤工厂。如果你想要自己增添选项这也是允许的，你需要在Boost.Log的core里注册一个接收器工厂，然后实现它。具体的方法就不详解了，在上面的源码中可以找到答案。

附件列表

     

    文章来自：http://www.cnblogs.com/zhangpanyi/p/4487277.html
    © 2021 jiaocheng.bubufx.com  联系我们
    ICP备案：鲁ICP备09046678号-3