프로그래밍 방식으로 Word 파일을 결합하는 것은 문서 중심 애플리케이션을 구축할 때, 특히 보고서를 생성하거나 계약을 통합할 때 자주 요구되는 작업입니다. GroupDocs.Merger Cloud SDK for Java는 저수준 파일 처리를 다루지 않고도 DOCX 파일을 병합할 수 있는 간단한 클라우드 기반 라이브러리를 제공합니다. 이 가이드에서는 Java에서 여러 Word 문서를 결합하는 방법을 배우고, 전체 코드 예제를 확인하며, 동등한 cURL 호출을 탐색하고, 필요한 설정을 이해하게 됩니다. 끝까지 읽으면 자체 Java 프로젝트에 문서 병합을 통합할 준비가 됩니다.

Java에서 여러 Word 문서를 결합하는 전체 작업 예제

이 예제에서는 Merger API를 사용하여 Java에서 여러 Word 문서를 결합하는 방법을 보여줍니다.

import com.groupdocs.merger.cloud.client.ApiClient;
import com.groupdocs.merger.cloud.client.ApiException;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import java.util.ArrayList;
import java.util.List;

public class CombineWordDocuments {
    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);

try {
            // List of Word documents to combine
            List<FileInfo> sourceFiles = new ArrayList<>();
            sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input2.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input3.docx"));

// Configure merge options
            MergeOptions mergeOptions = new MergeOptions();
            mergeOptions.setOutputPath("merged_output.docx");
            mergeOptions.setFileInfos(sourceFiles);

// Execute the merge operation
            FileInfo result = mergerApi.merge(mergeOptions);

System.out.println("Merge completed successfully. Output file: " + result.getFilePath());
        } catch (ApiException e) {
            System.err.println("An error occurred while merging documents: " + e.getMessage());
        }
    }
}

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

cURL을 사용한 REST API를 통한 Word 파일 병합

순수한 REST 방식을 선호한다면, 동일한 병합 작업을 cURL 호출로 수행할 수 있습니다. 아래 단계에서는 액세스 토큰을 얻고, 원본 파일을 업로드하고, 병합을 요청하고, 결과를 다운로드하는 방법을 보여줍니다.

인증하고 액세스 토큰을 얻으세요:

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

각 DOCX 파일을 클라우드 스토리지에 업로드하십시오 (이전 단계에서 받은 토큰으로 YOUR_ACCESS_TOKEN를 교체하십시오):

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input1.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
     --data-binary @input1.docx

input2.docx 및 input3.docx에 대한 업로드 명령을 반복하십시오.

병합 요청 만들기:

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

병합된 문서를 다운로드:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/merged_output.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.docx

요청 매개변수에 대한 자세한 내용은 공식 API 문서를 참조하십시오.

Java에서 Word 문서를 결합하는 프로세스 이해

아래는 앞에서 보여준 코드의 단계별 분석입니다.

  1. ApiClient 생성 - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")는 GroupDocs 클라우드 서비스에 연결을 설정합니다.

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

  2. MergerApi 인스턴스화 - new MergerApi(apiClient)는 병합 관련 엔드포인트에 접근할 수 있게 합니다.

    MergerApi mergerApi = new MergerApi(apiClient);

  3. 소스 파일 목록 준비 - 각 FileInfo 객체는 클라우드에 저장된 DOCX 파일을 가리킵니다. 이 목록은 MergeOptions에 전달됩니다.

    List<FileInfo> sourceFiles = new ArrayList<>();
sourceFiles.add(new FileInfo().setFilePath("input1.docx"));

  4. MergeOptions 구성 - 원하는 출력 경로를 설정하고 소스 파일 목록을 첨부합니다.

    MergeOptions mergeOptions = new MergeOptions();
mergeOptions.setOutputPath("merged_output.docx");
mergeOptions.setFileInfos(sourceFiles);

  5. 병합 실행 - mergerApi.merge(mergeOptions)는 요청을 전송하고 병합된 문서에 대한 FileInfo를 반환합니다.

    FileInfo result = mergerApi.merge(mergeOptions);

사용 가능한 속성의 전체 목록은 API reference를 참조하십시오.

GroupDocs.Merger Cloud SDK의 사전 요구 사항 및 설정

코드를 실행하기 전에 프로젝트에 Maven 종속성을 추가하고 유효한 GroupDocs 계정이 있는지 확인하십시오.

SDK를 pom.xml에 추가하세요:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

최신 JAR 및 소스 코드를 다운로드 페이지에서 다운로드하십시오.
클라우드 호출을 위해 Java 8 이상과 인터넷 연결도 필요합니다.
GroupDocs 계정을 생성하고 Client ID와 Client Secret을 얻은 뒤 안전하게 보관하십시오.

결론

프로그램matically DOCX 파일을 병합하는 것이 이제 GroupDocs.Merger Cloud SDK for Java를 사용하면 간단합니다. 예제 코드와 cURL 스니펫은 네이티브 라이브러리를 사용하든 직접 REST 호출을 하든 Java에서 여러 Word 문서를 결합하는 두 가지 유연한 방법을 보여줍니다. 자격 증명을 구성하고, 필요에 따라 스트리밍으로 대용량 파일을 처리하며, 대표적인 문서로 병합 작업을 테스트하는 것을 잊지 마세요. 프로덕션 배포를 위해서는 유료 라이선스가 필요합니다; 가격 세부 정보는 제품 페이지에서 확인할 수 있으며, 평가용 임시 라이선스는 temporary license page에서 요청할 수 있습니다.

FAQs

  • 맞춤 파일‑처리 코드를 작성하지 않고 Java에서 여러 Word 문서를 결합하려면 어떻게 해야 하나요?
    Java용 GroupDocs.Merger Cloud SDK for Java를 사용하십시오. 이 SDK는 모든 저수준 작업을 추상화하고 몇 번의 API 호출만으로 DOCX 파일을 병합할 수 있게 해줍니다.

  • 다른 클라우드 폴더에 저장된 문서를 병합할 수 있나요?
    예. FileInfo 객체에 전체 클라우드 파일 경로를 제공하면 병합 작업이 각 파일을 해당 위치에서 가져와 결합합니다.

  • 병합이 ApiException으로 실패하면 어떻게 해야 하나요?
    예외 메시지를 확인하여 누락된 파일이나 권한 문제와 같은 세부 정보를 확인하십시오. 파일 경로가 올바른지, 계정에 저장소에 대한 읽기/쓰기 권한이 있는지 확인하십시오. 오류 코드는 공식 문서를 참고하십시오.

  • 각 환경(개발, 스테이징, 프로덕션)마다 별도의 라이선스가 필요합니까?
    단일 라이선스로 모든 환경을 커버할 수 있지만, 라이선스 계약에 정의된 사용 제한을 준수해야 합니다. 테스트용으로는 위에 링크된 임시 라이선스를 사용할 수 있습니다.

Read More