L’automatisation de la conversion des dessins CAD en PDF est essentielle pour de nombreuses applications d’entreprise et SaaS qui doivent rendre, partager ou archiver des conceptions. Aspose.CAD Cloud SDK for Java fournit une bibliothèque puissante basée sur REST qui simplifie cette tâche pour les développeurs Java. Dans ce guide, vous verrez comment configurer le SDK, explorer ses fonctionnalités clés, configurer les options de performance et exécuter une conversion complète de DWT en PDF en utilisant à la fois du code Java et des commandes cURL.

Installation et configuration en Java

Cette section couvre tout ce dont vous avez besoin avant d’écrire du code.

  • Exigences système : Java 8 ou supérieur, Maven 3.5+, connectivité Internet pour les appels d’API.
  • Téléchargement : Obtenez la dernière bibliothèque depuis cette page.
  • Dépendance Maven
<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-cad-cloud</artifactId>
    <version>23.12</version>
</dependency>
  • Commande d’installation
mvn install com.aspose:aspose-cad-cloud
  • Obtenir une licence temporaire : Enregistrez‑vous sur la page de licence temporaire et notez l’ID client ainsi que le secret.

Conversion DWT en PDF via REST en Java

Le point de terminaison REST POST /cad/convert accepte un fichier DWT et renvoie un document PDF. Le corps de la requête comprend le nom du fichier source, le format de sortie souhaité (PDF) et des paramètres de conversion optionnels tels que le DPI de rasterisation et la gestion des calques. L’API traite le fichier dans le cloud, éliminant ainsi le besoin de moteurs de rendu locaux lourds.

Principales fonctionnalités d’Aspose.CAD Cloud SDK for Java

  • Prise en charge étendue des formats CAD : Gère DWT, DWG, DXF, DWF, et bien d’autres.
  • Sortie PDF de haute qualité : Conserve les épaisseurs de ligne, les couleurs et les calques.
  • Prise en charge du streaming : Téléversez de gros fichiers sans charger le fichier complet en mémoire.
  • Options de rendu personnalisables : Contrôlez le DPI, la taille de la page et la sortie vectorielle ou raster.
  • Traitement sécurisé dans le cloud : Toutes les données sont transmises via HTTPS avec authentification OAuth 2.0.

Configuration du SDK Aspose.CAD Cloud pour des performances optimales

Affinez la conversion en ajustant l’objet CadConversionOptions :

  • setDpi(int dpi) - Un DPI plus élevé améliore le détail mais augmente la taille du fichier.
  • setPageWidth(int width) / setPageHeight(int height) - Définit des dimensions de page explicites.
  • setLayers(String[] layers) - Convertit uniquement les calques sélectionnés pour réduire le temps de traitement.

Ces paramètres sont documentés dans la référence API.

Résolution des erreurs de conversion courantes

Erreur Cause possible Remède
401 Unauthorized Jeton d’accès invalide ou expiré Régénérez le jeton en utilisant vos informations d’identification client.
413 Payload Too Large Le fichier dépasse la limite de 100 Mo Divisez le dessin ou compressez-le avant le téléchargement.
500 Internal Server Error Entités non prises en charge dans le fichier DWT Supprimez les entités complexes ou simplifiez le dessin avant la conversion.

Étapes pour transformer les fichiers DWT en format PDF via l’API REST en Java

  1. Créer un client API : Initialise CadApi avec votre ID client et secret.
  2. Téléverser le fichier DWT : Utilisez uploadFile pour diffuser le fichier vers le stockage cloud.
  3. Définir les options de conversion : Configurez CadConversionOptions pour le DPI et la taille de page.
  4. Appeler le point de terminaison de conversion : Appelez convertDocument avec le nom du fichier source et "PDF" comme format cible.
  5. Télécharger le PDF : Récupérez le flux du fichier de sortie et enregistrez‑le localement.

Pour des informations détaillées sur les classes, consultez la page de référence CadApi.

Implémentation Java pour la conversion de fichiers DWT en PDF à l’aide de REST - Exemple de code complet

L’exemple suivant montre une conversion complète de bout en bout, incluant l’authentification, le téléchargement de fichier, la conversion et le téléchargement.

Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour les chemins de fichiers (input.dwt, output.pdf, etc.) pour qu’ils correspondent à vos emplacements réels, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Conversion de fichiers CAD à distance en PDF via l’API REST avec cURL

La même conversion peut être effectuée avec des commandes cURL simples, ce qui est utile pour des tests rapides ou l’intégration avec des services non‑Java.

  1. Obtenir un jeton d’accès
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. Téléverser le fichier 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. Demander la conversion en 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. Télécharger le PDF converti
curl -X GET "https://api.aspose.cloud/v3.0/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Pour plus de détails sur les charges utiles de la requête, consultez la documentation officielle de l’API.

Conclusion

La conversion de DWT en PDF à l’aide de REST en Java devient simple avec le Aspose.CAD Cloud SDK for Java. Le SDK gère l’authentification, le streaming de fichiers et le rendu haute qualité, tandis que l’API REST vous permet d’intégrer la conversion dans n’importe quel backend ou microservice basé sur Java. N’oubliez pas d’appliquer une licence valide pour la production ; vous pouvez acheter une licence complète ou obtenir une licence temporaire depuis la page de licence temporaire. Avec les étapes, le code et les exemples cURL fournis, vous êtes prêt à ajouter une conversion fiable de CAD en PDF à votre entreprise ou solution SaaS.

FAQ

Comment spécifier une taille de page personnalisée pour la sortie PDF ?
Utilisez les méthodes setPageWidth et setPageHeight sur l’objet CadConversionOptions. Les dimensions sont exprimées en points (1 pt = 1/72 pouce). Consultez la référence API pour la liste complète des options.

Que dois-je faire si la conversion renvoie une erreur 500 ?
Une erreur 500 indique généralement des entités non prises en charge dans le fichier DWT source. Simplifiez le dessin en supprimant les motifs de hachures complexes ou les objets 3D , ou exportez le dessin vers une version DWG antérieure avant de le télécharger. La documentation officielle fournit des indications sur les fonctionnalités prises en charge.

Puis-je convertir des fichiers DWT stockés dans un stockage cloud privé ?
Oui. Téléchargez le fichier vers le stockage Aspose Cloud en utilisant la méthode uploadFile ou la commande cURL correspondante, puis faites référence au chemin de stockage dans la demande de conversion. L’authentification est gérée par le même jeton OAuth 2.0.

Existe-t-il un moyen de convertir DWT en PDF sans écrire la sortie sur le disque ?
Le SDK et l’API REST peuvent tous deux renvoyer le PDF sous forme de flux (InputStream en Java). Vous pouvez acheminer ce flux directement vers un autre service ou le renvoyer au client sans le stocker sur le serveur.

En savoir plus