نحوه انجام تبدیل DWT به PDF با استفاده از REST در جاوا

اتوماتیک‌سازی تبدیل نقشه‌های CAD به PDF برای بسیاری از برنامه‌های سازمانی و SaaS که نیاز به رندر، به اشتراک‌گذاری یا بایگانی طرح‌ها دارند، ضروری است. Aspose.CAD Cloud SDK for Java کتابخانه قدرتمند مبتنی بر REST را فراهم می‌کند که این کار را برای توسعه‌دهندگان جاوا ساده می‌سازد. در این راهنما، خواهید دید که چگونه SDK را تنظیم کنید، ویژگی‌های کلیدی آن را بررسی کنید، گزینه‌های عملکردی را پیکربندی کنید و تبدیل کامل DWT به PDF را با استفاده از کد جاوا و دستورات cURL اجرا کنید.

نصب و راه‌اندازی در جاوا

این بخش همه چیزهایی را که قبل از نوشتن کد نیاز دارید، پوشش می‌دهد.

• نیازمندی‌های سیستم: Java 8 یا بالاتر، Maven 3.5+، اتصال اینترنت برای فراخوانی‌های API.
• دانلود: آخرین کتابخانه را از این صفحه دریافت کنید.
• وابستگی Maven

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-cad-cloud</artifactId>
    <version>23.12</version>
</dependency>

• دستور نصب

mvn install com.aspose:aspose-cad-cloud

• دریافت لایسنس موقت: در صفحه صفحه لایسنس موقت ثبت‌نام کنید و شناسه مشتری و رمز را یادداشت کنید.

DWT به PDF تبدیل با استفاده از REST در جاوا

REST endpoint POST /cad/convert یک فایل DWT را می‌پذیرد و یک سند PDF برمی‌گرداند. بدنه درخواست شامل نام فایل منبع، فرمت خروجی مورد نظر (PDF) و تنظیمات اختیاری تبدیل مانند DPI رسترینگ و مدیریت لایه‌ها است. API فایل را در ابر پردازش می‌کند و نیاز به موتورهای رندرینگ سنگین محلی را از بین می‌برد.

ویژگی‌های کلیدی Aspose.CAD Cloud SDK برای Java

• Broad CAD Format Support: پشتیبانی گسترده از فرمت‌های CAD: پردازش DWT، DWG، DXF، DWF، و بسیاری دیگر.
• High‑Quality PDF Output: خروجی PDF با کیفیت بالا: وزن خطوط، رنگ‌ها و لایه‌ها را حفظ می‌کند.
• Streaming Support: پشتیبانی از استریمینگ: بارگذاری فایل‌های بزرگ بدون نیاز به بارگذاری کل فایل در حافظه.
• Customizable Rendering Options: گزینه‌های رندر قابل تنظیم: کنترل DPI، اندازه صفحه و خروجی برداری در مقابل رستر.
• Secure Cloud Processing: پردازش ایمن در ابر: تمام داده‌ها از طریق HTTPS با احراز هویت OAuth 2.0 منتقل می‌شوند.

پیکربندی Aspose.CAD Cloud SDK برای عملکرد بهینه

با تنظیم شیء CadConversionOptions تبدیل را به‌دقت تنظیم کنید:

• setDpi(int dpi) - DPI بالاتر جزئیات را بهبود می‌بخشد اما حجم فایل را افزایش می‌دهد.
• setPageWidth(int width) / setPageHeight(int height) - ابعاد صریح صفحه را تعریف کنید.
• setLayers(String[] layers) - فقط لایه‌های انتخاب‌شده را تبدیل کنید تا زمان پردازش کاهش یابد.

این تنظیمات در مرجع API مستند شده‌اند.

عیب‌یابی خطاهای رایج تبدیل

مراحل تبدیل فایل‌های DWT به فرمت PDF از طریق REST API در جاوا

1. یک کلاینت API ایجاد کنید: CadApi را با شناسه کلاینت و رمز عبور خود مقداردهی اولیه کنید.
2. فایل DWT را بارگذاری کنید: از uploadFile برای ارسال فایل به ذخیره‌سازی ابری استفاده کنید.
3. گزینه‌های تبدیل را تنظیم کنید: CadConversionOptions را برای DPI و اندازه صفحه پیکربندی کنید.
4. نقطه انتهایی تبدیل را فراخوانی کنید: convertDocument را با نام فایل منبع و “PDF” به عنوان فرمت هدف فراخوانی کنید.
5. PDF را دانلود کنید: جریان خروجی فایل را دریافت کنید و به صورت محلی ذخیره کنید.

برای اطلاعات دقیق درباره کلاس‌ها، صفحه مرجع CadApi را ببینید.

پیاده‌سازی جاوا برای تبدیل فایل‌های DWT به PDF با استفاده از REST - مثال کامل کد

مثال زیر یک تبدیل کامل انتها به انتها را نشان می‌دهد که شامل احراز هویت، بارگذاری فایل، تبدیل و دانلود است.

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید مسیرهای فایل (input.dwt، output.pdf و غیره) با مکان‌های واقعی فایل‌های شما مطابقت دارد، تأیید کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه نمایید.

تبدیل فایل CAD از راه دور به PDF با استفاده از REST API و cURL

همین تبدیل می‌تواند با دستورات ساده cURL انجام شود، که برای تست سریع یا یکپارچه‌سازی با سرویس‌های غیر‑جاوا مفید است.

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"

2. بارگذاری فایل 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"

3. درخواست تبدیل به 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
           }
         }'

4. دانلود PDF تبدیل‌شده

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

برای جزئیات بیشتر درباره بارهای درخواست، مستندات رسمی API را ببینید.

نتیجه‌گیری

تبدیل DWT به PDF با استفاده از REST در جاوا با Aspose.CAD Cloud SDK for Java به سادگی انجام می‌شود. این SDK احراز هویت، استریم فایل و رندرینگ با کیفیت بالا را مدیریت می‌کند، در حالی که REST API به شما امکان می‌دهد تبدیل را در هر بک‌اند یا میکروسرویسی مبتنی بر جاوا یکپارچه کنید. به‌خاطر داشته باشید که برای استفاده در محیط تولید یک لایسنس معتبر اعمال کنید؛ می‌توانید یک لایسنس کامل خریداری کنید یا یک لایسنس موقت از صفحه لایسنس موقت دریافت کنید. با گام‌ها، کد و مثال‌های cURL ارائه‌شده، آماده‌اید تا تبدیل CAD به PDF قابل اعتماد را به راه‌حل سازمانی یا SaaS خود اضافه کنید.

سؤالات متداول

چگونه می‌توانم اندازه صفحه سفارشی برای خروجی PDF مشخص کنم؟
از متدهای setPageWidth و setPageHeight در شیء CadConversionOptions استفاده کنید. ابعاد بر حسب پوینت (1 pt = 1/72 اینچ) بیان می‌شوند. برای فهرست کامل گزینه‌ها به مرجع API مراجعه کنید.

اگر تبدیل خطای 500 برگرداند، چه کار باید بکنم؟
خطای 500 معمولاً نشان‌دهنده موجودیت‌های پشتیبانی‌نشده در فایل DWT منبع است. برای ساده‌سازی نقشه، الگوهای هچ پیچیده یا اشیای 3D را حذف کنید، یا قبل از بارگذاری، نقشه را به نسخهٔ قدیمی‌تر DWG صادر کنید. مستندات رسمی راهنمایی درباره ویژگی‌های پشتیبانی‌شده ارائه می‌دهد.

آیا می‌توانم فایل‌های DWT ذخیره‌شده در یک فضای ذخیره‌سازی ابری خصوصی را تبدیل کنم؟
بله. فایل را با استفاده از متد uploadFile یا فرمان cURL مربوطه به فضای ذخیره‌سازی Aspose Cloud بارگذاری کنید، سپس مسیر ذخیره‌سازی را در درخواست تبدیل ارجاع دهید. احراز هویت توسط همان توکن OAuth 2.0 انجام می‌شود.

آیا راهی برای تبدیل DWT به PDF بدون نوشتن خروجی در دیسک وجود دارد؟
هر دو SDK و REST API می‌توانند PDF را به‌صورت یک جریان (InputStream در Java) بازگردانند. می‌توانید این جریان را مستقیماً به سرویس دیگری وصل کنید یا بدون ذخیره‌سازی بر روی سرور، به‌صورت مستقیم به کلاینت برگردانید.

بیشتر بخوانید

• تبدیل DWG به PDF | ذخیره DWG به JPG | تبدیل DWG به PNG با استفاده از C#
• REST API برای تبدیل چرخش یا چرخاندن فایل‌های AutoCAD DWG DXF DWF
• STL به BMP - تبدیل STL به BMP در C#