Menggabungkan file Word secara programatis adalah kebutuhan yang sering muncul ketika membangun aplikasi berfokus pada dokumen, terutama untuk menghasilkan laporan atau mengkonsolidasikan kontrak. GroupDocs.Merger Cloud SDK for Java menyediakan pustaka berbasis cloud yang sederhana yang memungkinkan Anda menggabungkan file DOCX tanpa harus menangani penanganan file tingkat rendah. Dalam panduan ini Anda akan mempelajari cara menggabungkan beberapa dokumen Word dalam Java, melihat contoh kode lengkap, menjelajahi panggilan cURL yang setara, dan memahami pengaturan yang diperlukan. Pada akhir panduan Anda akan siap mengintegrasikan penggabungan dokumen ke dalam proyek Java Anda sendiri.

Contoh Kerja Penuh untuk Menggabungkan Beberapa Dokumen Word di Java

Contoh ini menunjukkan cara menggabungkan beberapa dokumen Word di Java menggunakan API Merger.

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

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan lakukan pengujian secara menyeluruh di lingkungan pengembangan Anda. Jika Anda mengalami masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Menggabungkan File Word melalui REST API Menggunakan cURL

Jika Anda lebih memilih pendekatan REST murni, operasi penggabungan yang sama dapat dilakukan dengan panggilan cURL. Langkah-langkah di bawah ini menunjukkan cara memperoleh token akses, mengunggah file sumber, meminta penggabungan, dan mengunduh hasilnya.

Autentikasi dan dapatkan token akses:

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

Unggah setiap file DOCX ke penyimpanan cloud Anda (ganti YOUR_ACCESS_TOKEN dengan token dari langkah sebelumnya):

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

Ulangi perintah upload untuk input2.docx dan input3.docx.

Buat permintaan penggabungan:

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

Unduh dokumen yang digabungkan:

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

Untuk detail lebih lanjut tentang parameter permintaan, lihat dokumentasi API resmi.

Memahami Proses Menggabungkan Dokumen Word di Java

Berikut adalah penjelasan langkah demi langkah dari kode yang ditampilkan sebelumnya.

  1. Buat ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") membuat koneksi ke layanan cloud GroupDocs.

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

  2. Instansiasi MergerApi - new MergerApi(apiClient) memberikan akses ke endpoint terkait penggabungan.

    MergerApi mergerApi = new MergerApi(apiClient);

  3. Siapkan daftar file sumber - Setiap objek FileInfo menunjuk ke file DOCX yang disimpan di cloud. Daftar tersebut diteruskan ke MergeOptions.

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

  4. Konfigurasikan MergeOptions - Atur jalur output yang diinginkan dan lampirkan daftar file sumber.

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

  5. Jalankan penggabungan - mergerApi.merge(mergeOptions) mengirim permintaan dan mengembalikan FileInfo untuk dokumen yang telah digabungkan.

    FileInfo result = mergerApi.merge(mergeOptions);

Untuk daftar lengkap properti yang tersedia, lihat referensi API.

Prasyarat dan Penyiapan untuk GroupDocs.Merger Cloud SDK

Sebelum Anda dapat menjalankan kode, tambahkan dependensi Maven ke proyek Anda dan pastikan Anda memiliki akun GroupDocs yang valid.

Tambahkan SDK ke pom.xml Anda:

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

Unduh JAR terbaru dan sumbernya dari halaman unduhan.
Anda juga memerlukan Java 8 atau yang lebih tinggi serta akses internet untuk panggilan cloud.
Buat akun GroupDocs, dapatkan Client ID dan Client Secret Anda, dan simpan dengan aman.

Kesimpulan

Menggabungkan file DOCX secara programatik kini menjadi mudah dengan GroupDocs.Merger Cloud SDK for Java. Kode contoh dan cuplikan cURL menunjukkan dua cara fleksibel untuk menggabungkan beberapa dokumen Word di Java, baik Anda lebih suka pustaka native maupun panggilan REST langsung. Pastikan untuk mengonfigurasi kredensial Anda, menangani file besar dengan streaming jika diperlukan, dan menguji operasi penggabungan dengan dokumen yang representatif. Untuk penerapan produksi, Anda memerlukan lisensi berbayar; detail harga tersedia di halaman produk dan Anda dapat meminta lisensi sementara untuk evaluasi dari halaman lisensi sementara.

FAQ

  • Bagaimana cara menggabungkan beberapa dokumen Word di Java tanpa menulis kode penanganan file khusus?
    Gunakan GroupDocs.Merger Cloud SDK for Java. SDK ini mengabstraksi semua operasi tingkat rendah dan memungkinkan Anda menggabungkan file DOCX dengan beberapa panggilan API.

  • Apakah memungkinkan untuk menggabungkan dokumen yang disimpan di folder cloud yang berbeda?
    Ya. Berikan jalur file cloud lengkap dalam objek FileInfo, dan operasi penggabungan akan mengambil setiap file dari lokasinya sebelum menggabungkannya.

  • Apa yang harus saya lakukan jika penggabungan gagal dengan ApiException?
    Periksa pesan pengecualian untuk detail seperti file yang hilang atau masalah izin. Pastikan jalur file sudah benar dan akun Anda memiliki akses baca/tulis ke penyimpanan. Konsultasikan dokumentasi resmi untuk kode kesalahan.

  • Apakah saya memerlukan lisensi terpisah untuk setiap lingkungan (pengembangan, staging, produksi)?
    Satu lisensi mencakup semua lingkungan, tetapi Anda harus menghormati batas penggunaan yang ditentukan dalam perjanjian lisensi Anda. Untuk pengujian, Anda dapat menggunakan lisensi sementara yang ditautkan di atas.

Baca Selengkapnya