如何使用 GroupDocs 检索 Java 中受支持的文件格式

如果您想了解 如何使用 GroupDocs 来发现您的应用程序可以处理的确切文件类型，您来对地方了。在本教程中，我们将演示如何使用 GroupDocs.Search for Java 检索受支持格式的完整列表，这样您就可以自信地在 UI 中显示或验证文件扩展名。完成后，您将拥有一个可重用的代码片段，返回所有受支持的扩展名，并提供在高性能场景下缓存结果的技巧。

快速答案

  • 此功能的作用是什么？ 返回 GroupDocs.Search 可以索引的所有文件扩展名。
  • 它有什么用？ 让您能够动态地向用户告知支持的上传类型，避免不受支持的文件错误。
  • 我需要许可证吗？ 免费试用可用于测试；生产环境需要完整许可证。
  • 需要哪个 Java 版本？ Java 8 或更高版本。
  • 是否需要额外配置？ 不需要——只需添加 Maven 依赖并调用 API。

什么是 GroupDocs.Search？

GroupDocs.Search 是一个 Java 库，提供跨多种文档格式的快速全文搜索。它抽象了解析 PDF、Word 文件、电子表格以及许多其他类型的复杂性，提供了用于索引和查询的简洁 API。

为什么检索受支持的文件格式？

检索受支持的文件格式为您提供了关于库能够索引的内容的权威信息。它使您能够以编程方式生成 UI 元素、验证规则和文档，而无需硬编码值，确保库的任何未来更新都会自动反映在您的应用程序中。

GroupDocs.Search 支持 超过 120 种不同的文件扩展名，涵盖从常见办公文件到小众图像和归档格式的所有类型。了解此列表可让您：

  • 构建仅允许受支持文件的动态上传小部件。
  • 为最终用户生成准确的文档。
  • 减少因尝试索引不受支持格式而导致的运行时错误。
  • 通过导出列表为 CSV，快速审计合规性要求。

前提条件

  • Java Development Kit (JDK) 8+
  • Maven 用于依赖管理
  • IDE（如 IntelliJ IDEA 或 Eclipse）

熟悉基本的 Java 和 Maven 概念将使步骤更顺畅。

为 Java 设置 GroupDocs.Search

Maven 设置

将 GroupDocs 仓库和依赖添加到您的 pom.xml：

<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>

直接下载

如果您愿意，也可以直接从 GroupDocs.Search for Java releases 下载最新版本。

许可证获取步骤

  • 免费试用 – 探索核心功能。
  • 临时许可证 – 在无功能限制的情况下进行测试。
  • 完整许可证 – 解锁生产就绪功能。

基本初始化和设置

添加依赖后，您可以创建索引并添加文档：

import com.groupdocs.search.*;

public class InitializeGroupDocs {
    public static void main(String[] args) {
        // Create an index in the specified folder
        Index index = new Index("path/to/index/folder");
        
        // Add documents to the index from a folder
        index.add("path/to/documents/folder");
    }
}

如何使用 GroupDocs 获取 Java 文件扩展名

仅用三行代码加载受支持的扩展名。此方法轻量级，运行时间为毫秒级，可在应用启动时或按需调用。

检索受支持的文件格式

以下步骤展示如何获取 GroupDocs.Search 支持的完整文件扩展名列表。

步骤 1 – 导入所需类

FileType 类提供每种受支持文件格式的元数据，包括其扩展名和友好的描述。

import com.groupdocs.search.results.FileType;

步骤 2 – 获取受支持类型的集合

调用 FileType.getSupportedFileTypes() 将返回一个只读集合，包含 GroupDocs.Search 能够索引的所有格式。

Iterable<FileType> supportedFileTypes = FileType.getSupportedFileTypes();

步骤 3 – 遍历并打印每种格式

遍历该集合，输出扩展名及其描述。您可以将结果存储在 List<String> 中以供后续重用。

for (FileType fileType : supportedFileTypes) {
    System.out.println(fileType.getExtension() + " - " + fileType.getDescription());
}

运行此代码片段会打印类似 pdf - Portable Document Format 的行，为 UI 下拉列表或验证逻辑提供即用的列表。

故障排除技巧

  • Class Not Found – 验证 Maven 依赖已正确解析。
  • Path Issues – 确保索引文件夹路径存在且可写。

实际应用

  1. 文档管理系统 – 动态列出受支持的上传文件。
  2. 基于 Web 的文件上传 – 使用检索到的列表在客户端验证文件类型。
  3. 备份解决方案 – 在归档前过滤掉不受支持的文件。

性能考虑因素

  • 将检索到的列表存储在内存中，以便频繁访问；该调用本身轻量（在典型服务器上低于 10 ms）。
  • 保持 GroupDocs.Search 库为最新，以获得性能提升——每个主要版本大约新增 5 种格式，并将索引延迟降低最多 15 %。

常见问题及解决方案

问题原因解决方案
FileType 类缺失未添加依赖添加依赖后重新运行 mvn clean install
未打印输出IDE 中抑制了 System.out检查控制台配置或在命令行运行

常见问答

问：什么是 GroupDocs.Search？
答：它是一个 Java 库，可在许多文档格式之间实现全文搜索，无需单独的解析器。

问：如何更新库版本？
答：修改 pom.xml 中的 <version> 标签，然后运行 mvn clean install。

问：我可以在非 Java 项目中使用此功能吗？
答：所示的 API 是针对 Java 的，但 GroupDocs 为 .NET、Python 等平台提供了类似的功能。

问：如果缺少所需的文件类型怎么办？
答：联系 GroupDocs 支持；他们会在后续版本中经常添加新格式。

问：生产环境是否需要商业许可证？
答：是的，完整许可证消除试用限制并授予商业使用权。

资源

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

相关教程