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

• 비밀번호 보호 ZIP 파일을 비밀번호 보호 소프트웨어로 보호하기
• 비밀번호 보호 서비스를 사용하여 Excel 비밀번호 보호하기
• C#에서 Word 문서 결합하기

Node.JS에서 여러 Word 문서 결합 - 전체 코드 예제

이 예제는 GroupDocs.Merger Cloud SDK for Node.js를 사용하여 세 개의 DOCX 파일을 하나의 문서로 병합하는 방법을 보여줍니다.

const GroupDocsMergerCloud = require("@groupdocs/merger-cloud");

// ==== Configuration ====
// Replace with your actual credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

// ==== Input / Output paths ====
const inputFiles = [
    "documents/input1.docx",
    "documents/input2.docx",
    "documents/input3.docx"
];
const outputFile = "documents/combined_output.docx";

// ==== Build request ====
const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({
            filePath: path
        })
    });
});

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

// ==== Execute merge ====
(async () => {
    try {
        const result = await mergeApi.mergeDocuments(mergeRequest);
        console.log(`Merge completed successfully. Output file: ${result.path}`);
    } catch (error) {
        console.error("Error during merging:", error);
    }
})();

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

cURL을 사용한 REST API로 워드 문서 병합

순수 REST 방식을 선호한다면, 동일한 병합 작업을 cURL 명령으로 수행할 수 있습니다. 아래는 인증하고, 소스 파일을 업로드하고, 병합을 실행한 뒤 결과를 다운로드하는 간결한 워크플로우입니다.

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

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

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

2. 소스 파일 업로드

병합하려는 각 DOCX 파일에 대해 이 단계를 반복하십시오.

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=documents/input1.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@path/to/input1.docx"

3. 병합 작업 실행

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

API는 병합된 파일의 경로를 반환합니다.

4. 병합된 문서 다운로드

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

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

Node.JS에서 여러 Word 문서를 병합하는 작동 방식

SDK는 병합 프로세스를 몇 가지 논리적 단계로 추상화합니다:

1. 구성 생성 - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) 은 인증 컨텍스트를 생성합니다. 클래스 참조는 API Reference에서 확인하세요.

   const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
   

2. API 인스턴스 - new GroupDocsMergerCloud.MergeApi(config)은(는) 병합 작업에 대한 액세스를 제공합니다.

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

3. 문서 항목 - 각 소스 파일은 DocumentEntry에 래핑되며, 여기에는 파일 경로를 포함하는 FileInfo가 들어 있습니다.

   const documentEntries = inputFiles.map(path => {
       return new GroupDocsMergerCloud.Models.DocumentEntry({
           fileInfo: new GroupDocsMergerCloud.Models.FileInfo({ filePath: path })
       });
   });
   

4. Merge Request - MergeDocumentsRequest는 항목들을 번들링하고 원하는 출력 경로를 지정합니다.

   const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
       documents: documentEntries,
       outputPath: outputFile
   });
   

5. 실행 - mergeApi.mergeDocuments(mergeRequest)는 클라우드 서비스에 요청을 보냅니다. 프로미스는 출력 파일 경로를 포함하는 결과 객체와 함께 해결됩니다.

   const result = await mergeApi.mergeDocuments(mergeRequest);
   console.log(`Merge completed successfully. Output file: ${result.path}`);
   

이 단계들을 함께 수행하면 낮은 수준의 파일 스트림을 직접 처리하지 않고도 여러 Word 문서를 효율적으로 결합할 수 있습니다.

GroupDocs.Merger를 위한 환경 준비

1. SDK 설치

npm install groupdocs-merger-cloud

패키지는 공식 다운로드 페이지에서 사용할 수 있습니다.

2. Node.js 버전 - Node.js 12 이상을 실행하고 있는지 확인하십시오.

3. 자격 증명 구성 - 코드에서 YOUR_CLIENT_ID 및 YOUR_CLIENT_SECRET를 귀하의 GroupDocs Cloud 계정에서 가져온 값으로 교체하십시오.

4. 프로젝트 폴더 만들기 - 예시와 같이 documents/ 하위 폴더에 원본 DOCX 파일을 배치합니다.

이러한 단계가 완료되면 병합 스크립트를 실행하거나 REST 엔드포인트를 호출할 준비가 됩니다.

결론

Node.JS에서 여러 Word 문서를 결합하는 것이 GroupDocs.Merger Cloud SDK for Node.js를 사용하면 간단해집니다. SDK는 파일 업로드, 병합 로직 및 출력 생성을 처리하여 저수준 파일 조작이 아닌 비즈니스 로직에 집중할 수 있게 해줍니다. 프로덕션 사용을 위해 적절한 라이선스를 확보하는 것을 기억하세요; 임시 라이선스로 시작하고 필요에 따라 전체 구독으로 업그레이드할 수 있습니다. 오늘 바로 병합을 시작하고 문서 워크플로를 간소화하세요.

자주 묻는 질문

• Node.JS SDK를 사용하여 여러 Word 문서를 결합하려면 어떻게 해야 하나요?
  MergeApi 클래스를 사용하여 각 DOCX 파일을 DocumentEntry로 나열하는 MergeDocumentsRequest를 생성합니다. SDK는 제공된 순서대로 문서를 병합하고 결과를 지정된 출력 경로에 저장합니다.

• 같은 SDK로 PDF를 함께 병합할 수 있나요?
  예, Merger SDK는 PDF, DOCX, ODT, 및 여러 다른 형식을 지원합니다. inputFiles 배열에서 파일 확장자를 변경하기만 하면 SDK가 자동으로 변환을 처리합니다. 형식 세부 정보는 공식 문서를 참조하십시오.

• 단일 요청에서 병합할 수 있는 문서 수에 대한 제한은 무엇인가요?
  클라우드 서비스는 엄격한 개수 제한보다 용량 제한을 적용합니다. 결합된 파일 크기가 계정 할당량 내에 있으면 수십 개의 파일을 병합할 수 있습니다. 매우 큰 배치의 경우 먼저 파일을 GroupDocs 스토리지에 업로드하고 ID로 참조하는 것을 고려하십시오.

• 개발과 프로덕션에 대한 라이선스를 신경 써야 하나요?
  개발 및 테스트에서는 임시 라이선스 페이지에서 얻은 임시 라이선스를 사용할 수 있습니다. 프로덕션 배포의 경우, 무제한 병합 및 우선 지원을 위해 전체 라이선스를 구매하십시오.

더 읽기

• 비밀번호 보호 소프트웨어를 사용하여 ZIP 파일에 비밀번호 보호
• 비밀번호 보호 서비스를 사용하여 Excel에 비밀번호 보호
• C#에서 Word 문서 결합