使用 GroupDocs.Viewer for Java 将 RAR 文件渲染为各种格式

使用 GroupDocs.Viewer for Java 将 RAR 档案转换为 HTML、JPG、PNG 和 PDF 等易于访问的格式，释放其潜力。本教程将指导您完成每个步骤，实现无缝的文档管理和演示。

您将学到什么

使用 GroupDocs.Viewer for Java 将 RAR 文件呈现为多种格式。
将 RAR 转换为 HTML、JPG、PNG 和 PDF 的分步代码示例。
从 RAR 档案中检索视图信息。
呈现 RAR 文件中的特定文件夹。

让我们开始吧！

先决条件

在开始之前，请确保您具备以下条件：

Java 开发工具包 (JDK)：需要版本 8 或更高版本。
Maven：本教程使用 Maven 进行依赖管理。
GroupDocs.Viewer Java 库：我们将使用 25.2 版本。

环境设置

确保您的开发环境已安装 JDK 和 Maven。
熟悉基本的 Java 编程概念将帮助您更轻松地跟进。

为 Java 设置 GroupDocs.Viewer

要将 GroupDocs.Viewer 集成到您的项目中，请在您的 pom.xml 文件：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

许可证获取

免费试用：从下载免费试用版 GroupDocs 网站.
临时执照：获取扩展功能的临时许可证 GroupDocs 许可证页面.
购买：如需长期使用，请通过 GroupDocs 购买页面.

基本初始化

设置好环境和依赖项后，初始化 GroupDocs.Viewer，如下所示：

import com.groupdocs.viewer.Viewer;

public class ViewerInitialization {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("path/to/your/file.rar")) {
            // 您的渲染代码在这里
        }
    }
}

实施指南

我们将探讨如何将 RAR 文件转换为不同的格式，每种格式都有自己的一组配置。

将 RAR 渲染为 HTML

概述：将 RAR 文件转换为 HTML 文档以供在网络上查看。

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import java.nio.file.Path;
import java.nio.file.Paths;

public class RenderRarToHtml {
    public static void main(String[] args) {
        Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY", "RenderingRar");
        Path pageFilePathFormat = outputDirectory.resolve("RAR_result_{0}.html");

        try (Viewer viewer = new Viewer(Paths.get("YOUR_DOCUMENT_DIRECTORY", "SAMPLE_RAR_WITH_FOLDERS"))) {
            HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
            viewer.view(options); // 将 RAR 文件渲染为 HTML 格式
        }
    }
}

解释：这 HtmlViewOptions 类与嵌入式资源一起使用，允许完整的网页渲染，包括 CSS 和图像。

将 RAR 渲染为 JPG

概述：将 RAR 文件转换为 JPEG 图像，非常适合缩略图预览。

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;

public class RenderRarToJpg {
    public static void main(String[] args) {
        Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY", "RenderingRar");
        Path pageFilePathFormat = outputDirectory.resolve("RAR_result_{0}.jpg");

        try (Viewer viewer = new Viewer(Paths.get("YOUR_DOCUMENT_DIRECTORY", "SAMPLE_RAR_WITH_FOLDERS"))) {
            JpgViewOptions options = new JpgViewOptions(pageFilePathFormat);
            viewer.view(options); // 将 RAR 文件转换为 JPG 格式
        }
    }
}

解释： JpgViewOptions 指定输出路径并处理图像渲染。

将 RAR 渲染为 PNG

概述：将 RAR 档案转换为 PNG 图像以获得高质量预览。

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;

public class RenderRarToPng {
    public static void main(String[] args) {
        Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY", "RenderingRar");
        Path pageFilePathFormat = outputDirectory.resolve("RAR_result_{0}.png");

        try (Viewer viewer = new Viewer(Paths.get("YOUR_DOCUMENT_DIRECTORY", "SAMPLE_RAR_WITH_FOLDERS"))) {
            PngViewOptions options = new PngViewOptions(pageFilePathFormat);
            viewer.view(options); // 将 RAR 文件渲染为 PNG 格式
        }
    }
}

解释：类似于 JPG， PngViewOptions 用于将 RAR 的每一页渲染为 PNG 图像。

将 RAR 渲染为 PDF

概述：从 RAR 文件生成 PDF 文档，以便于共享和打印。

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;

public class RenderRarToPdf {
    public static void main(String[] args) {
        Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY", "RenderingRar");
        Path pageFilePathFormat = outputDirectory.resolve("RAR_result.pdf");

        try (Viewer viewer = new Viewer(Paths.get("YOUR_DOCUMENT_DIRECTORY", "SAMPLE_RAR_WITH_FOLDERS"))) {
            PdfViewOptions options = new PdfViewOptions(pageFilePathFormat);
            viewer.view(options); // 将 RAR 文件转换为 PDF 格式
        }
    }
}

解释： PdfViewOptions 配置PDF文档的输出路径。

获取 RAR 的视图信息

概述：从 RAR 档案中检索元数据和结构信息。

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.ArchiveViewInfo;

public class GetViewInfoForRar {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer(Paths.get("YOUR_DOCUMENT_DIRECTORY", "SAMPLE_RAR_WITH_FOLDERS"))) {
            ViewInfo info = viewer.getViewInfo(ViewInfoOptions.forHtmlView());
            System.out.println("File type: " + info.getFileType());
            System.out.println("Pages count: " + info.getPages().size());

            readFolders(viewer, "");
        }
    }

    private static void readFolders(Viewer viewer, String folder) {
        ViewInfoOptions options = ViewInfoOptions.forHtmlView();
        options.getArchiveOptions().setFolder(folder);

        ArchiveViewInfo viewInfo = (ArchiveViewInfo) viewer.getViewInfo(options);
        for (String subFolder : viewInfo.getFolders()) {
            System.out.println(" - " + subFolder);
            readFolders(viewer, subFolder);
        }
    }
}

解释：此代码检索并打印 RAR 档案中的文件类型和页数。

渲染 RAR 压缩包的特定文件夹

概述：专注于将 RAR 文件中的特定文件夹呈现为 HTML 格式。

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

public class RenderSpecificArchiveFolder {
    public static void main(String[] args) {
        Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY", "RenderSpecificArchiveFolder");
        Path pageFilePathFormat = outputDirectory.resolve("archive_folder_page_{0}.html");

        try (Viewer viewer = new Viewer(Paths.get("YOUR_DOCUMENT_DIRECTORY", "SAMPLE_RAR_WITH_FOLDERS"))) {
            HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
            options.getArchiveOptions().setFolder("TargetFolderName"); // 指定要渲染的文件夹
            viewer.view(options); // 将指定文件夹内容呈现为 HTML
        }
    }
}

解释：使用 HtmlViewOptions 使用特定的文件夹设置来定位和呈现 RAR 存档中的各个文件夹。

通过遵循这些步骤，您可以有效地使用 GroupDocs.Viewer for Java 来管理您的 RAR 文件并将其转换为各种格式。

结论

本教程将帮助您轻松使用 GroupDocs.Viewer for Java 将 RAR 档案转换为 HTML、JPG、PNG 和 PDF 等易于访问的格式。您将逐步学习实现细节，包括渲染特定文件夹和检索档案信息，从而增强您的文档管理能力。无论是用于 Web 查看、预览还是共享，这些技巧都能简化您在 Java 应用程序中处理 RAR 文件的方式。

常见问题解答

我可以使用 GroupDocs.Viewer for Java 转换受密码保护的 RAR 文件吗？

是的，但是您需要在选项中提供密码才能解锁和查看受保护的档案。

是否可以仅呈现 RAR 中的特定页面或文件夹？

当然，您可以使用专用选项指定要呈现的文件夹或页面，例如 setFolder() 在渲染设置中。

GroupDocs.Viewer 支持哪些 RAR 文件输出格式？

它支持 HTML、JPG、PNG 和 PDF 格式，提供灵活的查看和共享选项。

我需要许可证才能使用 GroupDocs.Viewer for Java 吗？

可以免费试用；为了获得完整功能和长期使用，建议购买许可证或获取临时许可证。

我可以在 Java 应用程序中自动执行 RAR 转换吗？

是的，您可以将提供的代码示例嵌入到您的 Java 项目中，以无缝地实现批量转换的自动化。