Java’da REST ile Excel Sayfasını Düzenleme - Tam Kod Örneği

Aşağıdaki örnek, bir Excel çalışma kitabını nasıl yükleyeceğinizi, değişiklik yapacağınızı ve GroupDocs.Editor Cloud SDK for Java kullanarak depolamaya geri kaydedeceğinizi gösterir.

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

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce dosya yollarını (sample.xlsx, output.xlsx) güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

cURL Komutlarıyla Excel REST Düzenleme

Saf bir REST yaklaşımını tercih ediyorsanız, aynı işlem cURL ile gerçekleştirilebilir. Aşağıda tipik adımlar yer almaktadır.

1. Erişim belirteci alın
   YOUR_CLIENT_ID ve YOUR_CLIENT_SECRET değerlerini kimlik bilgilerinizle değiştirin.

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"

2. Kaynak XLSX dosyasını yükleyin

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

3. Düzenleme için çalışma kitabını yükleyin

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

4. Değiştirilmiş çalışma kitabını kaydedin

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

İstek gövdeleri ve ek parametreler hakkında daha fazla ayrıntı için, resmi API belgelerine bakın.

REST ile Java Kodunda Excel Sayfasını Düzenlemeyi Anlamak

Aşağıda Java örneğinin adım adım açıklaması:

1. API istemcisini yapılandırın - ApiClient nesnesi temel URL’yi ve kimlik doğrulama kimlik bilgilerini depolar.

   ApiClient apiClient = new ApiClient();
   apiClient.setBasePath("https://api.groupdocs.cloud");
   apiClient.setAppSid("YOUR_CLIENT_ID");
   apiClient.setAppKey("YOUR_CLIENT_SECRET");
   

2. Editor API örneğini oluşturun - EditorApi loadDocument ve saveDocument gibi yöntemler sağlar.

   EditorApi editorApi = new EditorApi(apiClient);
   

3. Excel çalışma kitabını yükleyin - LoadDocumentRequest dosya adını belirtir; yanıt sayfa (çalışma sayfası) bilgilerini içerir.

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

4. Çalışma kitabını düzenle - Excel’de, her sayfa bir sayfa olarak görünür. Bir sayfanın HTML temsilini manipüle edebilir veya diğer düzenleme API’lerini kullanabilirsiniz. (Örnek bu kısmı yer tutucu olarak bırakıyor.)

5. Değiştirilmiş dosyayı kaydet - SaveDocumentRequest kaynak ve hedef yolları tanımlar.

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

Tam sınıflar ve özellikler listesi için, lütfen API referansı adresine bakın.

Ortamı Hazırlama

SDK’yı Maven projenize ekleyin:

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

Önkoşullar: Java 8 veya daha yeni bir sürüm, bir GroupDocs Cloud hesabı ve geçerli istemci kimlik bilgileri (AppSid ve AppKey). En son JAR dosyalarını indirme sayfasından indirin.

Excel Düzenleme Seçeneklerini Yapılandırma

SDK, yükleme ve kaydetme davranışını ince ayar yapmanıza olanak tanır:

1. Yükleme seçenekleri - Çalışma kitabının yalnızca okuma modunda açılıp açılmayacağını kontrol eder.

LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);

2. Kaydetme seçenekleri - Çıktı formatını (XLSX, CSV, vb.) ve formüllerin korunup korunmayacağını seçin.

SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);

3. Kimlik doğrulama ayarları - Gerekirse özel bir zaman aşımı veya proxy ayarlayabilirsiniz.

apiClient.setTimeout(120000); // 2 minutes

Bu seçenekler, daha önce gösterilen istek nesnelerine geçirilir.

Sonuç

Java’da REST üzerinden bir Excel sayfasını düzenlemek, GroupDocs.Editor Cloud SDK for Java ile oldukça basit hale gelir. SDK, REST çağrılarını soyutlayarak kimlik doğrulama, dosya depolama ve format inceliklerini arka planda yönetirken iş mantığına odaklanmanızı sağlar. Kod örneğini entegre ettikten sonra, çözümü toplu işleme, özel hücre stiline veya formül değerlendirmesine destek verecek şekilde genişletebilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma detayları ürün sayfasında mevcuttur ve geçici bir deneme lisansı geçici lisans sayfası üzerinden talep edilebilir. Excel iş akışlarınızı bugün otomatikleştirmeye başlayın ve Java uygulamalarınızda verimliliği artırın.

SSS

• Java’da GroupDocs.Editor kullanarak REST üzerinden bir Excel sayfasını nasıl düzenleyebilirim?
  SDK’nın loadDocument ve saveDocument metodlarını kod örneğinde gösterildiği gibi kullanın. Kütüphane REST iletişimini yönetir, bu yüzden yalnızca Java nesneleriyle çalışırsınız.

• REST API hangi kimlik doğrulama yöntemini gerektirir?
  API, OAuth2 istemci‑kimlik bilgileri akışını kullanır. AppSid ve AppKey ile bir erişim belirteci alın, ardından tüm çağrılar için Authorization: Bearer başlığına ekleyin. Ayrıntılar resmi belgelerde bulunur.

• Tek bir istekte birden fazla çalışma sayfasını düzenleyebilir miyim?
  Evet. Çalışma kitabını yükledikten sonra, her çalışma sayfası LoadResult içinde ayrı bir sayfa olarak görünür. Sayfalar üzerinde yineleme yapın, değişiklikleri uygulayın ve tüm düzenlemeleri kalıcı hale getirmek için saveDocument metodunu bir kez çağırın.

• Fiyatlandırma ve lisans bilgilerini nerede bulabilirim?
  Abonelik planları için ürünün ana sayfasını ve deneme anahtarı için geçici lisans sayfası ziyaret edin.

Daha Fazla Oku

• Java Kütüphanesi Kullanarak PowerPoint Dosyalarını Düzenle
• REST API Kullanarak Word veya Excel Belgelerini Düzenle
• Python’da REST API Kullanarak Excel Sayfasını Düzenle