Excel dosyalarını programlı olarak düzenlemek, veri odaklı Java uygulamaları geliştirirken sıkça ihtiyaç duyulan bir gereksinimdir; özellikle raporları güncellemeniz veya anlık olarak dinamik elektronik tablolar oluşturmanız gerektiğinde. GroupDocs.Editor Cloud SDK for Java düşük seviyeli dosya formatlarıyla uğraşmadan XLSX çalışma kitaplarını yönetmenizi sağlayan güçlü bir REST‑tabanlı kütüphane sunar. Bu rehberde, Java projelerinize Excel düzenlemeyi entegre etmek için tam bir Java kod örneği, eşdeğer cURL komutları, kurulum adımları ve yapılandırma seçeneklerini göreceksiniz.
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.
- Erişim belirteci alın
YOUR_CLIENT_IDveYOUR_CLIENT_SECRETdeğ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"
- 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
- 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": {}
}'
- 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ı:
API istemcisini yapılandırın -
ApiClientnesnesi 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");Editor API örneğini oluşturun -
EditorApiloadDocumentvesaveDocumentgibi yöntemler sağlar.EditorApi editorApi = new EditorApi(apiClient);Excel çalışma kitabını yükleyin -
LoadDocumentRequestdosya adını belirtir; yanıt sayfa (çalışma sayfası) bilgilerini içerir.
LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
LoadResult loadResult = editorApi.loadDocument(loadRequest);
Ç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.)
Değiştirilmiş dosyayı kaydet -
SaveDocumentRequestkaynak 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:
- 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);
- 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);
- 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ınloadDocumentvesaveDocumentmetodları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.AppSidveAppKeyile bir erişim belirteci alın, ardından tüm çağrılar içinAuthorization: Bearerbaş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ıLoadResultiç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çinsaveDocumentmetodunu 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.