groupdocs conversion java：使用選擇性版面將 DWG 轉換為 PDF

如果您需要將 DWG 圖紙轉換為 PDF 但僅限於特定版面，您來對地方了。在本教學中，我們將逐步說明 groupdocs conversion java，展示如何設定 Maven、篩選版面，以及優化大型 CAD 檔案的效能。完成後，您只需幾行程式碼即可在任何 Java 應用程式中嵌入選擇性版面轉換。

快速解答

  • 主要的函式庫是什麼？ GroupDocs.Conversion for Java
  • 如何加入 Maven 支援？ Include the GroupDocs repository and dependency (see below)
  • 我可以只轉換特定版面嗎？ Yes – use CadLoadOptions.setLayoutNames
  • 需要哪個 Java 版本？ JDK 8 or newer
  • 是否需要授權？ A trial or purchased license is required for full features

什麼是 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);

實務應用

選擇性版面轉換在真實情境中表現卓越，例如：

  • 建築設計審查： 僅匯出正在討論的樓層平面圖。
  • 工程分析： 轉換特定截面以進行應力測試。
  • 文件存檔： 儲存簡潔的 PDF 以符合法規要求，可節省高達 70 % 的儲存空間。

大型 DWG 檔案的效能考量

  • 記憶體管理： 對於超過 200 MB 的檔案，使用 -Xmx4g 等 JVM 參數。
  • 批次處理： 將檔案分批（10–20 個）以維持記憶體使用穩定。
  • 串流轉換： 利用 ConversionHandler（新版提供）在不將整個檔案載入記憶體的情況下處理頁面。

常見問題與解決方案

  • 缺少版面： 版面名稱區分大小寫；在傳遞給 setLayoutNames 前，請先使用 CAD 檢視器確認。
  • 記憶體不足錯誤： 增加堆積大小或啟用串流轉換。
  • 授權錯誤： 確認授權檔案路徑為絕對路徑且與函式庫版本相符。

常見問答

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

相關教學