Java에서 PowerPoint PPT 및 PPTX 결합 및 병합 가이드

Fri, 14 Aug 2026 08:54:46 +0000

여러 PowerPoint 데크를 하나의 프레젠테이션으로 결합하는 것은 보고서나 교육 자료를 통합할 때 자주 필요한 작업입니다. GroupDocs.Merger Cloud SDK for Java는 Java 개발자가 몇 줄의 코드만으로 PowerPoint PPT PPTX를 Java에서 결합하고 병합할 수 있게 해줍니다. 이 가이드에서는 필요한 설정, 자세한 단계별 구현, 완전한 실행 가능한 예제, 그리고 cURL을 사용한 REST API를 통한 동일한 작업 수행 방법을 안내합니다.

GroupDocs.Merger Cloud SDK for Java 설정

코딩을 시작하기 전에 다음을 확인하십시오:

Java Development Kit (JDK) 8 이상.
IntelliJ IDEA 또는 Eclipse와 같은 IDE.
client ID 및 client secret가 포함된 GroupDocs Cloud 계정.

Maven 종속성을 pom.xml에 추가하세요:


    com.groupdocs
    groupdocs-merger-cloud
    25.11

공식 릴리스 페이지에서 최신 라이브러리를 다운로드하십시오: GroupDocs.Merger Cloud SDK for Java Download. 종속성이 해결되면 PowerPoint 파일을 결합하는 코드를 작성할 준비가 됩니다.

단계별 구축: Powerpoint PPT PPTX를 Java에서 결합 및 병합

1단계: API 클라이언트 초기화

자격 증명을 사용하여 ApiClient를 생성하고 MergerApi를 인스턴스화합니다.

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
MergerApi mergerApi = new MergerApi(apiClient);

2단계: 원본 PowerPoint 파일 정의

병합하려는 각 프레젠테이션에 대해 FileInfo 객체를 생성합니다.

FileInfo sourceFile1 = new FileInfo();
sourceFile1.setFilePath("input1.pptx"); // first PPTX file

FileInfo sourceFile2 = new FileInfo();
sourceFile2.setFilePath("input2.ppt"); // second PPT file

3단계: 병합 옵션 설정

소스 파일을 목록에 추가하고 출력 경로를 지정합니다.

List<FileInfo> sourceFiles = new ArrayList<>();
sourceFiles.add(sourceFile1);
sourceFiles.add(sourceFile2);

MergeOptions mergeOptions = new MergeOptions();
mergeOptions.setFileInfos(sourceFiles);          // files to be merged
mergeOptions.setOutputPath("merged_output.pptx"); // result file

4단계: 병합 요청 실행

MergeRequest를 생성하고 merge 메서드를 호출합니다.

MergeRequest mergeRequest = new MergeRequest(mergeOptions);
try {
    MergeResult mergeResult = mergerApi.merge(mergeRequest);
    System.out.println("Merge successful. Output file stored at: " + mergeResult.getPath());
} catch (Exception e) {
    System.err.println("An error occurred during merging: " + e.getMessage());
    e.printStackTrace();
}

위 코드는 SDK를 사용하여 Java에서 Powerpoint PPT PPTX 결합 및 병합 전체 워크플로우를 보여줍니다.

전체 코드 예제: Java에서 Powerpoint 파일 결합 및 병합

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

import com.groupdocs.merger.cloud.ApiClient;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import com.groupdocs.merger.cloud.model.requests.MergeRequest;
import com.groupdocs.merger.cloud.model.responses.MergeResult;

import java.util.ArrayList;
import java.util.List;

public class PowerPointMergeExample {
    public static void main(String[] args) {
        // Initialize the API client with your credentials
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        MergerApi mergerApi = new MergerApi(apiClient);

// Define the source PowerPoint files
        FileInfo sourceFile1 = new FileInfo();
        sourceFile1.setFilePath("input1.pptx"); // first PPTX file

FileInfo sourceFile2 = new FileInfo();
        sourceFile2.setFilePath("input2.ppt"); // second PPT file

List<FileInfo> sourceFiles = new ArrayList<>();
        sourceFiles.add(sourceFile1);
        sourceFiles.add(sourceFile2);

// Set merge options
        MergeOptions mergeOptions = new MergeOptions();
        mergeOptions.setFileInfos(sourceFiles);          // files to be merged
        mergeOptions.setOutputPath("merged_output.pptx"); // result file

// Create and execute the merge request
        MergeRequest mergeRequest = new MergeRequest(mergeOptions);
        try {
            MergeResult mergeResult = mergerApi.merge(mergeRequest);
            System.out.println("Merge successful. Output file stored at: " + mergeResult.getPath());
        } catch (Exception e) {
            System.err.println("An error occurred during merging: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

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

cURL 및 REST API를 사용한 Powerpoint 프레젠테이션 병합

Java 코드를 작성하지 않고도 GroupDocs Merger REST 엔드포인트를 호출하여 동일한 병합 작업을 수행할 수 있습니다. 아래는 일반적인 cURL 워크플로우입니다.

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

curl -X POST "https://api.groupdocs.cloud/v2.0/authentication/token" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

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

2. 소스 파일 업로드

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input1.pptx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/local/path/input1.pptx"

input2.ppt에 대해 명령을 반복하십시오.

3. 병합 작업 실행

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "fileInfos": [
          {"filePath": "input1.pptx"},
          {"filePath": "input2.ppt"}
        ],
        "outputPath": "merged_output.pptx"
      }'

API는 병합된 파일의 경로가 포함된 JSON 객체를 반환합니다.

4. 병합된 파일 다운로드

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=merged_output.pptx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o merged_output.pptx

자세한 내용은 공식 API 참조를 참조하십시오.

병합 옵션: 구성 및 설정

기본 예제가 대부분의 시나리오에서 작동하지만, SDK는 조정할 수 있는 추가 옵션을 제공합니다.

출력 경로

사용자 지정 폴더 또는 파일 이름을 지정합니다.

mergeOptions.setOutputPath("reports/combined_presentation.pptx");

비밀번호 보호 (필요한 경우)

mergeOptions.setPassword("StrongPassword123");

원본 레이아웃 유지

mergeOptions.setPreserveLayout(true);

이러한 속성은 MergeOptions 클래스의 일부이며, 전체 목록은 API reference를 참조하십시오.

결론

GroupDocs.Merger Cloud SDK for Java를 활용하면, 네이티브 Java 라이브러리든 RESTful cURL 방식이든 관계없이 Java에서 PowerPoint PPT 및 PPTX 파일을 결합하고 병합할 수 있습니다. SDK는 파일 저장, 병합 로직 및 출력 생성을 처리하므로 애플리케이션의 핵심 기능에 집중할 수 있습니다. 프로덕션 사용을 위해 적절한 라이선스를 취득해야 함을 기억하세요; 가격 정보는 제품 페이지에서 확인할 수 있으며, 평가를 위해 임시 라이선스를 요청하려면 임시 라이선스 페이지를 방문하세요. 오늘 바로 PowerPoint 병합을 통합하여 문서 워크플로를 간소화하세요.

FAQs

SDK로 병합할 수 있는 형식은 무엇인가요?
SDK는 PPT 및 PPTX 파일을 모두 지원하며, API 참조에 나열된 다른 많은 문서 형식도 지원합니다.
병합하기 전에 오래된 PPT 파일을 변환해야 하나요?
변환이 필요하지 않습니다. SDK는 병합 과정에서 PPT와 PPTX 소스를 자동으로 혼합하여 처리합니다.
SDK가 큰 프레젠테이션을 어떻게 처리합니까?
병합은 서버 측에서 수행되므로 클라이언트 머신의 메모리 사용량이 낮게 유지됩니다. 또한 PreserveLayout 옵션을 조정하여 성능을 최적화할 수 있습니다.
프레젠테이션을 Java 코드를 작성하지 않고 병합할 수 있나요?
예. 앞에서 보여준 대로 cURL 명령을 사용한 REST API를 사용하거나, HTTP 요청을 할 수 있는 모든 언어에 호출을 통합하면 됩니다.

java ppt merge on Document Processing REST APIs | GroupDocs Cloud