groupdocs conversion java：使用选择性布局将 DWG 转换为 PDF

如果您需要将 DWG 图纸转换为 PDF 但仅针对特定布局，您来对地方了。在本教程中，我们将演示 groupdocs conversion java，展示如何配置 Maven、过滤布局以及针对大型 CAD 文件优化性能。完成后，您只需几行代码即可在任何 Java 应用程序中嵌入选择性布局转换。

快速答案

  • 主要库是什么？ GroupDocs.Conversion for Java
  • 如何添加 Maven 支持？ 在下面的示例中包含 GroupDocs 仓库和依赖项 (see below)
  • 我可以仅转换特定布局吗？ 是的 – 使用 CadLoadOptions.setLayoutNames
  • 需要哪个 Java 版本？ JDK 8 或更高版本
  • 我需要许可证吗？ 完整功能需要试用版或购买的许可证

什么是 groupdocs conversion java？

GroupDocs.Conversion for Java 是一个高性能库，可将超过 50+ 种文档和 CAD 格式（包括 DWG、DXF 和 DGN）转换为 PDF、HTML 和图像文件，同时保留图层、字体和几何信息。它为开发者提供了简洁的 API，支持 Windows 和 Linux 环境，并提供从试用版到企业版的多种许可证选项。

为什么使用选择性布局转换？

选择性转换可将多布局 DWG 文件的输出大小降低最多 80 %，将处理时间缩短约 60 %，并确保相关方仅看到所需的图纸。这对于处理 200 页总体规划的建筑公司尤为重要，因为在客户审阅时只需少量楼层平面图。

前提条件

  • Java Development Kit (JDK)： 8 +
  • Maven： 用于依赖管理
  • IDE： IntelliJ IDEA、Eclipse 或任何兼容 Java 的编辑器
  • 基本的 Java 知识

如何使用 groupdocs conversion java 执行选择性布局转换？

加载源 DWG，指定所需布局，然后调用转换器——全部通过四个简明步骤完成。下面的代码片段（占位符）展示了每个阶段；请将占位符替换为官方文档中的实际 Java 代码。此方法确保仅处理所需布局，最小化内存使用并加快转换速度。按照以下步骤操作，在相应位置插入实际的文件路径和布局名称。

步骤 1：Maven 配置（如何使用 Maven 转换 CAD）

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

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

步骤 2：许可证初始化

使用您的许可证文件初始化库，以解锁包括布局过滤在内的所有功能：

// Load the license to unlock full features
License license = new License();
license.setLicense("path/to/license.lic");

步骤 3：指定文件路径和布局名称

定义输入 DWG 路径、输出 PDF 路径以及要转换的确切布局名称：

String sourceFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.dwg";
String convertedFile = "YOUR_OUTPUT_DIRECTORY/ConvertCadAndSpecifyLayouts.pdf";

// Specify desired layout names
CadLoadOptions loadOptions = new CadLoadOptions();
loadOptions.setLayoutNames(new String[] { "Layout1", "Layout3" });

定义锚点： CadLoadOptions 是用于控制 CAD 文件加载方式的类，包括要包含的布局。

步骤 4：创建 Converter 实例

Converter 类负责协调转换过程。它接收源文件以及您刚刚配置的加载选项：

Converter converter = new Converter(sourceFilePath, () -> loadOptions);

定义锚点： Converter 是 GroupDocs.Conversion 的核心引擎，接受源文件并生成所需格式的输出。

步骤 5：设置 PDF 转换选项

通过 PdfConvertOptions 调整 DPI、页面尺寸和字体嵌入，以满足您的最终 PDF 需求：

PdfConvertOptions convertOptions = new PdfConvertOptions();

步骤 6：执行转换

运行转换。生成的 PDF 将仅包含您指定的布局：

converter.convert(convertedFile, convertOptions);

实际应用

选择性布局转换在真实场景中表现突出，例如：

  • Architectural design reviews： 仅导出正在讨论的楼层平面图。
  • Engineering analysis： 将特定截面转换用于应力测试。
  • Document archiving： 存储简洁的 PDF 以满足监管合规，可节省高达 70 % 的存储空间。

大型 DWG 文件的性能考虑

  • Memory Management： 对超过 200 MB 的文件使用如 -Xmx4g 的 JVM 参数。
  • Batch Processing： 将文件分批（10–20 个）处理，以保持内存使用稳定。
  • Streamed Conversion： 利用 ConversionHandler（在新版本中可用）在不将整个文件加载到内存的情况下处理页面。

常见问题及解决方案

  • Missing Layouts： 布局名称区分大小写；在传递给 setLayoutNames 之前请使用 CAD 查看器验证。
  • Out‑Of‑Memory Errors： 增加堆大小或启用流式转换。
  • License Errors： 确保许可证文件路径为绝对路径且与库版本匹配。

常见问答

Q：groupdocs conversion java 的系统要求是什么？
A：JDK 8+、Maven，以及 64 位操作系统；该库可在 Windows、Linux 和 macOS 上运行。

Q：我可以转换非常大的 DWG 文件（例如 500 MB）吗？
A：可以 – 分配足够的堆内存 (-Xmx8g) 并使用批处理或流式处理以避免 OOM 错误。

Q：groupdocs conversion java 支持其他 CAD 格式吗？
A：当然；它除了 DWG 之外，还支持 DXF、DGN 以及超过 30 种其他格式。

Q：为什么我只得到空白的 PDF？
A：检查您提供的布局名称是否确实存在于源文件中，并确保文件未损坏。

Q：如何在 Web 服务中公开此转换功能？
A：将 Java 代码部署在 Spring Boot 或 Jakarta EE 应用中，提供接受 DWG 上传、执行转换并返回 PDF 流的 REST 接口。

资源

最后更新： 2026-07-24
已测试版本： GroupDocs.Conversion 25.2 for Java
作者： GroupDocs

相关教程