Mengedit file Excel secara programatik merupakan kebutuhan yang sering muncul saat membangun aplikasi Java berbasis data, terutama ketika Anda perlu memperbarui laporan atau menghasilkan spreadsheet dinamis secara langsung. GroupDocs.Editor Cloud SDK for Java menyediakan pustaka berbasis REST yang kuat yang memungkinkan Anda memanipulasi buku kerja XLSX tanpa harus berurusan dengan format file tingkat rendah. Dalam panduan ini Anda akan melihat contoh kode Java lengkap, perintah cURL yang setara, langkah‑langkah instalasi, serta opsi konfigurasi untuk mengintegrasikan pengeditan Excel ke dalam proyek Java Anda.

Edit Lembar Excel via REST di Java - Contoh Kode Lengkap

Contoh berikut menunjukkan cara memuat workbook Excel, melakukan perubahan, dan menyimpannya kembali ke penyimpanan menggunakan GroupDocs.Editor Cloud SDK for Java.

import com.groupdocs.cloud.editor.api.*;
import com.groupdocs.cloud.editor.client.*;
import com.groupdocs.cloud.editor.model.*;
import com.groupdocs.cloud.editor.model.requests.*;

public class EditDocument {
    public static void main(String[] args) {
        // Configure API client
        ApiClient apiClient = new ApiClient();
        apiClient.setBasePath("https://api.groupdocs.cloud");
        apiClient.setAppSid("YOUR_CLIENT_ID");
        apiClient.setAppKey("YOUR_CLIENT_SECRET");

// Create EditorApi instance
        EditorApi editorApi = new EditorApi(apiClient);

// Load document
        LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
        LoadResult loadResult = editorApi.loadDocument(loadRequest);

// Get document pages (for Excel, each sheet is a page)
        // Edit cell via editing HTML? Not sure.

// Save document
        SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null);
        editorApi.saveDocument(saveRequest);
    }
}

Catatan: Contoh kode ini menunjukkan fungsionalitas inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (sample.xlsx, output.xlsx), memverifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan melakukan pengujian secara menyeluruh di lingkungan pengembangan Anda. Jika Anda mengalami masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Pengeditan Excel REST dengan Perintah cURL

Jika Anda lebih memilih pendekatan REST murni, operasi yang sama dapat dilakukan dengan cURL. Berikut adalah langkah-langkah tipikal.

  1. Dapatkan token akses
    Ganti YOUR_CLIENT_ID dan YOUR_CLIENT_SECRET dengan kredensial Anda.
curl -X POST "https://api.groupdocs.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. Unggah file XLSX sumber
curl -X PUT "https://api.groupdocs.cloud/v2.0/editor/storage/file/sample.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
     --data-binary @sample.xlsx
  1. Muat buku kerja untuk diedit
curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "sample.xlsx",
           "loadOptions": {}
         }'
  1. Simpan workbook yang dimodifikasi
curl -X POST "https://api.groupdocs.cloud/v2.0/editor/save" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "sample.xlsx",
           "outputPath": "output.xlsx",
           "saveOptions": {}
         }'

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

Memahami Pengeditan Lembar Excel melalui REST dalam Kode Java

Berikut adalah penjelasan langkah demi langkah contoh Java:

  1. Konfigurasi API client - Objek ApiClient menyimpan URL dasar dan kredensial otentikasi.
ApiClient apiClient = new ApiClient();
apiClient.setBasePath("https://api.groupdocs.cloud");
apiClient.setAppSid("YOUR_CLIENT_ID");
apiClient.setAppKey("YOUR_CLIENT_SECRET");
  1. Buat instance Editor API - EditorApi menyediakan metode seperti loadDocument dan saveDocument.
EditorApi editorApi = new EditorApi(apiClient);
  1. Muat buku kerja Excel - LoadDocumentRequest menentukan nama file; respons berisi informasi halaman (lembar).
LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
LoadResult loadResult = editorApi.loadDocument(loadRequest);

  1. Edit the workbook - Untuk Excel, setiap lembar muncul sebagai halaman. Anda dapat memanipulasi representasi HTML dari sebuah halaman atau menggunakan API pengeditan lainnya. (Contoh ini meninggalkan bagian ini sebagai placeholder.)

  2. Simpan file yang dimodifikasi - SaveDocumentRequest mendefinisikan jalur sumber dan tujuan.

    SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null);
editorApi.saveDocument(saveRequest);

Untuk daftar lengkap kelas dan properti, lihat referensi API.

Menyiapkan Lingkungan

Tambahkan SDK ke proyek Maven Anda:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-editor-cloud</artifactId>
    <version>25.7</version>
</dependency>

Prasyarat: Java 8 atau lebih tinggi, akun GroupDocs Cloud, dan kredensial klien yang valid (AppSid dan AppKey). Unduh JAR terbaru dari halaman unduhan.

Mengonfigurasi Opsi Pengeditan Excel

SDK memungkinkan Anda menyesuaikan perilaku pemuatan dan penyimpanan secara detail:

  1. Opsi pemuatan - Mengontrol apakah workbook dibuka dalam mode hanya‑baca.
LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);
  1. Opsi penyimpanan - Pilih format output (XLSX, CSV, dll.) dan apakah akan mempertahankan rumus.
SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);
  1. Pengaturan autentikasi - Anda dapat mengatur batas waktu khusus atau proxy jika diperlukan.
apiClient.setTimeout(120000); // 2 minutes

Opsi-opsi ini diteruskan ke objek permintaan yang ditunjukkan sebelumnya.

Kesimpulan

Mengedit lembar Excel melalui REST di Java menjadi mudah dengan GroupDocs.Editor Cloud SDK for Java. SDK mengabstraksi panggilan REST, memungkinkan Anda fokus pada logika bisnis sambil menangani otentikasi, penyimpanan file, dan nuansa format di balik layar. Setelah mengintegrasikan contoh kode, Anda dapat memperluas solusi untuk mendukung pemrosesan batch, penataan sel khusus, atau evaluasi formula. Ingatlah untuk memperoleh lisensi yang tepat untuk penggunaan produksi; detail harga tersedia di halaman produk, dan lisensi percobaan sementara dapat diminta dari halaman lisensi sementara. Mulailah mengotomatisasi alur kerja Excel Anda hari ini dan tingkatkan produktivitas di seluruh aplikasi Java Anda.

FAQs

  • Bagaimana saya dapat mengedit lembar Excel melalui REST di Java menggunakan GroupDocs.Editor?
    Gunakan metode loadDocument dan saveDocument dari SDK seperti yang ditunjukkan dalam contoh kode. Perpustakaan menangani komunikasi REST, sehingga Anda hanya bekerja dengan objek Java.

  • Metode otentikasi apa yang diperlukan oleh REST API?
    API menggunakan alur OAuth2 client‑credentials. Dapatkan token akses dengan AppSid dan AppKey Anda, lalu sertakan dalam header Authorization: Bearer untuk semua panggilan. Detail ada di dokumentasi resmi.

  • Apakah saya dapat mengedit beberapa lembar kerja dalam satu permintaan?
    Ya. Setelah memuat workbook, setiap lembar kerja muncul sebagai halaman terpisah dalam LoadResult. Iterasi melalui halaman-halaman tersebut, terapkan perubahan, dan panggil saveDocument sekali untuk menyimpan semua edit.

  • Di mana saya dapat menemukan informasi harga dan lisensi?
    Kunjungi halaman utama produk untuk paket berlangganan dan halaman lisensi sementara untuk kunci percobaan.

Baca Selengkapnya