groupdocs conversion java: 選択的レイアウトでDWGをPDFに変換

If you need to turn a DWG drawing into a PDF but only for certain layouts, you’re in the right place. In this tutorial we’ll walk through groupdocs conversion java, showing you how to configure Maven, filter layouts, and optimise performance for large CAD files. By the end you’ll be able to embed selective‑layout conversion into any Java application with just a few lines of code.

クイック回答

  • 主要なライブラリは何ですか？ GroupDocs.Conversion for Java
  • Maven のサポートはどう追加しますか？ GroupDocs リポジトリと依存関係を含めます（下記参照）
  • 特定のレイアウトだけを変換できますか？ はい – CadLoadOptions.setLayoutNames を使用
  • 必要な Java バージョンは？ JDK 8 以上
  • ライセンスは必要ですか？ フル機能を使用するにはトライアルまたは購入ライセンスが必要

groupdocs conversion java とは？

GroupDocs.Conversion for Java は、DWG、DXF、DGN など 50+ のドキュメントおよび CAD フォーマットを 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 を読み込み、変換したいレイアウトを指定し、コンバータを呼び出すだけの 4 ステップです。以下のコードスニペット（プレースホルダー）は各段階を示しています。プレースホルダーを公式ドキュメントの実際の Java コードに置き換えてください。このアプローチにより、必要なレイアウトのみが処理され、メモリ使用量が最小化され、変換が高速化されます。下記手順に従い、実際のファイルパスとレイアウト名を適宜挿入してください。

ステップ 1: Maven 設定 (Maven で CAD を変換する方法)

Add the GroupDocs repository and dependency to your pom.xml file:

<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: ライセンス初期化

Initialize the library with your license file so that all features, including layout filtering, are unlocked:

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

ステップ 3: ファイルパスとレイアウト名の指定

Define the input DWG path, output PDF path, and the exact layout names you wish to convert:

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" });

Definition anchor: CadLoadOptions is the class that lets you control how a CAD file is loaded, including which layouts to include.

ステップ 4: コンバータインスタンスの作成

The Converter class orchestrates the conversion process. It receives the source file and the load options you just configured:

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

Definition anchor: Converter is GroupDocs.Conversion’s core engine that accepts a source file and produces output in the desired format.

ステップ 5: PDF 変換オプションの設定

Adjust DPI, page size, and font embedding through PdfConvertOptions to tailor the final PDF to your needs:

PdfConvertOptions convertOptions = new PdfConvertOptions();

ステップ 6: 変換の実行

Run the conversion. The resulting PDF will contain only the layouts you specified:

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 ビット OS が必要です。Windows、Linux、macOS で動作します。

Q: 非常に大きな DWG ファイル（例: 500 MB）を変換できますか？
A: はい – 十分なヒープ（例: -Xmx8g）を割り当て、バッチまたはストリーミング処理を使用すれば OOM エラーを回避できます。

Q: groupdocs conversion java は他の CAD フォーマットもサポートしていますか？
A: もちろんです。DXF、DGN、その他 30 以上のフォーマットを DWG 以外にも取り扱えます。

Q: なぜ空白の PDF が生成されるだけなのですか？
A: 指定したレイアウト名がソースファイルに存在するか、ファイルが破損していないかを確認してください。

Q: この変換機能を Web サービスとして公開するには？
A: Java コードを Spring Boot または Jakarta EE アプリケーションにデプロイし、DWG アップロードを受け取り変換を実行、PDF ストリームを返す REST エンドポイントを作成します。

リソース

最終更新日: 2026-07-24
テスト環境: GroupDocs.Conversion 25.2 for Java
作者: GroupDocs

関連チュートリアル