Converting complex 3D charts from an Excel workbook into a portable PDF file is a frequent need for reporting and sharing visual data. Aspose.Cells Cloud SDK for Java provides a powerful cloud‑based library that simplifies this task for Java developers. In this guide we walk through the entire 3D to PDF conversion in Java process, from preparing your environment to retrieving the final document. You’ll see a detailed code walkthrough, a complete example, and equivalent cURL commands for REST API integration.
Setting Up Aspose.Cells Cloud SDK for Java
Before you start, make sure you have the following:
- Java 17 or newer installed.
- Maven or Gradle for dependency management.
- An Aspose Cloud account with Client Id and Client Secret.
- Access to the internet for cloud calls.
Add the SDK to your project with the Maven dependency shown below and download the latest JAR from the official download page.
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-cells-cloud</artifactId>
<version>26.7</version>
</dependency>
You can also obtain the library directly from the download URL.
Configure the client with your credentials. This snippet is taken directly from the full example.
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
// Optional: config.setBasePath("https://api.aspose.cloud"); // default
With the configuration in place, you are ready to start the conversion workflow.
3D to PDF Conversion in Java - Step‑By‑Step Walkthrough
Step 1: Upload Excel Workbook to Cloud Storage
First, upload the XLSX file that contains the 3D charts. The FilesApi handles the upload.
FilesUploadResult uploadResult = filesApi.uploadFile("", new File(localInputPath));
if (uploadResult == null || uploadResult.getUploaded().isEmpty()) {
System.err.println("Upload failed.");
return;
}
Step 2: Prepare PDF Save Options
Fine‑tune the PDF output by enabling font caching, image compression, and memory optimization. These options help keep the PDF size low while preserving the 3D visual quality.
PdfSaveOptions pdfOptions = new PdfSaveOptions();
pdfOptions.setCacheFont(true);
pdfOptions.setCompressImages(true);
pdfOptions.setImageQuality(80);
pdfOptions.setEnableMemoryOptimization(true);
Step 3: Convert Workbook to PDF
Call the postWorkbookSaveAs method of CellsApi to perform the conversion. The API reference for this method is available in the 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)
Step 4: Download the Resulting PDF
After a successful conversion, download the PDF bytes and write them to a local file.
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);
Step 5: Optional Cleanup
Remove the temporary files from cloud storage to keep your account tidy.
filesApi.deleteFile(remoteInputName, null, null);
filesApi.deleteFile(remoteOutputName, null, null);
Full Java Implementation for 3D to PDF Conversion - Complete Code Example
The following example demonstrates the end‑to‑end conversion of a 3D Excel workbook to PDF using 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) {
}
}
}
}
Note: This code example demonstrates the core functionality. Before using it in your project, make sure to update the file paths (
input.xlsx,output.pdf, etc.) to match your actual file locations, verify that all required dependencies are properly installed, and test thoroughly in your development environment. If you encounter any issues, please refer to the official documentation or reach out to the support team for assistance.
REST API Conversion via cURL using Aspose.Cells Cloud
If you prefer a language‑agnostic approach, the same conversion can be performed with simple cURL commands against the Aspose.Cells Cloud REST API.
1. Authenticate and obtain an access token
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"
The response contains an access_token that you will use in subsequent calls.
2. Upload the source XLSX file
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. Convert the workbook to 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 the generated PDF
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.pdf
These commands perform the same 3D to PDF conversion in Java workflow without writing any Java code. For more details, see the official API documentation.
Conclusion
By following the steps above, you can reliably convert 3D Excel workbooks into high‑quality PDF files using Aspose.Cells Cloud SDK for Java. The library handles the heavy lifting of rendering 3D diagrams, while the PDF save options let you control size and performance. Remember to secure a proper license for production use; pricing details are available on the product page and a temporary license can be obtained from the temporary license page. With this knowledge, you’re ready to integrate 3D to PDF conversion into your Java applications and deliver polished reports to end users.
FAQs
-
How do I implement 3D to PDF conversion in Java with Aspose.Cells?
Use the SDK to upload your XLSX file, configurePdfSaveOptions, callpostWorkbookSaveAs, and download the resulting PDF. The full code sample in this article shows the exact sequence. -
Is there a way to perform 3D Diagram PDF conversion in Java without writing code?
Yes, the REST API and the cURL commands provided let you achieve the same result from any platform that can make HTTP requests. -
What is the difference between 3D Visualization PDF conversion and standard Excel to PDF conversion?
3D visualizations require additional rendering of chart objects, which the SDK handles automatically. Standard conversion may skip these 3D rendering steps, leading to missing graphics. -
Can I use the same workflow for java Excel to PDF conversion of non‑3D workbooks?
Absolutely. The same API calls work for any Excel file; you simply omit or adjust the 3D‑specific options if they are not needed.