많은 기업 및 SaaS 애플리케이션에서 설계를 렌더링, 공유 또는 보관해야 할 때, CAD 도면을 PDF로 자동 변환하는 것이 필수적입니다. Aspose.CAD Cloud SDK for Java는 Java 개발자를 위해 이 작업을 간소화하는 강력한 REST‑기반 라이브러리를 제공합니다. 이 가이드에서는 SDK 설정 방법, 주요 기능 탐색, 성능 옵션 구성 및 Java 코드와 cURL 명령을 모두 사용하여 전체 DWT를 PDF로 변환하는 과정을 살펴봅니다.

Java에서 설치 및 설정

이 섹션에서는 코드를 작성하기 전에 필요한 모든 내용을 다룹니다.

  • System Requirements: Java 8 이상, Maven 3.5+, API 호출을 위한 인터넷 연결.
  • Download: 최신 라이브러리를 이 페이지에서 가져옵니다.
  • Maven 종속성
<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-cad-cloud</artifactId>
    <version>23.12</version>
</dependency>
  • 설치 명령
mvn install com.aspose:aspose-cad-cloud

REST를 사용한 Java에서 DWT를 PDF로 변환

REST 엔드포인트 POST /cad/convert는 DWT 파일을 받아 PDF 문서를 반환합니다. 요청 본문에는 원본 파일 이름, 원하는 출력 형식(PDF) 및 래스터화 DPI와 레이어 처리와 같은 선택적 변환 설정이 포함됩니다. API는 파일을 클라우드에서 처리하므로 무거운 로컬 렌더링 엔진이 필요하지 않습니다.

Aspose.CAD Cloud SDK for Java의 주요 기능

  • 광범위한 CAD 형식 지원: DWT, DWG, DXF, DWF, 및 기타 많은 형식을 처리합니다.
  • 고품질 PDF 출력: 선 두께, 색상 및 레이어를 보존합니다.
  • 스트리밍 지원: 전체 파일을 메모리에 로드하지 않고 대용량 파일을 업로드할 수 있습니다.
  • 맞춤형 렌더링 옵션: DPI, 페이지 크기 및 벡터와 래스터 출력 방식을 제어합니다.
  • 보안 클라우드 처리: 모든 데이터가 HTTPS와 OAuth 2.0 인증을 통해 전송됩니다.

Aspose.CAD Cloud SDK 최적 성능을 위한 구성

CadConversionOptions 객체를 조정하여 변환을 미세 조정합니다:

  • setDpi(int dpi) - 높은 DPI는 세부 사항을 개선하지만 파일 크기가 증가합니다.
  • setPageWidth(int width) / setPageHeight(int height) - 명시적인 페이지 크기를 정의합니다.
  • setLayers(String[] layers) - 선택된 레이어만 변환하여 처리 시간을 줄입니다.

이러한 설정은 API 참조에 문서화되어 있습니다.

일반적인 변환 오류 문제 해결

오류 가능한 원인 해결 방법
401 Unauthorized 잘못되었거나 만료된 액세스 토큰 클라이언트 자격 증명을 사용하여 토큰을 재생성합니다.
413 Payload Too Large 파일이 100 MB 제한을 초과함 업로드하기 전에 도면을 분할하거나 압축합니다.
500 Internal Server Error DWT 파일에 지원되지 않는 엔터티 변환 전에 복잡한 엔터티를 제거하거나 도면을 단순화합니다.

Java REST API를 사용하여 DWT 파일을 PDF 형식으로 변환하는 단계

  1. API 클라이언트 생성: CadApi를 클라이언트 ID와 비밀 키로 초기화합니다.
  2. DWT 파일 업로드: uploadFile을 사용하여 파일을 클라우드 스토리지에 스트리밍합니다.
  3. 변환 옵션 설정: DPI 및 페이지 크기를 위해 CadConversionOptions를 구성합니다.
  4. convert 엔드포인트 호출: 소스 파일 이름과 대상 형식으로 "PDF"를 지정하여 convertDocument를 호출합니다.
  5. PDF 다운로드: 출력 파일 스트림을 가져와 로컬에 저장합니다.

자세한 클래스 정보는 CadApi 참조 페이지를 참조하십시오.

REST를 사용한 DWT 파일을 PDF로 변환하기 위한 Java 구현 - 전체 코드 예제

다음 예제는 인증, 파일 업로드, 변환 및 다운로드를 포함한 전체 엔드‑투‑엔드 변환을 보여줍니다.

참고: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에서 사용하기 전에 파일 경로(input.dwt, output.pdf 등)를 실제 파일 위치에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인한 뒤 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.

cURL을 사용한 REST API를 통한 원격 CAD 파일 PDF 변환

동일한 변환은 간단한 cURL 명령으로 수행할 수 있으며, 빠른 테스트나 Java가 아닌 서비스와의 통합에 유용합니다.

  1. 액세스 토큰 얻기
curl -X POST "https://api.aspose.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. DWT 파일 업로드
curl -X PUT "https://api.aspose.cloud/v3.0/storage/file/input.dwt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@input.dwt"
  1. PDF로 변환 요청
curl -X POST "https://api.aspose.cloud/v3.0/cad/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "inputPath": "input.dwt",
           "outputPath": "output.pdf",
           "outputFormat": "PDF",
           "options": {
               "dpi": 300,
               "pageWidth": 2100,
               "pageHeight": 2970
           }
         }'
  1. 변환된 PDF 다운로드
curl -X GET "https://api.aspose.cloud/v3.0/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

요청 페이로드에 대한 자세한 내용은 공식 API 문서를 참조하십시오.

결론

REST를 사용하여 Java에서 DWT를 PDF로 변환하는 작업은 Aspose.CAD Cloud SDK for Java를 통해 간단해집니다. SDK는 인증, 파일 스트리밍 및 고품질 렌더링을 처리하며, REST API를 사용하면 변환 기능을 Java 기반 백엔드 또는 마이크로서비스에 통합할 수 있습니다. 프로덕션 사용을 위해 유효한 라이선스를 적용하는 것을 잊지 마세요; 전체 라이선스를 구매하거나 임시 라이선스 페이지에서 임시 라이선스를 얻을 수 있습니다. 제공된 단계, 코드 및 cURL 예제를 통해 엔터프라이즈 또는 SaaS 솔루션에 신뢰할 수 있는 CAD‑to‑PDF 변환을 추가할 준비가 되었습니다.

FAQ

PDF 출력에 대한 사용자 지정 페이지 크기를 어떻게 지정합니까?
CadConversionOptions 객체에서 setPageWidthsetPageHeight 메서드를 사용하십시오. 치수는 포인트 단위로 표시됩니다(1 pt = 1/72 인치). 전체 옵션 목록은 API reference를 참조하십시오.

변환이 500 오류를 반환하면 어떻게 해야 하나요?
500 오류는 일반적으로 원본 DWT 파일에 지원되지 않는 엔터티가 있음을 나타냅니다. 복잡한 해치 패턴이나 3D 객체를 제거하여 도면을 단순화하거나, 업로드하기 전에 도면을 이전 DWG 버전으로 내보내세요. 공식 문서에서는 지원되는 기능에 대한 안내를 제공합니다.

프라이빗 클라우드 스토리지에 저장된 DWT 파일을 변환할 수 있나요?
예. 파일을 uploadFile 메서드 또는 해당 cURL 명령을 사용하여 Aspose Cloud 스토리지에 업로드한 다음, 변환 요청에서 스토리지 경로를 참조하십시오. 인증은 동일한 OAuth 2.0 토큰으로 처리됩니다.

출력을 디스크에 쓰지 않고 DWT를 PDF로 변환하는 방법이 있나요?
SDK와 REST API 모두 PDF를 스트림(Java의 InputStream)으로 반환할 수 있습니다. 이 스트림을 다른 서비스에 직접 파이프하거나 서버에 저장하지 않고 클라이언트에 다시 보낼 수 있습니다.

자세히 보기