Word dosyalarını programlı olarak birleştirmek, özellikle rapor oluşturma veya sözleşmeleri konsolide etme gibi belge‑odaklı uygulamalar geliştirirken sıkça ihtiyaç duyulan bir gereksinimdir. GroupDocs.Merger Cloud SDK for Java düşük seviyeli dosya işlemleriyle uğraşmadan DOCX dosyalarını birleştirmenizi sağlayan basit, bulut‑tabanlı bir kütüphane sunar. Bu rehberde Java’da birden fazla Word belgesini nasıl birleştireceğinizi öğrenecek, tam bir kod örneği görecek, eşdeğer cURL çağrılarını inceleyecek ve gerekli kurulum hakkında bilgi sahibi olacaksınız. Sonunda, belge birleştirmeyi kendi Java projelerinize entegre etmeye hazır olacaksınız.

Java’da Birden Çok Word Belgesini Birleştirmek İçin Tam Çalışan Örnek

Bu örnek, Merger API’si kullanarak Java’da birden çok Word belgesini nasıl birleştireceğinizi gösterir.

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());
        }
    }
}

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğini doğruladığınızdan ve geliştirme ortamınızda kapsamlı bir şekilde test ettiğinizden emin olun. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

cURL Kullanarak REST API ile Word Dosyalarını Birleştirme

Saf bir REST yaklaşımını tercih ediyorsanız, aynı birleştirme işlemi cURL çağrılarıyla gerçekleştirilebilir. Aşağıdaki adımlar, bir erişim belirteci almayı, kaynak dosyaları yüklemeyi, birleştirme talebinde bulunmayı ve sonucu indirmeyi gösterir.

Kimlik doğrulaması yapın ve bir erişim belirteci alın:

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"}'

Her DOCX dosyasını bulut depolamanıza yükleyin (önceki adımdan aldığınız token ile YOUR_ACCESS_TOKEN değerini değiştirin):

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 ve input3.docx için yükleme komutunu tekrarlayın.

Birleştirme isteği oluşturun:

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"}
           ]
         }'

Birleştirilmiş belgeyi indirin:

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

İstek parametreleri hakkında daha fazla ayrıntı için, resmi API belgeleri.

Java’da Word Belgelerini Birleştirme Sürecini Anlamak

Aşağıda, daha önce gösterilen kodun adım adım açıklaması yer almaktadır.

  1. Create an ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") GroupDocs bulut hizmetine bir bağlantı kurar.
    ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
  2. Instantiate MergerApi - new MergerApi(apiClient) birleştirme ile ilgili uç noktalara erişim sağlar.
    MergerApi mergerApi = new MergerApi(apiClient);
  3. Prepare source file list - Her FileInfo nesnesi bulutta depolanan bir DOCX dosyasına işaret eder. Liste MergeOptionsa geçirilir.
    List<FileInfo> sourceFiles = new ArrayList<>();
sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
  4. Configure MergeOptions - İstenen çıkış yolunu ayarlayın ve kaynak dosya listesini ekleyin.
    MergeOptions mergeOptions = new MergeOptions();
mergeOptions.setOutputPath("merged_output.docx");
mergeOptions.setFileInfos(sourceFiles);
  5. Execute merge - mergerApi.merge(mergeOptions) isteği gönderir ve birleştirilmiş belge için bir FileInfo döndürür.
    FileInfo result = mergerApi.merge(mergeOptions);

Mevcut özelliklerin tam listesi için, API referansı adresine bakın.

Gereksinimler ve GroupDocs.Merger Cloud SDK Kurulumu

Kodu çalıştırmadan önce, Maven bağımlılığını projenize ekleyin ve geçerli bir GroupDocs hesabınızın olduğundan emin olun.

SDK’yı pom.xml dosyanıza ekleyin:

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

En son JAR dosyalarını ve kaynak kodunu indirme sayfasından indirin.
Bulut çağrıları için Java 8 veya daha yeni bir sürüm ve internet erişimine de ihtiyacınız olacak.
Bir GroupDocs hesabı oluşturun, Client ID ve Client Secret değerlerinizi alın ve güvenli bir şekilde saklayın.

Sonuç

DOCX dosyalarını programlı olarak birleştirmek artık GroupDocs.Merger Cloud SDK for Java ile oldukça basit. Örnek kod ve cURL snippet’leri, Java’da birden fazla Word belgesini birleştirmenin iki esnek yolunu gösterir; ister yerel bir kütüphane, ister doğrudan REST çağrılarını tercih edin. Kimlik bilgilerinizi yapılandırmayı, gerektiğinde büyük dosyaları akış (streaming) yöntemiyle işlemeyi ve birleştirme işlemini temsilci belgelerle test etmeyi unutmayın. Üretim ortamları için ücretli bir lisansa ihtiyacınız olacak; fiyatlandırma detayları ürün sayfasında mevcuttur ve değerlendirme için geçici bir lisans talep edebilirsiniz geçici lisans sayfasından.

SSS

  • Java’da özel dosya‑işleme kodu yazmadan birden fazla Word belgesini nasıl birleştiririm?
    Java için GroupDocs.Merger Cloud SDK for Java kullanın. SDK, tüm düşük seviyeli işlemleri soyutlar ve birkaç API çağrısıyla DOCX dosyalarını birleştirmenizi sağlar.

  • Farklı bulut klasörlerinde depolanan belgeleri birleştirmek mümkün mü?
    Evet. FileInfo nesnelerinde tam bulut dosya yollarını sağlayın; birleştirme işlemi, her dosyayı konumundan alıp birleştirmeden önce getirir.

  • Bir ApiException ile birleştirme başarısız olursa ne yapmalıyım?
    İstisna mesajını, eksik dosyalar veya izin sorunları gibi ayrıntılar için kontrol edin. Dosya yollarının doğru olduğundan ve hesabınızın depolamaya okuma/yazma erişimine sahip olduğundan emin olun. Hata kodları için resmi dokümantasyona bakın.

  • Her ortam (geliştirme, test, üretim) için ayrı bir lisansa ihtiyacım var mı?
    Tek bir lisans tüm ortamları kapsar, ancak lisans sözleşmenizde tanımlanan kullanım limitlerine uymanız gerekir. Test için yukarıda bağlantısı verilen geçici lisansı kullanabilirsiniz.

Daha Fazla Oku