Konvertering af komplekse 3D diagrammer fra en Excel-projektmappe til en bærbar PDF fil er et hyppigt behov for rapportering og deling af visuelle data. Aspose.Cells Cloud SDK for Java leverer et kraftfuldt cloud‑baseret bibliotek, der forenkler denne opgave for Java‑udviklere. I denne vejledning gennemgår vi hele processen med at konvertere 3D til PDF i Java, fra forberedelse af dit miljø til hentning af det endelige dokument. Du vil se en detaljeret kodegennemgang, et komplet eksempel og tilsvarende cURL‑kommandoer til REST‑API‑integration.
Opsætning af Aspose.Cells Cloud SDK for Java
Før du starter, skal du sikre dig, at du har følgende:
- Java 17 eller nyere installeret.
- Maven eller Gradle til afhængighedsstyring.
- En Aspose Cloud‑konto med Client Id og Client Secret.
- Adgang til internettet for cloud‑opkald.
Tilføj SDK’en til dit projekt med Maven-afhængigheden vist nedenfor, og download den nyeste JAR fra den officielle downloadside.
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-cells-cloud</artifactId>
<version>26.7</version>
</dependency>
Du kan også hente biblioteket direkte fra download-URL.
Konfigurer klienten med dine legitimationsoplysninger. Dette kodeudsnit er taget direkte fra det fulde eksempel.
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
// Optional: config.setBasePath("https://api.aspose.cloud"); // default
Med konfigurationen på plads er du klar til at starte konverteringsarbejdsgangen.
3D til PDF‑konvertering i Java - Trin‑for‑trin gennemgang
Trin 1: Upload Excel-arbejdsbog til Cloud-lagring
Først skal du uploade XLSX filen, der indeholder 3D-diagrammerne. FilesApi håndterer uploaden.
FilesUploadResult uploadResult = filesApi.uploadFile("", new File(localInputPath));
if (uploadResult == null || uploadResult.getUploaded().isEmpty()) {
System.err.println("Upload failed.");
return;
}
Trin 2: Forbered PDF-gemningsindstillinger
Finjuster PDF‑outputtet ved at aktivere skrifttypecaching, billedkomprimering og hukommelsesoptimering. Disse indstillinger hjælper med at holde PDF‑størrelsen lav, mens den 3D‑visuelle kvalitet bevares.
PdfSaveOptions pdfOptions = new PdfSaveOptions();
pdfOptions.setCacheFont(true);
pdfOptions.setCompressImages(true);
pdfOptions.setImageQuality(80);
pdfOptions.setEnableMemoryOptimization(true);
Trin 3: Konverter arbejdsbog til PDF
Kald postWorkbookSaveAs-metoden på CellsApi for at udføre konverteringen. API-referencen for denne metode er tilgængelig i Aspose.Cells API Reference.
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)
Trin 4: Download den resulterende PDF
Efter en vellykket konvertering downloades PDF‑byterne, og de skrives til en lokal fil.
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);
Trin 5: Valgfri oprydning
Fjern de midlertidige filer fra cloud‑lagringen for at holde din konto ryddelig.
filesApi.deleteFile(remoteInputName, null, null);
filesApi.deleteFile(remoteOutputName, null, null);
Fuld Java-implementering for 3D til PDF-konvertering - Komplet kodeeksempel
Det følgende eksempel demonstrerer den ende‑til‑ende konvertering af en 3D Excel‑arbejdsbog til PDF ved hjælp af Aspose.Cells Cloud SDK for Java.
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) {
}
}
}
}
Bemærk: Dette kodeeksempel demonstrerer kernefunktionaliteten. Før du bruger det i dit projekt, skal du sikre dig, at du opdaterer filstierne (
input.xlsx,output.pdfosv.) så de matcher dine faktiske filplaceringer, verificere at alle nødvendige afhængigheder er korrekt installeret, og teste grundigt i dit udviklingsmiljø. Hvis du støder på problemer, så se venligst den officielle dokumentation eller kontakt supportteamet for assistance.
REST API‑konvertering via cURL ved hjælp af Aspose.Cells Cloud
Hvis du foretrækker en sprog‑agnostisk tilgang, kan den samme konvertering udføres med enkle cURL‑kommandoer mod Aspose.Cells Cloud REST API.
1. Godkend og få en adgangstoken
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"
Svaret indeholder en access_token, som du vil bruge i efterfølgende kald.
2. Upload kildefilen XLSX
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. Konverter arbejdsbogen til PDF
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. Download den genererede PDF
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.pdf
Disse kommandoer udfører den samme 3D til PDF konvertering i Java arbejdsproces uden at skrive nogen Java‑kode. For flere detaljer, se den officielle API-dokumentation(den officielle API-dokumentation).
Konklusion
Ved at følge trinnene ovenfor kan du pålideligt konvertere 3D Excel-arbejdsbøger til PDF-filer af høj kvalitet ved hjælp af Aspose.Cells Cloud SDK for Java. Biblioteket håndterer den tunge løftning ved rendering af 3D-diagrammer, mens PDF‑gemningsindstillingerne giver dig kontrol over størrelse og ydeevne. Husk at sikre en korrekt licens til produktionsbrug; prisoplysninger er tilgængelige på produktsiden, og en midlertidig licens kan fås fra midlertidig licensside. Med denne viden er du klar til at integrere 3D‑til‑PDF‑konvertering i dine Java‑applikationer og levere polerede rapporter til slutbrugerne.
FAQs
-
Hvordan implementerer jeg 3D til PDF-konvertering i Java med Aspose.Cells?
Brug SDK’en til at uploade din XLSX-fil, konfigurerPdfSaveOptions, kaldpostWorkbookSaveAs, og download den resulterende PDF. Det komplette kodeeksempel i denne artikel viser den nøjagtige sekvens. -
Er der en måde at udføre 3D Diagram PDF-konvertering i Java uden at skrive kode?
Ja, REST API’et og de medfølgende cURL-kommandoer giver dig mulighed for at opnå det samme resultat fra enhver platform, der kan foretage HTTP-anmodninger. -
Hvad er forskellen mellem 3D-visualisering PDF-konvertering og standard Excel til PDF-konvertering?
3D-visualiseringer kræver ekstra rendering af diagramobjekter, som SDK’en håndterer automatisk. Standardkonvertering kan springe disse 3D-renderings trin over, hvilket kan føre til manglende grafik. -
Kan jeg bruge den samme arbejdsproces til java Excel til PDF-konvertering af ikke‑3D-arbejdsbøger?
Absolut. De samme API‑kald fungerer for enhver Excel‑fil; du skal blot udelade eller justere de 3D‑specifikke indstillinger, hvis de ikke er nødvendige.