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

• Şifre Koruması Yazılımı Kullanarak ZIP Dosyasını Şifrele
• Şifre Koruması Servisi Kullanarak Excel’i Şifrele
• C#’ta Word Belgelerini Birleştir

Node.JS’te Birden Çok Word Belgesini Birleştirme - Tam Kod Örneği

Bu örnek, üç DOCX dosyasını tek bir belgeye birleştirmek için GroupDocs.Merger Cloud SDK for Node.js kullanarak nasıl yapılacağını gösterir.

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

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını (input1.docx, combined_output.docx, vb.) gerçek dosya konumlarınıza göre 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 dokümantasyona bakın veya destek ekibi ile iletişime geçin.

cURL Kullanarak REST API ile Word Belgelerini Birleştirme

Saf bir REST yaklaşımını tercih ediyorsanız, aynı birleştirme işlemi cURL komutlarıyla gerçekleştirilebilir. Aşağıda kimlik doğrulaması yapan, kaynak dosyaları yükleyen, birleştirmeyi çalıştıran ve sonucu indiren kısa bir iş akışı bulunmaktadır.

1. Kimlik Doğrulama ve Erişim Token’ı Al

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

Yanıt, sonraki çağrılarda kullanılan bir access_token içerir.

2. Kaynak Dosyaları Yükleyin

Bu adımı birleştirmek istediğiniz her DOCX dosyası için tekrarlayın.

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. Birleştirme İşlemini Gerçekleştir

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, birleştirilmiş dosyanın yolunu döndürür.

4. Birleştirilmiş Belgeyi İndir

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

İstek yükleri ve seçenekler hakkında daha fazla ayrıntı için, resmi API belgelerine bakın.

Node.JS’te Birden Çok Word Belgesini Birleştirme Nasıl Çalışır

SDK, birleştirme sürecini birkaç mantıksal adıma soyutlar:

1. Yapılandırma Oluşturma - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) kimlik doğrulama bağlamını oluşturur. Sınıf referansına API Reference içinde bakın.

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

2. API Örneği - new GroupDocsMergerCloud.MergeApi(config) birleştirme işlemlerine erişim sağlar.

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

3. Belge Girişleri - Her kaynak dosya, dosya yolunu içeren bir FileInfo içeren bir DocumentEntry içinde paketlenir.

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

4. Birleştirme İsteği - MergeDocumentsRequest girdileri ve istenen çıktı yolunu paketler.

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

5. Yürütme - mergeApi.mergeDocuments(mergeRequest) isteği bulut hizmetine gönderir. Promise, çıktı dosyası yolunu içeren bir sonuç nesnesiyle çözülür.

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

Bu adımlar, düşük seviyeli dosya akışlarıyla uğraşmadan birden fazla Word belgesini verimli bir şekilde birleştirmenizi sağlar.

GroupDocs.Merger için Ortamı Hazırlama

1. SDK’yı kurun

npm install groupdocs-merger-cloud

Paket, resmi indirme sayfasından temin edilebilir.

2. Node.js Version - Node.js 12 veya daha yeni bir sürüm çalıştırdığınızdan emin olun.

3. Kimlik Bilgilerini Yapılandır - Kodda YOUR_CLIENT_ID ve YOUR_CLIENT_SECRET değerlerini GroupDocs Cloud hesabınızdaki değerlerle değiştirin.

4. Proje Klasörü Oluşturun - Örnekte gösterildiği gibi kaynak DOCX dosyalarını documents/ alt klasörüne yerleştirin.

Bu adımları tamamladıktan sonra, birleştirme betiğini çalıştırmaya veya REST uç noktalarını çağırmaya hazırsınız.

Sonuç

Node.JS’te birden fazla Word belgesini birleştirmek, GroupDocs.Merger Cloud SDK for Node.js ile oldukça basit hale gelir. SDK, dosya yüklemelerini, birleştirme mantığını ve çıktı oluşturmayı yönetir, böylece düşük seviyeli dosya manipülasyonu yerine iş mantığına odaklanabilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; ihtiyaçlarınız büyüdükçe bir geçici lisans ile başlayabilir ve tam bir aboneliğe yükseltebilirsiniz. Bugün birleştirmeye başlayın ve belge iş akışlarınızı sadeleştirin.

FAQs

• Node.JS SDK kullanarak birden fazla Word belgesini nasıl birleştiririm?
  MergeApi sınıfını kullanarak her DOCX dosyasını bir DocumentEntry olarak listeleyen bir MergeDocumentsRequest oluşturun. SDK, sağlanan sıraya göre belgeleri birleştirir ve sonucu belirtilen çıkış yoluna kaydeder.

• Aynı SDK ile PDF’leri birleştirmek mümkün mü?
  Evet, Merger SDK, PDF, DOCX, ODT ve birkaç başka formatı destekler. inputFiles dizisindeki dosya uzantılarını değiştirmeniz yeterlidir; SDK dönüşümü otomatik olarak gerçekleştirir. Format detayları için resmi belgeleri inceleyin.

• Tek bir istekte birleştirebileceğim belge sayısıyla ilgili sınırlamalar nelerdir?
  Bulut hizmeti, kesin bir sayı yerine boyut sınırlaması uygular. Birleştirilen dosyaların toplam boyutu hesabınızın kotası içinde kaldığı sürece, onlarca dosyayı birleştirebilirsiniz. Çok büyük toplu işlemler için, dosyaları önce GroupDocs depolamasına yüklemeyi ve ID’leriyle referans vermeyi düşünün.

• Geliştirme ve üretim için lisans konusunda endişelenmem gerekiyor mu?
  Geliştirme ve test aşamaları, geçici lisans sayfası üzerinden alınan geçici bir lisansla kullanılabilir. Üretim dağıtımları için, sınırsız birleştirmeleri ve öncelikli desteği açmak amacıyla tam bir lisans satın alın.

Daha Fazla Oku

• Şifre Koruması Yazılımı Kullanarak ZIP Dosyasını Şifrele
• Şifre Koruma Servisi Kullanarak Excel’i Şifrele
• C#’ta Word Belgelerini Birleştir