to keep ** around text, but translate inside.

Also bullet lists.

Let’s write.

Be careful with “use console logger” phrase; keep as is? It’s a technical term, maybe keep “use console logger”. Keep as is.

Also “Maven configuration” etc.

Now produce final content.

使用 GroupDocs.Search Java 日志记录器限制日志文件大小

在本指南中，您将 创建自定义 logger 实现，并学习在使用 GroupDocs.Search for Java 时如何 限制日志文件大小。控制日志增长对于大规模文档索引至关重要，内置的 logger 允许您 设置最大日志大小、滚动日志文件，或切换到 use console logger 以获得即时反馈。让我们从 Maven 配置到运行搜索查询，完整演示如何在启用 logger 的情况下 添加文档索引。

快速回答

“限制日志文件大小” 是什么意思？ 它限制日志文件的最大尺寸，防止磁盘上出现不受控制的增长。
哪个 logger 可以限制日志文件大小？ 内置的 FileLogger 接受一个最大尺寸参数。
如何使用 console logger java？ 实例化 ConsoleLogger 并在 IndexSettings 上设置它。
使用 GroupDocs.Search 是否需要许可证？ 试用版可用于评估；生产环境需要商业许可证。
第一步是什么？ 将 GroupDocs.Search 依赖添加到您的 Maven 项目中。

什么是限制日志文件大小？

限制日志文件大小意味着配置 logger，使得当文件达到预定义阈值（例如 4 MB）时，停止增长或进行滚动。这可以让您的应用程序的存储占用保持可预测，并避免性能下降。

为什么在 GroupDocs.Search 中使用文件和自定义 logger？

可审计性： 保留索引和搜索事件的永久记录。
调试： 通过查看简洁的日志快速定位问题。
灵活性： 在持久化文件日志和即时控制台输出（use console logger）之间进行选择。

前置条件

GroupDocs.Search for Java ≥ 25.4。
JDK 8 或更高版本，IDE（IntelliJ IDEA、Eclipse 等）。
基础的 Java 与 Maven 知识。

设置 GroupDocs.Search for Java

使用以下任一方式将库添加到项目中。

Maven 设置：

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/search/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-search</artifactId>
        <version>25.4</version>
    </dependency>
</dependencies>

直接下载：
从官方网站下载最新 JAR： GroupDocs.Search for Java releases。

许可证获取

通过 licensing page 获取试用或购买许可证。

如何为 GroupDocs.Search 创建自定义 logger

GroupDocs.Search 允许您插入任何实现 ILogger 接口的类。通过扩展 FileLogger 或 ConsoleLogger，您可以添加额外行为——例如滚动日志文件或将消息转发到远程监控服务。这种灵活性使得许多团队 创建自定义 logger 解决方案以满足其运营需求。

如何使用 File Logger 限制日志文件大小

下面是一步步指南，展示如何 配置文件 logger 使日志文件永不超过您指定的大小。

1️⃣ 导入必要的包

import com.groupdocs.search.*;
import com.groupdocs.search.common.FileLogger;

2️⃣ 使用 File Logger 设置索引设置

String indexFolder = "YOUR_DOCUMENT_DIRECTORY/IndexFolder";
String documentsFolder = Utils.DocumentsPath; // Directory containing documents
String query = "Lorem";
String logPath = "YOUR_OUTPUT_DIRECTORY/Log.txt";

IndexSettings settings = new IndexSettings();
settings.setLogger(new FileLogger(logPath, 4.0)); // 4 MB max size → limits log file size

3️⃣ 创建或加载索引

Index index = new Index(indexFolder, settings);

4️⃣ 向索引添加文档

index.add(documentsFolder);

5️⃣ 执行搜索查询

SearchResult result = index.search(query);

关键点： FileLogger 构造函数的第二个参数 (4.0) 定义了 set max log size（以兆字节为单位），直接满足 limit log file size 的需求。

如何使用 console logger java

如果您更喜欢在终端中获得即时反馈，只需将文件 logger 替换为控制台 logger。

1️⃣ 导入 Console Logger

import com.groupdocs.search.*;
import com.groupdocs.search.common.ConsoleLogger;

2️⃣ 使用 Console Logger 设置索引设置

String indexFolder = "YOUR_DOCUMENT_DIRECTORY/CustomLoggerIndexFolder";
String documentsFolder = Utils.DocumentsPath; // Directory containing documents
String query = "Lorem";

IndexSettings settings = new IndexSettings();
settings.setLogger(new ConsoleLogger()); // use console logger java

3️⃣ 创建或加载索引

Index index = new Index(indexFolder, settings);

4️⃣ 添加文档并执行搜索

index.add(documentsFolder);
SearchResult result = index.search(query);

提示： 控制台 logger 在开发期间非常理想，因为它会即时打印每条日志，帮助您验证索引和搜索是否按预期工作。

实际应用

文档管理系统： 为每个被索引的文档保留审计轨迹。
企业搜索引擎： 实时监控查询性能和错误率。
法律与合规软件： 记录搜索词以满足监管报告要求。

性能考虑

日志大小： 通过 set max log size，避免过度磁盘使用导致应用变慢。
异步日志记录： 若需更高吞吐量，可考虑将 logger 包装在异步队列中（本指南范围之外）。
内存管理： 当 Index 对象不再需要时及时释放，以保持 JVM 占用低。

常见问题与解决方案

日志路径不可访问： 确认目录存在且应用拥有写入权限。
logger 未触发： 确保在创建 Index 对象之前调用 settings.setLogger(...)。
控制台输出缺失： 确认您在能够显示 System.out 的终端中运行应用。

常见问答

问：FileLogger 的第二个参数控制什么？
答：它设置日志文件的最大大小（单位为兆字节），从而实现 set max log size。

问：我可以同时使用文件和控制台 logger 吗？
答：可以，通过创建自定义 logger 将消息转发到两个目标。

问：如何在首次创建后向索引添加文档？
答：随时调用 index.add(pathToNewDocs)；logger 会记录该操作。

问：ConsoleLogger 是线程安全的吗？
答：它直接写入 System.out，JVM 已对其进行同步，因而在大多数用例下是安全的。

问：限制日志文件大小会影响存储的信息量吗？
答：达到大小限制后，新条目可能被丢弃或根据 logger 实现 roll over log file，具体取决于实现方式。

资源

最后更新： 2026-02-24
测试环境： GroupDocs.Search for Java 25.4
作者： GroupDocs