Η μετατροπή σύνθετων διαγραμμάτων 3D από ένα βιβλίο εργασίας Excel σε ένα φορητό αρχείο PDF είναι συχνή ανάγκη για αναφορές και κοινή χρήση οπτικών δεδομένων. Το Aspose.Cells Cloud SDK for Java παρέχει μια ισχυρή βιβλιοθήκη βασισμένη στο cloud που απλοποιεί αυτήν την εργασία για προγραμματιστές Java. Σε αυτόν τον οδηγό, θα περάσουμε βήμα‑βήμα από τη διαδικασία μετατροπής 3D σε PDF σε Java, από την προετοιμασία του περιβάλλοντος μέχρι την ανάκτηση του τελικού εγγράφου. Θα δείτε μια λεπτομερή περιήγηση στον κώδικα, ένα πλήρες παράδειγμα και ισοδύναμες εντολές cURL για ενσωμάτωση του REST API.

Ρύθμιση του Aspose.Cells Cloud SDK για Java

Πριν ξεκινήσετε, βεβαιωθείτε ότι έχετε τα εξής:

  • Εγκατεστημένο Java 17 ή νεότερο.
  • Maven ή Gradle για διαχείριση εξαρτήσεων.
  • Ένας λογαριασμός Aspose Cloud με Client Id και Client Secret.
  • Πρόσβαση στο διαδίκτυο για κλήσεις στο cloud.

Προσθέστε το SDK στο έργο σας με την εξάρτηση Maven που φαίνεται παρακάτω και κατεβάστε το πιο πρόσφατο JAR από την επίσημη σελίδα λήψης.

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-cells-cloud</artifactId>
    <version>26.7</version>
</dependency>

Μπορείτε επίσης να αποκτήσετε τη βιβλιοθήκη απευθείας από το URL λήψης.

Διαμορφώστε τον πελάτη με τα διαπιστευτήριά σας. Αυτό το απόσπασμα λαμβάνεται απευθείας από το πλήρες παράδειγμα.

Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
// Optional: config.setBasePath("https://api.aspose.cloud"); // default

Με τη διαμόρφωση στη θέση της, είστε έτοιμοι να ξεκινήσετε τη ροή εργασίας μετατροπής.

Μετατροπή 3D σε PDF σε Java - Οδηγός βήμα‑βήμα

Βήμα 1: Ανεβάστε το βιβλίο εργασίας Excel στο Cloud Storage

Πρώτα, ανεβάστε το αρχείο XLSX που περιέχει τα 3D διαγράμματα. Το FilesApi διαχειρίζεται τη μεταφόρτωση.

FilesUploadResult uploadResult = filesApi.uploadFile("", new File(localInputPath));
if (uploadResult == null || uploadResult.getUploaded().isEmpty()) {
    System.err.println("Upload failed.");
    return;
}

Βήμα 2: Προετοιμασία επιλογών αποθήκευσης PDF

Ρυθμίστε προσεκτικά την έξοδο PDF ενεργοποιώντας την προσωρινή αποθήκευση γραμματοσειρών, τη συμπίεση εικόνων και τη βελτιστοποίηση μνήμης. Αυτές οι επιλογές βοηθούν στη διατήρηση του μικρού μεγέθους του PDF ενώ διατηρούν την οπτική ποιότητα 3D.

PdfSaveOptions pdfOptions = new PdfSaveOptions();
pdfOptions.setCacheFont(true);
pdfOptions.setCompressImages(true);
pdfOptions.setImageQuality(80);
pdfOptions.setEnableMemoryOptimization(true);

Βήμα 3: Μετατροπή Φύλλου Εργασίας σε PDF

Καλέστε τη μέθοδο postWorkbookSaveAs του CellsApi για να εκτελέσετε τη μετατροπή. Η αναφορά API για αυτή τη μέθοδο είναι διαθέσιμη στο 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)

Βήμα 4: Λήψη του παραγόμενου PDF

Μετά από μια επιτυχημένη μετατροπή, κατεβάστε τα bytes του 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);

Βήμα 5: Προαιρετικός καθαρισμός

Αφαιρέστε τα προσωρινά αρχεία από το αποθηκευτικό χώρο του cloud για να διατηρήσετε τον λογαριασμό σας τακτοποιημένο.

filesApi.deleteFile(remoteInputName, null, null);
filesApi.deleteFile(remoteOutputName, null, null);

Πλήρης Υλοποίηση Java για Μετατροπή 3D σε PDF - Παράδειγμα Πλήρους Κώδικα

Το παρακάτω παράδειγμα δείχνει τη μετατροπή από άκρο σε άκρο ενός τρισδιάστατου βιβλίου εργασίας Excel σε PDF χρησιμοποιώντας το 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) {
            }
        }
    }
}

Σημείωση: Αυτό το παράδειγμα κώδικα δείχνει τη βασική λειτουργικότητα. Πριν το χρησιμοποιήσετε στο έργο σας, βεβαιωθείτε ότι έχετε ενημερώσει τις διαδρομές αρχείων (input.xlsx, output.pdf, κ.λπ.) ώστε να ταιριάζουν με τις πραγματικές τοποθεσίες των αρχείων σας, επαληθεύστε ότι όλες οι απαιτούμενες εξαρτήσεις είναι σωστά εγκατεστημένες και δοκιμάστε εκτενώς στο περιβάλλον ανάπτυξής σας. Εάν αντιμετωπίσετε προβλήματα, παρακαλούμε ανατρέξτε στην επίσημη τεκμηρίωση ή επικοινωνήστε με την ομάδα υποστήριξης για βοήθεια.

Μετατροπή REST API μέσω cURL χρησιμοποιώντας Aspose.Cells Cloud

Αν προτιμάτε μια γλώσσα‑απαθής προσέγγιση, η ίδια μετατροπή μπορεί να εκτελεστεί με απλές εντολές cURL εναντίον του Aspose.Cells Cloud REST API.

1. Επικυρώστε και λάβετε ένα διακριτικό πρόσβασης

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"

Η απάντηση περιέχει ένα access_token το οποίο θα χρησιμοποιήσετε σε επόμενες κλήσεις.

2. Ανεβάστε το αρχικό αρχείο 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. Μετατρέψτε το βιβλίο εργασίας σε 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. Λήψη του παραγόμενου PDF

curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Αυτές οι εντολές εκτελούν την ίδια μετατροπή 3D σε PDF σε Java ροή εργασίας χωρίς να γράψετε κώδικα Java. Για περισσότερες λεπτομέρειες, δείτε την επίσημη τεκμηρίωση API.

Συμπέρασμα

Ακολουθώντας τα παραπάνω βήματα, μπορείτε αξιόπιστα να μετατρέψετε βιβλία εργασίας Excel 3D σε αρχεία PDF υψηλής ποιότητας χρησιμοποιώντας Aspose.Cells Cloud SDK for Java. Η βιβλιοθήκη διαχειρίζεται το βαρέως φορτίου rendering των 3D διαγραμμάτων, ενώ οι επιλογές αποθήκευσης PDF σας επιτρέπουν να ελέγχετε το μέγεθος και την απόδοση. Θυμηθείτε να εξασφαλίσετε μια κατάλληλη άδεια για χρήση σε παραγωγή· οι λεπτομέρειες τιμολόγησης είναι διαθέσιμες στη σελίδα του προϊόντος και μια προσωρινή άδεια μπορεί να ληφθεί από τη σελίδα προσωρινής άδειας. Με αυτή τη γνώση, είστε έτοιμοι να ενσωματώσετε τη μετατροπή 3D σε PDF στις εφαρμογές Java σας και να παραδώσετε επαγγελματικές αναφορές στους τελικούς χρήστες.

Συχνές ερωτήσεις

  • Πώς μπορώ να υλοποιήσω τη μετατροπή 3D σε PDF σε Java με Aspose.Cells;
    Χρησιμοποιήστε το SDK για να ανεβάσετε το αρχείο XLSX, διαμορφώστε το PdfSaveOptions, καλέστε το postWorkbookSaveAs και κατεβάστε το παραγόμενο PDF. Το πλήρες παράδειγμα κώδικα σε αυτό το άρθρο δείχνει την ακριβή ακολουθία.

  • Υπάρχει τρόπος να εκτελέσετε μετατροπή PDF διαγράμματος 3D σε Java χωρίς να γράψετε κώδικα;
    Ναι, το REST API και οι εντολές cURL που παρέχονται σας επιτρέπουν να επιτύχετε το ίδιο αποτέλεσμα από οποιαδήποτε πλατφόρμα που μπορεί να κάνει HTTP αιτήματα.

  • Ποια είναι η διαφορά μεταξύ της μετατροπής PDF με 3D Visualization και της τυπικής μετατροπής Excel σε PDF;
    Οι 3D οπτικοποιήσεις απαιτούν πρόσθετη απόδοση των αντικειμένων γραφήματος, την οποία το SDK διαχειρίζεται αυτόματα. Η τυπική μετατροπή μπορεί να παραλείψει αυτά τα βήματα απόδοσης 3D, οδηγώντας σε ελλιπείς γραφικά.

  • Μπορώ να χρησιμοποιήσω την ίδια ροή εργασίας για τη μετατροπή java Excel σε PDF μη‑3Δ βιβλίων εργασίας;
    Απόλυτα. Οι ίδιες κλήσεις API λειτουργούν για οποιοδήποτε αρχείο Excel· απλώς παραλείπετε ή προσαρμόζετε τις επιλογές που αφορούν το 3Δ εάν δεν χρειάζονται.

Διαβάστε Περισσότερα