9.7. Consumers Consumers are classes that take a Log::Entry and produce a log output accordingly. eProsima Fast DDS provides three different log consumers that output log entries to different streams: StdoutConsumer: Outputs log entries to STDOU...-Go服务器开发

在这段文本中，主要介绍了eProsima Fast DDS提供的三种日志消费者（Consumers），这些消费者用于处理日志条目并将其输出到不同的流。以下是对每个消费者及其功能的详细解释：

9.7. Consumers

Consumers 是负责接收 Log::Entry 并按照规定格式生成日志输出的类。eProsima Fast DDS 提供了三种不同的日志消费者，它们分别将日志条目输出到不同的目标。

9.7.1. StdoutConsumer

功能: 将日志条目输出到标准输出（STDOUT）流。
默认设置: 如果CMake选项 LOG_CONSUMER_DEFAULT 设置为 STDOUT，则它是默认的日志模块。

使用示例:


std::unique_ptr<StdoutConsumer> stdout_consumer(new StdoutConsumer());
Log::RegisterConsumer(std::move(stdout_consumer));

在此代码中，创建一个 StdoutConsumer 实例并注册它以开始记录。

9.7.2. StdoutErrConsumer

功能: 使用一个 Log::Kind 阈值来过滤日志条目的输出。如果日志条目的严重程度（Kind）等于或高于给定阈值，则输出到标准错误（STDERR）；否则，输出到标准输出（STDOUT）。
默认设置: 如果CMake选项 LOG_CONSUMER_DEFAULT 设置为 AUTO、STDOUTERR 或未设置，则此消费者是默认和唯一的日志消费者。默认为警告级别 (Log::Kind::Warning)。
使用示例: “`cpp std::unique_ptr stdouterr_consumer(new StdoutErrConsumer()); stdouterr_consumer->stderr_threshold(Log::Kind::Error);

Log::RegisterConsumer(std::move(stdouterr_consumer));

  - 在这里，一个新的 `StdoutErrConsumer` 实例被创建，并且阈值被设置为只在出现错误时才将消息发送到 STDERR。

#### 9.7.3. FileConsumer
- **功能**: 提供将日志记录到文件中的能力。这对于需要持久化执行记录的应用程序非常有用。
- **行为选择**: 应用程序可以选择以“写入”或“附加”模式打开文件，具体取决于使用 `std::fstream::open()` 的定义。
- **使用示例**:
  ```cpp
  std::unique_ptr<FileConsumer> write_file_consumer(new FileConsumer("archive_1.log", false));
  std::unique_ptr<FileConsumer> append_file_consumer(new FileConsumer("archive_2.log", true));

  Log::RegisterConsumer(std::move(write_file_consumer));
  Log::RegisterConsumer(std::move(append_file_consumer));