Az CAD rajzok PDF formátumba történő automatikus konvertálása elengedhetetlen sok vállalati és SaaS alkalmazás számára, amelyeknek meg kell jeleníteniük, megosztaniuk vagy archiválniuk a terveket. Az Aspose.CAD Cloud SDK for Java egy erőteljes REST‑alapú könyvtárat biztosít, amely leegyszerűsíti ezt a feladatot Java fejlesztők számára. Ebben az útmutatóban megmutatjuk, hogyan állítsuk be az SDK-t, fedezzük fel főbb funkcióit, konfiguráljuk a teljesítménybeállításokat, és hajtsunk végre egy teljes DWT PDF konverziót Java kóddal és cURL parancsokkal.
Telepítés és beállítás Java-ban
Ez a szakasz mindent lefed, amire a kód írása előtt szüksége van.
- Rendszerkövetelmények: Java 8 vagy újabb, Maven 3.5+, internetkapcsolat az API hívásokhoz.
- Letöltés: Szerezze be a legújabb könyvtárat erről az oldalról.
- Maven függőség
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-cad-cloud</artifactId>
<version>23.12</version>
</dependency>
- Telepítési parancs
mvn install com.aspose:aspose-cad-cloud
- Ideiglenes licenc beszerzése: Regisztráljon a ideiglenes licenc oldal és jegyezze fel a kliensazonosítót és a titkos kulcsot.
DWT to PDF konvertálás REST használatával Java-ban
A REST végpont POST /cad/convert elfogad egy DWT fájlt, és PDF dokumentumot ad vissza. A kérés törzse tartalmazza a forrásfájl nevét, a kívánt kimeneti formátumot (PDF), valamint opcionális konverziós beállításokat, mint például a rasterizálási DPI és a rétegkezelés. Az API a felhőben dolgozza fel a fájlt, így nincs szükség nehéz helyi renderelő motorokra.
Az Aspose.CAD Cloud SDK for Java főbb jellemzői
- Széles körű CAD formátum támogatás: Kezeli a DWT, DWG, DXF, DWF, és még sok más formátumot.
- Magas minőségű PDF kimenet: Megőrzi a vonalvastagságokat, színeket és rétegeket.
- Streaming támogatás: Nagy fájlok feltöltése anélkül, hogy a teljes fájlt a memóriába kellene betölteni.
- Testreszabható renderelési beállítások: DPI, oldalméret és vektor‑ vagy raszter kimenet szabályozása.
- Biztonságos felhőfeldolgozás: Minden adat HTTPS-en keresztül kerül továbbításra OAuth 2.0 hitelesítéssel.
Az Aspose.CAD Cloud SDK konfigurálása az optimális teljesítmény érdekében
Finomhangolja a konverziót a CadConversionOptions objektum beállításával:
setDpi(int dpi)- A magasabb DPI javítja a részleteket, de növeli a fájlméretet.setPageWidth(int width)/setPageHeight(int height)- Kifejezett oldalméretek meghatározása.setLayers(String[] layers)- Csak a kiválasztott rétegek konvertálása a feldolgozási idő csökkentése érdekében.
Ezek a beállítások az API-referencia dokumentációban szerepelnek.
Gyakori konverziós hibák hibaelhárítása
| Hiba | Lehetséges ok | Megoldás |
|---|---|---|
| 401 Unauthorized | Érvénytelen vagy lejárt hozzáférési token | Regenerálja a tokent a kliens hitelesítő adataival. |
| 413 Payload Too Large | A fájl meghaladja a 100 MB korlátot | Ossza fel a rajzot, vagy tömörítse feltöltés előtt. |
| 500 Internal Server Error | Nem támogatott entitások a DWT fájlban | Távolítsa el a komplex entitásokat, vagy egyszerűsítse a rajzot a konverzió előtt. |
Lépések a DWT fájlok PDF formátumba történő átalakításához REST API-n keresztül Java-ban
- API kliens létrehozása: Inicializálja a
CadApi-t a kliensazonosítóval és titkos kulccsal. - DWT fájl feltöltése: Használja az
uploadFile-t a fájl felhő tárolóba történő streameléséhez. - Átalakítási beállítások megadása: Állítsa be a
CadConversionOptions-t DPI és oldalméret szerint. - A konvertáló végpont meghívása: Hívja meg a
convertDocument-et a forrásfájl nevével és a"PDF"célformátummal. - A PDF letöltése: Szerezze meg a kimeneti fájl streamet és mentse helyileg.
A részletes osztályinformációkért tekintse meg a CadApi referencia oldalt.
Java megvalósítás DWT fájlok PDF-re konvertálásához REST használatával - Teljes kódpélda
Az alábbi példa egy teljes vég‑ponttól‑végig konverziót mutat be, beleértve a hitelesítést, a fájl feltöltését, a konvertálást és a letöltést.
Megjegyzés: Ez a kódpélda a fő funkciókat mutatja be. Mielőtt a projektjében használná, győződjön meg róla, hogy frissíti a fájl útvonalakat (
input.dwt,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, é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.
CAD fájl távoli átalakítása PDF-re REST API használatával cURL segítségével
Ugyanezt az átalakítást egyszerű cURL parancsokkal is elvégezhetjük, ami hasznos gyors teszteléshez vagy nem‑Java szolgáltatásokkal való integrációhoz.
- 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"
- Töltse fel a DWT fájlt
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"
- Kérje a PDF-re konvertálást
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
}
}'
- Töltse le a konvertált PDF-et
curl -X GET "https://api.aspose.cloud/v3.0/storage/file/output.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.pdf
A kérés payload-ekkel kapcsolatos további részletekért tekintse meg a hivatalos API dokumentációt.
Következtetés
A DWT PDF‑re konvertálása REST‑en keresztül Java‑ban egyszerűvé válik az Aspose.CAD Cloud SDK for Java segítségével. Az SDK kezeli a hitelesítést, a fájlfolyamot és a magas minőségű renderelést, míg a REST API lehetővé teszi a konverzió integrálását bármely Java‑alapú háttérrendszerbe vagy mikroszolgáltatásba. Ne feledje, hogy éles környezetben érvényes licencet alkalmazzon; teljes licencet vásárolhat, vagy ideiglenes licencet szerezhet be a ideiglenes licenc oldal segítségével. A megadott lépésekkel, kóddal és cURL példákkal készen áll arra, hogy megbízható CAD‑PDF konverziót adjon vállalkozásához vagy SaaS megoldásához.
FAQs
Hogyan adhatok meg egy egyéni oldalméretet a PDF kimenethez?
Használja a setPageWidth és a setPageHeight metódusokat a CadConversionOptions objektumon. A méretek pontban vannak megadva (1 pt = 1/72 hüvelyk). Tekintse meg a API referenciát a lehetőségek teljes listájáért.
Mit tegyek, ha a konverzió 500 hibát ad?
Az 500-as hiba általában azt jelzi, hogy a forrás DWT fájlban nem támogatott elemek vannak. Egyszerűsítse a rajzot úgy, hogy eltávolítja a bonyolult kitöltési mintákat vagy a 3D objektumokat, vagy exportálja a rajzot egy korábbi DWG verzióba a feltöltés előtt. A hivatalos dokumentáció útmutatást nyújt a támogatott funkciókról.
Konvertálhatok DWT fájlokat, amelyek privát felhő tárolóban vannak?
Igen. Töltsd fel a fájlt az Aspose Cloud tárolóba az uploadFile metódus vagy a megfelelő cURL parancs használatával, majd a konverziós kérésben hivatkozz a tárolási útvonalra. A hitelesítést ugyanaz a OAuth 2.0 token kezeli.
Van mód DWT-t PDF-re konvertálni anélkül, hogy a kimenetet lemezre írnánk?
Mind az SDK, mind a REST API vissza tudja adni a PDF-et egy adatfolyamként (InputStream Java-ban). Ezt az adatfolyamot közvetlenül továbbíthatja egy másik szolgáltatásnak, vagy visszaküldheti a kliensnek anélkül, hogy a szerveren tárolná.