Java 애플리케이션에서 인쇄 가능하거나 보관용 문서를 생성해야 할 때 DOC 파일을 PDF 로 변환하는 경우가 자주 발생합니다. Aspose.HTML Cloud SDK for Java는 이 작업을 간소화하는 강력한 클라우드 기반 라이브러리를 제공합니다. 이 가이드에서는 SDK를 설정하는 방법, 변환 코드를 작성하는 방법, 그리고 cURL 명령을 사용하여 동일한 작업을 수행하는 방법을 배워 Java에서 DOC를 PDF로 자동 변환을 효율적으로 구현할 수 있습니다.

Java에서 DOC 파일을 PDF로 변환하는 것이 자동화가 필요한 이유

많은 기업에서는 일관성과 보안을 위해 PDF로 재배포해야 하는 레거시 DOC 문서를 대량으로 처리합니다. 수동 변환은 시간 소모가 크고 오류가 발생하기 쉬우며 대량 작업에 확장되지 않습니다. 개발자는 서버에서 작동하고 CI 파이프라인과 통합되며 문서 충실성을 유지하는 프로그래밍 방식이 필요합니다.

접근 방식: 클라우드 기반 명령줄 변환

Aspose.HTML Cloud SDK for Java은 REST‑기반 API를 제공하며 Java 코드에서 호출하거나 cURL과 같은 명령줄 도구를 통해 직접 사용할 수 있습니다. SDK는 형식 감지, 글꼴 포함 및 이미지 품질 설정을 기본적으로 처리합니다. 클라우드 서비스를 활용하면 서버에 무거운 네이티브 라이브러리를 설치할 필요 없이 고품질 DOC를 PDF로 변환할 수 있습니다. 자세한 API 사용 방법은 공식 문서와 API 참조에 설명되어 있습니다.

Java와 Aspose.HTML을 사용한 DOC를 PDF로 변환 구현

Maven 종속성 설정

Maven 종속성을 pom.xml에 추가하여 Aspose.HTML Cloud 라이브러리를 컴파일 시점에 사용할 수 있도록 합니다.

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-html-cloud</artifactId>
    <version>25.11.1</version>
</dependency>

최신 패키지는 다운로드 페이지에서 다운로드할 수 있습니다.

Aspose.HTML 클라우드 자격 증명 구성

Configuration 객체를 생성하고 AppSid와 AppKey를 설정합니다. 이러한 값은 Aspose Cloud 대시보드에서 얻을 수 있습니다.

Configuration config = new Configuration();
config.setAppKey("YOUR_APP_KEY");
config.setAppSid("YOUR_APP_SID");

DOC 파일 로드 및 변환 요청 준비

소스 DOC 파일을 바이트 배열로 읽은 다음 입력 형식과 대상 형식을 지정하는 ConvertDocumentRequest를 빌드합니다.

byte[] inputBytes = Files.readAllBytes(Paths.get("input.docx"));

ConvertDocumentRequest request = new ConvertDocumentRequest();
request.setInputFile(inputBytes);
request.setFileName("input.docx");      // source format hint
request.setOutputFormat("pdf");         // target format

PDF 출력 옵션 정의

예를 들어 글꼴을 포함하고 이미지 품질을 설정하여 PDF 생성을 선택적으로 사용자 지정할 수 있습니다.

Map<String, Object> pdfOptions = new HashMap<>();
pdfOptions.put("embedFonts", true);
pdfOptions.put("imageQuality", 90);
request.setConversionOptions(pdfOptions);

변환 실행 및 PDF 저장

API 클라이언트를 초기화하고, 변환을 호출한 다음, 결과 PDF 바이트를 파일에 씁니다.

try (ApiClient apiClient = new ApiClient(config)) {
    HtmlApi htmlApi = new HtmlApi(apiClient);
    ConvertDocumentResponse response = htmlApi.convertDocument(request);
    Files.write(Paths.get("output.pdf"), response.getDocument());
}

이 단계들은 Aspose.HTML Cloud 라이브러리를 사용한 Java에서 DOC를 PDF로 변환 전체 워크플로를 보여줍니다.

전체 코드 예제: Java DOC를 PDF로 변환 (Aspose.HTML 사용)

다음 예제는 모든 조각을 하나의 실행 가능한 프로그램으로 결합합니다.

import com.aspose.html.cloud.ApiClient;
import com.aspose.html.cloud.Configuration;
import com.aspose.html.cloud.api.HtmlApi;
import com.aspose.html.cloud.model.requests.ConvertDocumentRequest;
import com.aspose.html.cloud.model.responses.ConvertDocumentResponse;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.HashMap;
import java.util.Map;

public class DocToPdfConverter {
    public static void main(String[] args) throws Exception {
        // Configure Aspose.HTML Cloud credentials
        Configuration config = new Configuration();
        config.setAppKey("YOUR_APP_KEY");
        config.setAppSid("YOUR_APP_SID");

// Initialize API client (auto‑closeable)
        try (ApiClient apiClient = new ApiClient(config)) {
            HtmlApi htmlApi = new HtmlApi(apiClient);

// Input DOCX and output PDF file paths
            String inputPath = "input.docx";
            String outputPath = "output.pdf";

// Load DOCX file into memory
            byte[] inputBytes = Files.readAllBytes(Paths.get(inputPath));

// Build conversion request
            ConvertDocumentRequest request = new ConvertDocumentRequest();
            request.setInputFile(inputBytes);
            request.setFileName("input.docx");      // source format hint
            request.setOutputFormat("pdf");         // target format

// Optional conversion options for PDF output
            Map<String, Object> pdfOptions = new HashMap<>();
            pdfOptions.put("embedFonts", true);
            pdfOptions.put("imageQuality", 90);
            request.setConversionOptions(pdfOptions);

// Execute conversion
            ConvertDocumentResponse response = htmlApi.convertDocument(request);

// Write resulting PDF to disk
            Files.write(Paths.get(outputPath), response.getDocument());
        }
    }
}

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

cURL 및 REST API를 사용한 문서 변환 수행

Java 코드를 작성하지 않고도 Aspose.HTML Cloud REST 엔드포인트를 직접 호출하여 동일한 DOC를 PDF로 변환할 수 있습니다.

1. 인증 및 액세스 토큰 가져오기

curl -X POST "https://api.aspose.cloud/v4.0/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

응답에는 이후 호출에 사용되는 access_token이 포함되어 있습니다.

2. 소스 DOC 파일 업로드

curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/input.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @input.docx

3. 변환 실행

curl -X POST "https://api.aspose.cloud/v4.0/html/convert?outputFormat=pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     -d @input.docx \
     -o output.pdf

4. 출력 PDF 다운로드 (직접 저장되지 않은 경우)

curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

이 cURL 명령을 사용하면 DOC를 PDF로 변환하는 작업을 스크립트, CI 파이프라인 또는 HTTP 요청을 할 수 있는 모든 환경에 통합할 수 있습니다. 자세한 내용은 API 참조를 참조하십시오.

결론

Java에서 DOC를 PDF로 변환을 구현하는 것은 Aspose.HTML Cloud SDK for Java를 사용하면 간단합니다. 이 라이브러리는 형식 감지부터 고품질 PDF 생성까지 모든 복잡한 작업을 처리하며, 선택적인 cURL 접근 방식은 자동화 스크립트에 유연성을 제공합니다. 프로덕션 사용을 위해 적절한 라이선스를 획득하는 것을 기억하세요; 가격 세부 정보는 제품 페이지에서 확인할 수 있으며, 임시 라이선스 페이지에서 평가용 임시 라이선스를 얻을 수 있습니다. 제공된 단계와 코드를 통해 이제 Java 애플리케이션에 신뢰할 수 있는 문서 변환을 통합할 수 있습니다.

자주 묻는 질문

Aspose.HTML Cloud SDK for Java를 설정하는 방법은?

첫 번째 구현 단계에 표시된 Maven 종속성을 추가한 다음, Configuration 클래스를 사용하여 AppSid 및 AppKey를 구성합니다. 자세한 설정 방법은 제품 문서에서 확인할 수 있습니다.

변환이 오류와 함께 실패하면 어떻게 해야 하나요?

입력 파일 경로가 올바른지와 자격 증명이 유효한지 확인하십시오. API는 설명적인 오류 메시지를 반환하며, 문제 해결 팁을 위해 지원 포럼도 참조할 수 있습니다.

PDF 출력(예: 글꼴 포함)을 사용자 정의할 수 있나요?

예. conversionOptions 맵을 사용하여 embedFonts 및 imageQuality와 같은 매개변수를 convertDocument를 호출하기 전에 설정하십시오. 사용 가능한 모든 옵션은 API 참조를 참조하십시오.

여러 개의 DOC 파일을 한 번에 배치 변환할 수 있나요?

SDK가 요청당 하나의 파일을 처리하지만, Java에서 파일 컬렉션을 반복하여 각 파일에 대한 변환 로직을 호출하면 추가 API 변경 없이 배치 처리를 구현할 수 있습니다.

더 읽기