Karmaşık 3D grafiklerini bir Excel çalışma kitabından taşınabilir bir PDF dosyasına dönüştürmek, raporlama ve görsel veri paylaşımı için sıkça ihtiyaç duyulan bir durumdur. Aspose.Cells Cloud SDK for Java Java geliştiricileri için bu görevi basitleştiren güçlü bir bulut‑tabanlı kütüphane sunar. Bu rehberde, ortamınızı hazırlamaktan son belgeyi almaya kadar Java’da 3D’den PDF’ye dönüşüm sürecinin tamamını adım adım inceleyeceğiz. Ayrıntılı bir kod yürütmesi, tam bir örnek ve REST API entegrasyonu için eşdeğer cURL komutlarını göreceksiniz.
Aspose.Cells Cloud SDK for Java Kurulumu
Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:
- Java 17 veya daha yeni bir sürüm yüklü.
- Bağımlılık yönetimi için Maven veya Gradle.
- Client Id ve Client Secret içeren bir Aspose Cloud hesabı.
- Bulut çağrıları için internete erişim.
SDK’yı projenize aşağıda gösterilen Maven bağımlılığıyla ekleyin ve resmi indirme sayfasından en son JAR’ı indirin.
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-cells-cloud</artifactId>
<version>26.7</version>
</dependency>
Kütüphaneyi doğrudan indirme URL’si edinebilirsiniz.
İstemciyi kimlik bilgilerinizle yapılandırın. Bu kod parçacığı tam örnekten doğrudan alınmıştır.
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
// Optional: config.setBasePath("https://api.aspose.cloud"); // default
Yapılandırma yerinde olduğunda, dönüşüm iş akışına başlamak için hazırsınız.
Java’da 3D’den PDF’ye Dönüştürme - Adım Adım Kılavuz
Adım 1: Excel Çalışma Kitabını Bulut Depolamaya Yükleyin
İlk olarak, 3D grafikler içeren XLSX dosyasını yükleyin. FilesApi yüklemeyi yönetir.
FilesUploadResult uploadResult = filesApi.uploadFile("", new File(localInputPath));
if (uploadResult == null || uploadResult.getUploaded().isEmpty()) {
System.err.println("Upload failed.");
return;
}
Adım 2: PDF Kaydetme Seçeneklerini Hazırlayın
PDF çıktısını, yazı tipi önbellekleme, görüntü sıkıştırma ve bellek optimizasyonunu etkinleştirerek ince‑ayar yapın. Bu seçenekler, PDF boyutunu düşük tutarken 3D görsel kalitesini korumaya yardımcı olur.
PdfSaveOptions pdfOptions = new PdfSaveOptions();
pdfOptions.setCacheFont(true);
pdfOptions.setCompressImages(true);
pdfOptions.setImageQuality(80);
pdfOptions.setEnableMemoryOptimization(true);
Adım 3: Çalışma Kitabını PDF’ye Dönüştür
Dönüşümü gerçekleştirmek için CellsApi’nin postWorkbookSaveAs metodunu çağırın. Bu metodun API referansı, Aspose.Cells API Referansı içinde mevcuttur.
WorkbookResponse convertResponse = cellsApi.postWorkbookSaveAs(
remoteInputName, // source workbook name
"pdf", // target format
remoteOutputName, // output path in cloud storage
pdfOptions, // save options
"", // folder (root)
null); // storage (default)
Adım 4: Oluşturulan PDF’yi İndir
Başarılı bir dönüşümden sonra, PDF baytlarını indirin ve yerel bir dosyaya yazın.
byte[] pdfBytes = filesApi.downloadFile(remoteOutputName);
try (FileOutputStream fos = new FileOutputStream(new File(localOutputPath))) {
fos.write(pdfBytes);
}
System.out.println("Conversion completed successfully. PDF saved to " + localOutputPath);
Adım 5: İsteğe Bağlı Temizlik
Geçici dosyaları bulut depolamadan kaldırarak hesabınızı düzenli tutun.
filesApi.deleteFile(remoteInputName, null, null);
filesApi.deleteFile(remoteOutputName, null, null);
Tam Java Uygulaması 3D’den PDF’ye Dönüştürme - Tam Kod Örneği
Aşağıdaki örnek, Aspose.Cells Cloud SDK for Java kullanarak 3D bir Excel çalışma kitabının PDF’ye uçtan uca dönüşümünü gösterir.
import com.aspose.cloud.cells.api.CellsApi;
import com.aspose.cloud.cells.api.FilesApi;
import com.aspose.cloud.cells.client.ApiException;
import com.aspose.cloud.cells.client.Configuration;
import com.aspose.cloud.cells.model.PdfSaveOptions;
import com.aspose.cloud.cells.model.FilesUploadResult;
import com.aspose.cloud.cells.model.WorkbookResponse;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
public class AsposeCells3DToPdfExample {
public static void main(String[] args) {
// -------------------- Configuration --------------------
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
// Optional: config.setBasePath("https://api.aspose.cloud"); // default
// -------------------- API Instances --------------------
CellsApi cellsApi = new CellsApi(config);
FilesApi filesApi = new FilesApi(config);
// -------------------- Local & Remote Paths --------------------
String localInputPath = "input.xlsx"; // Excel file containing 3D charts
String remoteInputName = "input.xlsx"; // Name used in cloud storage
String remoteOutputName = "output.pdf"; // Desired PDF name in cloud storage
String localOutputPath = "output.pdf"; // Where to save the downloaded PDF
try {
// -------------------- Upload Excel to Cloud --------------------
FilesUploadResult uploadResult = filesApi.uploadFile("", new File(localInputPath));
if (uploadResult == null || uploadResult.getUploaded().isEmpty()) {
System.err.println("Upload failed.");
return;
}
// -------------------- Prepare PDF Save Options (Performance) --------------------
PdfSaveOptions pdfOptions = new PdfSaveOptions();
pdfOptions.setCacheFont(true); // Cache fonts for faster processing
pdfOptions.setCompressImages(true); // Compress images to reduce size
pdfOptions.setImageQuality(80); // Balance quality and size
pdfOptions.setEnableMemoryOptimization(true); // Reduce memory footprint
// -------------------- Convert Workbook to PDF --------------------
WorkbookResponse convertResponse = cellsApi.postWorkbookSaveAs(
remoteInputName, // source workbook name
"pdf", // target format
remoteOutputName, // output path in cloud storage
pdfOptions, // save options
"", // folder (root)
null // storage (default)
);
if (convertResponse == null || convertResponse.getCode() != 200) {
System.err.println("Conversion failed.");
return;
}
// -------------------- Download Resulting PDF --------------------
byte[] pdfBytes = filesApi.downloadFile(remoteOutputName);
try (FileOutputStream fos = new FileOutputStream(new File(localOutputPath))) {
fos.write(pdfBytes);
}
System.out.println("Conversion completed successfully. PDF saved to " + localOutputPath);
} catch (ApiException | IOException e) {
e.printStackTrace();
} finally {
// -------------------- Optional Cleanup --------------------
try {
filesApi.deleteFile(remoteInputName, null, null);
filesApi.deleteFile(remoteOutputName, null, null);
} catch (ApiException ignored) {
}
}
}
}
Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce dosya yollarını (
input.xlsx,output.pdfvb.) gerçek dosya konumlarınıza göre 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 dokümantasyona bakın veya destek ekibi ile iletişime geçin.
cURL aracılığıyla Aspose.Cells Cloud kullanarak REST API Dönüştürmesi
Dil bağımsız bir yaklaşımı tercih ediyorsanız, aynı dönüşüm basit cURL komutlarıyla Aspose.Cells Cloud REST API’ye karşı gerçekleştirilebilir.
1. Kimlik doğrulaması yapın ve bir erişim belirteci alın
curl -X POST "https://api.aspose.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"
Yanıt, sonraki çağrılarda kullanacağınız bir access_token içerir.
2. Kaynak XLSX dosyasını yükleyin
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/input.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@input.xlsx"
3. Çalışma kitabını PDF’ye dönüştür
curl -X POST "https://api.aspose.cloud/v3.0/cells/input.xlsx/saveAs/pdf?outputPath=output.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"CacheFont": true,
"CompressImages": true,
"ImageQuality": 80,
"EnableMemoryOptimization": true
}'
4. Oluşturulan PDF’yi İndir
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.pdf
Bu komutlar, Java kodu yazmadan aynı Java’da 3D’den PDF’ye dönüşüm iş akışını gerçekleştirir. Daha fazla ayrıntı için, resmi API belgelerine bakın.
Sonuç
Yukarıdaki adımları izleyerek, Aspose.Cells Cloud SDK for Java kullanarak 3D Excel çalışma kitaplarını yüksek kaliteli PDF dosyalarına güvenilir bir şekilde dönüştürebilirsiniz. Kütüphane, 3D diyagramların oluşturulmasıyla ilgili ağır işleri hallederken, PDF kaydetme seçenekleri boyut ve performansı kontrol etmenizi sağlar. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma detayları ürün sayfasında mevcuttur ve geçici bir lisans geçici lisans sayfasından elde edilebilir. Bu bilgiyle, 3D’den PDF’ye dönüşümü Java uygulamalarınıza entegre etmeye ve son kullanıcılara şık raporlar sunmaya hazırsınız.
SSS
-
Java ile Aspose.Cells kullanarak 3D’den PDF’ye dönüşümü nasıl uygularım?
SDK’yı kullanarak XLSX dosyanızı yükleyin,PdfSaveOptions‘ı yapılandırın,postWorkbookSaveAs‘ı çağırın ve oluşan PDF’yi indirin. Bu makaledeki tam kod örneği kesin sıralamayı gösterir. -
Java’da kod yazmadan 3D Diyagram PDF dönüşümünü gerçekleştirmek mümkün mü?
Evet, sağlanan REST API ve cURL komutları, HTTP istekleri yapabilen herhangi bir platformdan aynı sonucu almanızı sağlar. -
3D Görselleştirme PDF dönüşümü ile standart Excel’ten PDF dönüşümü arasındaki fark nedir?
3D görselleştirmeler, grafik nesnelerinin ek render edilmesini gerektirir; bu, SDK tarafından otomatik olarak işlenir. Standart dönüşüm bu 3D render adımlarını atlayabilir ve eksik grafiklere yol açabilir. -
Java Excel’ten PDF dönüşümü için aynı iş akışını 3D olmayan çalışma kitaplarıyla kullanabilir miyim?
Kesinlikle. Aynı API çağrıları herhangi bir Excel dosyası için çalışır; sadece 3D’ye özgü seçenekleri ihtiyacınız yoksa atlayabilir veya ayarlayabilirsiniz.