أتمتة تحويل رسومات CAD إلى PDF أمر أساسي للعديد من تطبيقات المؤسسات و SaaS التي تحتاج إلى عرض، مشاركة أو أرشفة التصاميم. يوفر Aspose.CAD Cloud SDK for Java مكتبة قوية تعتمد على REST تُبسّط هذه المهمة لمطوري Java. في هذا الدليل، ستتعرف على كيفية إعداد SDK، استكشاف ميزاته الرئيسية، تكوين خيارات الأداء، وتنفيذ تحويل كامل من DWT إلى PDF باستخدام كل من كود Java وأوامر cURL.

التثبيت والإعداد في Java

يغطي هذا القسم كل ما تحتاجه قبل كتابة الشيفرة.

  • متطلبات النظام: 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 في Java

نقطة النهاية REST POST /cad/convert تقبل ملف DWT وتعيد مستند PDF. يتضمن جسم الطلب اسم الملف المصدر، وتنسيق الإخراج المطلوب (PDF)، وإعدادات التحويل الاختيارية مثل DPI للتصوير النقطي ومعالجة الطبقات. تقوم الـ API بمعالجة الملف في السحابة، مما يلغي الحاجة إلى محركات عرض محلية ثقيلة.

الميزات الرئيسية لـ Aspose.CAD Cloud SDK for Java

  • دعم واسع لتنسيقات CAD: يتعامل مع DWT، DWG، DXF، DWF، والعديد غيرها.
  • إخراج PDF عالي الجودة: يحافظ على وزن الخطوط، الألوان، والطبقات.
  • دعم البث: تحميل ملفات كبيرة دون الحاجة إلى تحميل الملف بالكامل في الذاكرة.
  • خيارات عرض قابلة للتخصيص: التحكم في DPI، حجم الصفحة، والإخراج المتجهي مقابل النقطي.
  • معالجة سحابية آمنة: جميع البيانات تُنقل عبر HTTPS مع مصادقة OAuth 2.0.

تكوين Aspose.CAD Cloud SDK لتحقيق الأداء الأمثل

قم بضبط عملية التحويل بدقة عن طريق تعديل كائن CadConversionOptions:

  • setDpi(int dpi) - DPI الأعلى يحسّن التفاصيل لكنه يزيد حجم الملف.
  • setPageWidth(int width) / setPageHeight(int height) - تحديد أبعاد الصفحة بشكل صريح.
  • setLayers(String[] layers) - تحويل الطبقات المحددة فقط لتقليل وقت المعالجة.

تم توثيق هذه الإعدادات في مرجع API.

استكشاف الأخطاء الشائعة في التحويل

الخطأ السبب المحتمل الحل
401 Unauthorized رمز وصول غير صالح أو منتهي الصلاحية أعد إنشاء الرمز باستخدام بيانات اعتماد العميل الخاصة بك.
413 Payload Too Large الملف يتجاوز حد 100 ميغابايت قسّم الرسم أو ضغطه قبل الرفع.
500 Internal Server Error كيان غير مدعوم في ملف DWT أزل الكيانات المعقدة أو بسط الرسم قبل التحويل.

خطوات تحويل ملفات DWT إلى تنسيق PDF عبر REST API في Java

  1. إنشاء عميل API: تهيئة CadApi باستخدام معرف العميل والسر.
  2. تحميل ملف DWT: استخدم uploadFile لبث الملف إلى التخزين السحابي.
  3. تعيين خيارات التحويل: ضبط CadConversionOptions لدقة DPI وحجم الصفحة.
  4. استدعاء نقطة النهاية convert: استدعِ convertDocument مع اسم الملف المصدر و "PDF" كتنسيق الهدف.
  5. تنزيل ملف PDF: استرجع تدفق ملف الإخراج واحفظه محليًا.

للحصول على معلومات تفصيلية حول الفئات، راجع صفحة المرجع CadApi.

تنفيذ Java لتحويل ملفات DWT إلى PDF باستخدام REST - مثال كامل للكود

يوضح المثال التالي عملية تحويل شاملة من البداية إلى النهاية، بما في ذلك المصادقة، تحميل الملف، التحويل، والتنزيل.

ملاحظة: يعرض مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (input.dwt, output.pdf, إلخ) لتطابق مواقع الملفات الفعلية لديك، وتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

تحويل ملف CAD عن بُعد إلى PDF عبر REST API باستخدام cURL

يمكن تنفيذ نفس التحويل باستخدام أوامر cURL بسيطة، وهو مفيد للاختبار السريع أو التكامل مع الخدمات غير القائمة على Java.

  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"
  1. تحميل ملف 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. طلب التحويل إلى 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. تحميل ملف 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 في Java يصبح بسيطًا مع Aspose.CAD Cloud SDK for Java. يتعامل SDK مع المصادقة، تدفق الملفات، وعرض عالي الجودة، بينما يتيح لك REST API دمج التحويل في أي خلفية أو خدمة مصغرة مبنية على Java. تذكر تطبيق ترخيص صالح للاستخدام في الإنتاج؛ يمكنك شراء ترخيص كامل أو الحصول على ترخيص مؤقت من صفحة الترخيص المؤقت. مع الخطوات، الكود، وأمثلة cURL المقدمة، أنت جاهز لإضافة تحويل CAD‑to‑PDF موثوق إلى مؤسستك أو حل SaaS الخاص بك.

الأسئلة الشائعة

كيف يمكنني تحديد حجم صفحة مخصص لإخراج PDF؟
استخدم طريقتي setPageWidth و setPageHeight على كائن CadConversionOptions. الأبعاد معبر عنها بالنقاط (1 pt = 1/72 inch). راجع مرجع API للحصول على القائمة الكاملة للخيارات.

ما الذي يجب علي فعله إذا أعاد التحويل خطأ 500؟
عادةً ما يشير خطأ 500 إلى وجود كيانات غير مدعومة في ملف DWT المصدر. قم بتبسيط الرسم عن طريق إزالة أنماط التظليل المعقدة أو كائنات 3D ، أو صدّر الرسم إلى نسخة DWG أقدم قبل التحميل. توفر الوثائق الرسمية إرشادات حول الميزات المدعومة.

هل يمكنني تحويل ملفات DWT المخزنة في تخزين سحابي خاص؟
نعم. قم بتحميل الملف إلى Aspose Cloud storage باستخدام طريقة uploadFile أو أمر cURL المقابل، ثم أشر إلى مسار التخزين في طلب التحويل. يتم التعامل مع المصادقة باستخدام نفس OAuth 2.0 token.

هل هناك طريقة لتحويل DWT إلى PDF دون كتابة الناتج على القرص؟
كلا من SDK وREST API يمكنهما إرجاع PDF كتيار (InputStream في Java). يمكنك تمرير هذا التيار مباشرة إلى خدمة أخرى أو إرساله مرة أخرى إلى العميل دون حفظه على الخادم.

اقرأ المزيد