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 변환 방법)

pom.xml 파일에 GroupDocs 저장소와 의존성을 추가합니다:

<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‑bit OS; 라이브러리는 Windows, Linux, macOS에서 실행됩니다.

Q: 매우 큰 DWG 파일(예: 500 MB)을 변환할 수 있습니까?
A: 예 – 충분한 힙(-Xmx8g)을 할당하고 배치 또는 스트리밍 처리를 사용하여 OOM 오류를 방지합니다.

Q: groupdocs conversion java가 다른 CAD 형식을 지원합니까?
A: 물론입니다; DWG 외에도 DXF, DGN 및 30가지 이상의 추가 형식을 처리합니다.

Q: 왜 빈 PDF만 나오나요?
A: 제공한 레이아웃 이름이 실제로 소스 파일에 존재하는지와 파일이 손상되지 않았는지 확인하십시오.

Q: 이 변환을 웹 서비스에 어떻게 노출할 수 있습니까?
A: Java 코드를 Spring Boot 또는 Jakarta EE 애플리케이션에 배포하고 DWG 업로드를 받아 변환을 실행한 뒤 PDF 스트림을 반환하는 REST 엔드포인트를 노출합니다.

리소스

마지막 업데이트: 2026-07-24
테스트 환경: GroupDocs.Conversion 25.2 for Java
작성자: GroupDocs

관련 튜토리얼