Automatizzare la conversione di disegni CAD in PDF è fondamentale per molte applicazioni aziendali e SaaS che necessitano di visualizzare, condividere o archiviare i progetti. Aspose.CAD Cloud SDK for Java offre una potente libreria basata su REST che semplifica questo compito per gli sviluppatori Java. In questa guida, vedrai come configurare l’SDK, esplorare le sue funzionalità chiave, impostare le opzioni di prestazione e eseguire una conversione completa da DWT a PDF utilizzando sia il codice Java sia i comandi cURL.

Installazione e Configurazione in Java

Questa sezione copre tutto ciò di cui hai bisogno prima di scrivere il codice.

  • Requisiti di sistema: Java 8 o superiore, Maven 3.5+, connettività Internet per le chiamate API.
  • Download: Ottieni l’ultima libreria da questa pagina.
  • Dipendenza Maven
<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-cad-cloud</artifactId>
    <version>23.12</version>
</dependency>
  • Comando di installazione
mvn install com.aspose:aspose-cad-cloud

Conversione DWT in PDF usando REST in Java

L’endpoint REST POST /cad/convert accetta un file DWT e restituisce un documento PDF. Il corpo della richiesta include il nome del file di origine, il formato di output desiderato (PDF) e impostazioni di conversione opzionali come DPI di rasterizzazione e gestione dei layer. L’API elabora il file nel cloud, eliminando la necessità di motori di rendering locali pesanti.

Caratteristiche principali di Aspose.CAD Cloud SDK per Java

  • Ampio supporto per formati CAD: Gestisce DWT, DWG, DXF, DWF, e molti altri.
  • Output PDF di alta qualità: Preserva spessori delle linee, colori e livelli.
  • Supporto allo streaming: Carica file di grandi dimensioni senza caricare l’intero file in memoria.
  • Opzioni di rendering personalizzabili: Controlla DPI, dimensione della pagina e output vettoriale vs raster.
  • Elaborazione sicura nel cloud: Tutti i dati sono trasmessi via HTTPS con autenticazione OAuth 2.0.

Configurazione di Aspose.CAD Cloud SDK per prestazioni ottimali

Ottimizza la conversione regolando l’oggetto CadConversionOptions:

  • setDpi(int dpi) - Un DPI più alto migliora i dettagli ma aumenta le dimensioni del file.
  • setPageWidth(int width) / setPageHeight(int height) - Definisce dimensioni di pagina esplicite.
  • setLayers(String[] layers) - Converti solo i layer selezionati per ridurre il tempo di elaborazione.

Queste impostazioni sono documentate nel riferimento API.

Risoluzione dei problemi comuni di conversione

Errore Possibile causa Soluzione
401 Unauthorized Token di accesso non valido o scaduto Rigenera il token usando le credenziali del client.
413 Payload Too Large Il file supera il limite di 100 MB Dividi il disegno o comprimilo prima del caricamento.
500 Internal Server Error Entità non supportate nel file DWT Rimuovi le entità complesse o semplifica il disegno prima della conversione.

Passaggi per trasformare i file DWT in formato PDF tramite REST API in Java

  1. Crea un client API: Inizializza CadApi con il tuo ID client e segreto.
  2. Carica il file DWT: Usa uploadFile per trasmettere il file allo storage cloud.
  3. Imposta le opzioni di conversione: Configura CadConversionOptions per DPI e dimensione della pagina.
  4. Chiama l’endpoint di conversione: Invoca convertDocument con il nome del file di origine e "PDF" come formato di destinazione.
  5. Scarica il PDF: Recupera lo stream del file di output e salvalo localmente.

Per informazioni dettagliate sulla classe, vedere la pagina di riferimento CadApi.

Implementazione Java per la conversione di file DWT in PDF usando REST - Esempio di codice completo

Il seguente esempio dimostra una conversione completa end‑to‑end, includendo l’autenticazione, il caricamento del file, la conversione e il download.

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (input.dwt, output.pdf, ecc.) per corrispondere alle tue effettive posizioni dei file, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Conversione remota di file CAD in PDF tramite REST API usando cURL

La stessa conversione può essere eseguita con semplici comandi cURL, utili per test rapidi o per l’integrazione con servizi non‑Java.

  1. Ottieni un token di accesso
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"
  1. Carica il file DWT
curl -X PUT "https://api.aspose.cloud/v3.0/storage/file/input.dwt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@input.dwt"
  1. Richiedi la conversione in PDF
curl -X POST "https://api.aspose.cloud/v3.0/cad/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "inputPath": "input.dwt",
           "outputPath": "output.pdf",
           "outputFormat": "PDF",
           "options": {
               "dpi": 300,
               "pageWidth": 2100,
               "pageHeight": 2970
           }
         }'
  1. Scarica il PDF convertito
curl -X GET "https://api.aspose.cloud/v3.0/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Per ulteriori dettagli sui payload delle richieste, consultare la documentazione ufficiale dell’API.

Conclusione

Convertire DWT in PDF usando REST in Java diventa semplice con l’Aspose.CAD Cloud SDK for Java. L’SDK gestisce l’autenticazione, lo streaming dei file e il rendering ad alta qualità, mentre l’API REST consente di integrare la conversione in qualsiasi backend o microservizio basato su Java. Ricorda di applicare una licenza valida per l’uso in produzione; puoi acquistare una licenza completa o ottenere una temporanea dalla pagina della licenza temporanea. Con i passaggi, il codice e gli esempi cURL forniti, sei pronto ad aggiungere una conversione CAD‑to‑PDF affidabile alla tua impresa o soluzione SaaS.

FAQ

Come specificare una dimensione di pagina personalizzata per l’output PDF?
Utilizzare i metodi setPageWidth e setPageHeight sull’oggetto CadConversionOptions. Le dimensioni sono espresse in punti (1 pt = 1/72 pollice). Consultare la riferimento API per l’elenco completo delle opzioni.

Cosa devo fare se la conversione restituisce un errore 500?
Un errore 500 indica solitamente entità non supportate nel file DWT di origine. Semplifica il disegno rimuovendo pattern di tratteggio complessi o oggetti 3D, oppure esporta il disegno a una versione DWG precedente prima di caricarlo. La documentazione ufficiale fornisce indicazioni sulle funzionalità supportate.

Posso convertire i file DWT archiviati in uno storage cloud privato?
Sì. Carica il file nello storage cloud di Aspose usando il metodo uploadFile o il comando cURL corrispondente, quindi fai riferimento al percorso di storage nella richiesta di conversione. L’autenticazione è gestita dallo stesso token OAuth 2.0.

C’è un modo per convertire DWT in PDF senza scrivere l’output su disco?
Sia l’SDK che la REST API possono restituire il PDF come stream (InputStream in Java). È possibile indirizzare questo stream direttamente a un altro servizio o inviarlo al client senza persisterlo sul server.

Leggi di più