Az összetett 3D diagramok Excel-munkafüzetből hordozható PDF fájlba konvertálása gyakori igény a jelentéskészítéshez és a vizuális adatok megosztásához. Aspose.Cells Cloud SDK for Java egy erőteljes felhőalapú könyvtárat biztosít, amely egyszerűsíti ezt a feladatot a Java fejlesztők számára. Ebben az útmutatóban végigvezetjük a teljes 3D‑ról PDF‑re konvertálási folyamatot Java‑ban, a környezet előkészítésétől a végső dokumentum lekéréséig. Megtekint egy részletes kódlépés‑áttekintést, egy teljes példát, valamint a REST API integrációhoz ekvivalens cURL parancsokat.

Aspose.Cells Cloud SDK for Java beállítása

Mielőtt elkezdené, győződjön meg arról, hogy a következőkkel rendelkezik:

  • Java 17 vagy újabb telepítve.
  • Maven vagy Gradle a függőségkezeléshez.
  • Egy Aspose Cloud fiók Client Id és Client Secret értékekkel.
  • Internetkapcsolat a felhőhívásokhoz.

Adja hozzá az SDK‑t a projektjéhez az alább látható Maven függőséggel, és töltse le a legújabb JAR‑t a hivatalos letöltési oldalról.

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

A könyvtárat közvetlenül a letöltési URL is letöltheti.

Állítsa be a klienst a hitelesítő adataival. Ez a kódrészlet közvetlenül a teljes példából származik.

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

A konfiguráció beállítása után készen állsz a konverziós munkafolyamat elindítására.

3D PDF konvertálás Java-ban - Lépésről‑lépésre útmutató

1. lépés: Excel munkafüzet feltöltése a felhő tárolóba

Először töltse fel a XLSX fájlt, amely 3D diagramokat tartalmaz. A FilesApi kezeli a feltöltést.

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

2. lépés: PDF mentési beállítások előkészítése

Finomhangolja a PDF kimenetet a betűkészlet gyorsítótárazásának, a képtömörítésnek és a memóriaoptimalizálásnak a engedélyezésével. Ezek a beállítások segítenek alacsonyan tartani a PDF méretét, miközben megőrzik a 3D vizuális minőséget.

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

3. lépés: Munkafüzet PDF-be konvertálása

Hívja meg a postWorkbookSaveAs metódust a CellsApi‑ban a konverzió végrehajtásához. Ennek a metódusnak az API‑referenciája elérhető az Aspose.Cells API Reference oldalon.

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. lépés: A létrehozott PDF letöltése

Sikeres konvertálás után töltse le a PDF bájtokat, és írja őket egy helyi fájlba.

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. lépés: Opcionális takarítás

Távolítsa el az ideiglenes fájlokat a felhő tárolóból, hogy fiókját rendezett állapotban tartsa.

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

Teljes Java megvalósítás 3D PDF konvertáláshoz - Teljes kódpélda

Az alábbi példa bemutatja egy 3D Excel munkafüzet végponttól‑végpontig tartó átalakítását PDF formátumba az Aspose.Cells Cloud SDK for Java használatával.

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) {
            }
        }
    }
}

Megjegyzés: Ez a kódrészlet bemutatja az alapvető funkciókat. Mielőtt a projektjében használná, győződjön meg róla, hogy frissíti a fájl útvonalakat (input.xlsx, output.pdf, stb.) a tényleges helyeknek megfelelően, ellenőrizze, hogy minden szükséges függőség megfelelően telepítve van-e, és alaposan tesztelje a fejlesztői környezetben. Ha problémákba ütközik, kérjük, tekintse meg a hivatalos dokumentációt vagy lépjen kapcsolatba a támogatási csapattal segítségért.

REST API konverzió cURL használatával az Aspose.Cells Cloud segítségével

Ha inkább nyelvfüggetlen megközelítést részesít előnyben, ugyanaz a konverzió egyszerű cURL parancsokkal hajtható végre az Aspose.Cells Cloud REST API használatával.

1. Hitelesítsen és szerezzen hozzáférési tokent

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"

A válasz egy access_token-t tartalmaz, amelyet a későbbi hívásokban fog használni.

2. Töltse fel a forrás XLSX fájlt

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. A munkafüzet PDF-re konvertálása

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. Töltse le a generált PDF-et

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

Ezek a parancsok ugyanazt a 3D PDF konverziót Java-ban végzik anélkül, hogy Java kódot írnának. További részletekért tekintse meg a hivatalos API dokumentációt.

Következtetés

A fenti lépések követésével megbízhatóan konvertálhatja a 3D Excel munkafüzeteket magas minőségű PDF fájlokká a Aspose.Cells Cloud SDK for Java használatával. A könyvtár elvégzi a 3D diagramok renderelésének nehéz részét, míg a PDF mentési beállítások lehetővé teszik a méret és a teljesítmény szabályozását. Ne felejtse el megfelelő licencet biztosítani a termelési használathoz; az árak részletei elérhetők a termékoldalon, és ideiglenes licencet szerezhet a ideiglenes licenc oldal címről. Ezzel a tudással készen áll arra, hogy beépítse a 3D‑ról PDF‑re konvertálást Java alkalmazásaiba, és kifinomult jelentéseket nyújtson a végfelhasználóknak.

Gyakran Ismételt Kérdések

  • Hogyan valósítható meg a 3D PDF konvertálás Java-ban az Aspose.Cells segítségével?
    Használja az SDK-t az XLSX fájl feltöltéséhez, konfigurálja a PdfSaveOptions-t, hívja a postWorkbookSaveAs-t, és töltse le a keletkezett PDF-et. A cikkben található teljes kódminta pontosan bemutatja a sorrendet.

  • Van-e mód 3D Diagram PDF konvertálásra Java-ban kód írása nélkül?
    Igen, a megadott REST API és a cURL parancsok lehetővé teszik, hogy ugyanazt az eredményt elérje bármely platformon, amely HTTP kéréseket tud küldeni.

  • Mi a különbség a 3D vizualizációs PDF konverzió és a szabványos Excel PDF konverzió között?
    A 3D vizualizációkhoz további diagramobjektumok renderelése szükséges, amelyet az SDK automatikusan kezel. A szabványos konverzió kihagyhatja ezeket a 3D renderelési lépéseket, ami hiányzó grafikákhoz vezet.

  • Használhatom ugyanazt a munkafolyamatot a java Excel PDF konvertáláshoz nem‑3D munkafüzetek esetén?
    Természetesen. Ugyanazok a API hívások működnek bármely Excel fájl esetén; egyszerűen kihagyhatja vagy módosíthatja a 3D‑specifikus beállításokat, ha nincs rájuk szükség.

További információk