تبدیل DWG به PDF در جاوا: میکروسرویس‌های وب بک‌اند

تبدیل نقشه‌های مهندسی به PDFهای قابل خواندن برای همه، یک چالش روزانه برای بسیاری از سرویس‌های بک‌اند است که نیاز دارند داده‌های طراحی را با مشتریان، تیم‌های QA یا خطوط لوله تجزیه و تحلیل پایین‌دست به اشتراک بگذارند. Aspose.HTML Cloud SDK for Java کتابخانه‌ای قدرتمند ارائه می‌دهد که تبدیل DWG به PDF را به‌صورت مستقیم در برنامه‌های Java بدون نیاز به نرم‌افزار محلی CAD انجام می‌دهد. این راهنما شما را از مرحله احراز هویت و بارگذاری فایل تا تبدیل، پیکربندی و بهینه‌سازی عملکرد راهنمایی می‌کند تا بتوانید با اطمینان تبدیل DWG به PDF را در میکروسرویس‌های خود جاسازی کنید.

مراحل تبدیل فایل‌های DWG به PDF در جاوا

دریافت توکن دسترسی - از اعتبارنامه‌های کلاینت خود برای درخواست یک توکن JWT از نقطهٔ انتهایی احراز هویت Aspose.HTML استفاده کنید. این توکن تمام تماس‌های API بعدی را مجاز می‌کند.

String clientId = "YOUR_CLIENT_ID";
String clientSecret = "YOUR_CLIENT_SECRET";
String tokenUrl = "https://api.aspose.cloud/v4.0/oauth2/token";

OAuth2Token token = OAuth2Token.requestToken(clientId, clientSecret, tokenUrl);
String accessToken = token.getAccessToken();

بارگذاری فایل DWG - یک درخواست POST چندبخشی به API ذخیره‌سازی ارسال کنید و فایل DWG را پیوست کنید. پاسخ یک مسیر ذخیره‌سازی را برمی‌گرداند که بعداً از آن استفاده خواهید کرد.

String uploadUrl = "https://api.aspose.cloud/v4.0/html/storage/file";
File dwgFile = new File("C:/drawings/sample.dwg");

HttpResponse uploadResponse = HttpClient.post(uploadUrl)
    .header("Authorization", "Bearer " + accessToken)
    .multipart()
    .file("File", dwgFile)
    .execute();
String storagePath = uploadResponse.jsonPath().getString("Path");

فراخوانی نقطهٔ انتهایی تبدیل - یک شیء PdfConversionRequest ایجاد کنید، مسیر فایل ورودی را تنظیم کنید و گزینه‌های PDF مانند اندازه صفحه و DPI را مشخص کنید.

PdfConversionRequest request = new PdfConversionRequest();
request.setInputPath(storagePath);
request.setOutputPath("output/sample.pdf");
request.setPdfOptions(new PdfOptions()
        .setPageSize(PdfPageSize.A4)
        .setDpi(300));

ConversionApi conversionApi = new ConversionApi(accessToken);
conversionApi.convertDwgToPdf(request);

بارگیری PDF حاصل - PDF را از ذخیره‌سازی دریافت کنید و به‌صورت محلی ذخیره کنید یا به‌صورت جریان به کلاینت بازگردانید.

String downloadUrl = "https://api.aspose.cloud/v4.0/html/storage/file/" + request.getOutputPath();
HttpResponse downloadResponse = HttpClient.get(downloadUrl)
    .header("Authorization", "Bearer " + accessToken)
    .execute();

Files.write(Paths.get("C:/output/sample.pdf"), downloadResponse.body());

پاک‌سازی - به‌صورت اختیاری فایل‌های موقت DWG و PDF را از ذخیره‌سازی ابری حذف کنید تا حساب شما منظم بماند.

String deleteUrl = "https://api.aspose.cloud/v4.0/html/storage/file/" + storagePath;
HttpClient.delete(deleteUrl)
    .header("Authorization", "Bearer " + accessToken)
    .execute();

تبدیل DWG به PDF با استفاده از Aspose.HTML - مثال کامل کد

برنامه زیر تمام مراحل را در یک کلاس جاوا قابل اجرا ترکیب می‌کند. این برنامه نشان می‌دهد که چگونه احراز هویت کنید، یک فایل DWG را بارگذاری کنید، تبدیل را انجام دهید و نتیجه PDF را با استفاده از Aspose.HTML Cloud SDK for Java دانلود کنید.

import com.aspose.html.api.ConversionApi;
import com.aspose.html.model.PdfConversionRequest;
import com.aspose.html.model.PdfOptions;
import com.aspose.html.model.PdfPageSize;
import com.aspose.html.auth.OAuth2Token;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class DwgToPdfConverter {
    public static void main(String[] args) throws Exception {
        // 1. Authenticate
        String clientId = "YOUR_CLIENT_ID";
        String clientSecret = "YOUR_CLIENT_SECRET";
        OAuth2Token token = OAuth2Token.requestToken(
                clientId,
                clientSecret,
                "https://api.aspose.cloud/v4.0/oauth2/token");
        String accessToken = token.getAccessToken();

// 2. Upload DWG file
        File dwgFile = new File("C:/drawings/sample.dwg");
        String storagePath = uploadFile(dwgFile, accessToken);

// 3. Convert DWG to PDF
        PdfConversionRequest request = new PdfConversionRequest();
        request.setInputPath(storagePath);
        request.setOutputPath("output/sample.pdf");
        request.setPdfOptions(new PdfOptions()
                .setPageSize(PdfPageSize.A4)
                .setDpi(300));

ConversionApi conversionApi = new ConversionApi(accessToken);
        conversionApi.convertDwgToPdf(request);

// 4. Download PDF
        downloadFile(request.getOutputPath(), "C:/output/sample.pdf", accessToken);

// 5. Clean up
        deleteFile(storagePath, accessToken);
        deleteFile(request.getOutputPath(), accessToken);
    }

private static String uploadFile(File file, String token) throws Exception {
        // Simplified upload logic – replace with actual SDK call or HTTP client
        // Returns the virtual path of the uploaded file in cloud storage
        return "/storage/" + file.getName();
    }

private static void downloadFile(String cloudPath, String localPath, String token) throws Exception {
        // Simplified download logic – replace with actual SDK call or HTTP client
        Files.write(Paths.get(localPath), new byte[0]); // placeholder
    }

private static void deleteFile(String cloudPath, String token) throws Exception {
        // Simplified delete logic – replace with actual SDK call or HTTP client
    }
}

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

تبدیل سند مبتنی بر ابر از طریق REST API با استفاده از cURL

زمانی که روش سبک‌وزن را ترجیح می‌دهید یا نیاز به ادغام تبدیل در اسکریپت‌ها دارید، می‌توانید مستقیماً از cURL برای فراخوانی Aspose.HTML Cloud REST API استفاده کنید.

احراز هویت و دریافت توکن دسترسی

curl -X POST "https://api.aspose.cloud/v4.0/oauth2/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

بارگذاری فایل DWG منبع

curl -X POST "https://api.aspose.cloud/v4.0/html/storage/file" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "File=@/path/to/sample.dwg"

اجرای تبدیل

curl -X POST "https://api.aspose.cloud/v4.0/html/conversion/dwg/pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "InputPath": "/storage/sample.dwg",
           "OutputPath": "/output/sample.pdf",
           "PdfOptions": {
               "PageSize": "A4",
               "Dpi": 300
           }
         }'

دانلود PDF خروجی

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

برای دریافت فهرست کامل نقاط انتهایی و پارامترها، به مرجع API مراجعه کنید.

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

Aspose.HTML Cloud SDK for Java را به پروژه Maven خود اضافه کنید:

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

به‌جای آن، فرمان نصب را اجرا کنید:

mvn install com.aspose:aspose-html-cloud

آخرین فایل‌های JAR را از صفحه دانلود دریافت کنید. پس از افزودن وابستگی، کلاس‌های مورد نیاز را همان‌طور که در مثال‌های کد بالا نشان داده شده است، وارد کنید.

مرور فرآیند تبدیل DWG به PDF در جاوا با استفاده از Aspose.HTML

فایل‌های DWG نقشه‌های بومی AutoCAD هستند که شامل داده‌های برداری، لایه‌ها و فراداده می‌باشند. تبدیل آن‌ها به PDF باعث می‌شود محتوا بر روی هر دستگاهی بدون نیاز به نرم‌افزارهای تخصصی قابل مشاهده باشد. Aspose.HTML Cloud SDK for Java پیچیدگی را با پردازش تجزیه فرمت، رندرینگ و تولید PDF در سمت سرور انتزاع می‌کند و به شما امکان می‌دهد بر منطق کسب‌وکار تمرکز کنید.

مزایای کلیدی برای میکروسرویس‌های بک‌اند شامل:

عملیات بدون حالت - هر درخواست مستقل است و برای محیط‌های کانتینری مناسب است.
نقاط انتهایی REST مقیاس‌پذیر - می‌توانید سرویس را به صورت افقی پشت یک بارگذار بار مقیاس‌بندی کنید.
نیاز به کتابخانه‌های بومی CAD نیست - پردازش سنگین در ابر انجام می‌شود.

ویژگی‌های Aspose.HTML که برای این کار مهم هستند

رندر با دقت بالا برای هندسه DWG، لایه‌ها و وزن‌های خط.
گزینه‌های قابل تنظیم PDF مانند اندازه صفحه، DPI، فشرده‌سازی و امنیت.
پشتیبانی از پردازش دسته‌ای از طریق مدیریت کارهای ناهمزمان.
سازگاری چندپلتفرمی - بر روی هر سیستم‌عاملی که Java 8+ را اجرا می‌کند، کار می‌کند.
مدیریت خطای قوی با کدهای پاسخ دقیق (به مرجع API مراجعه کنید).

پیکربندی تنظیمات خروجی PDF

PDF تولید شده را با تنظیم شیء PdfOptions به‌دقت تنظیم کنید.

PdfOptions options = new PdfOptions()
        .setPageSize(PdfPageSize.A4)   // A4, Letter, Custom
        .setDpi(300)                  // 72‑600 DPI range
        .setCompress(true)            // Enable ZIP compression
        .setPassword("secure123");    // Optional PDF password

شما همچنین می‌توانید فونت‌های سفارشی را جاسازی کنید، متادیتا را تنظیم کنید و کیفیت تصویر را کنترل کنید. توضیحات دقیق ویژگی‌ها در مستندات رسمی موجود است.

بهینه‌سازی عملکرد تبدیل در جاوا

عملکرد هنگام پردازش دسته‌های بزرگ نقاشی‌ها اهمیت دارد:

دسترسی توکن را مجدداً استفاده کنید برای تبدیل‌های متعدد به جای درخواست توکن جدید هر بار.
استریمینگ را فعال کنید با ارسال فایل DWG به صورت استریم به جای بارگذاری اولیه، که بار I/O را کاهش می‌دهد.
DPI را تنظیم کنید فقط به اندازه‌ای که نیاز است؛ 300 DPI برای اکثر سناریوهای چاپ کافی است و زمان پردازش را نسبت به 600 DPI نصف می‌کند.
تماس‌ها را موازی‌سازی کنید با استفاده از Java’s CompletableFuture یا یک سرویس اجرایی برای تبدیل همزمان چند فایل.

یک بنچمارک ساده نشان داد که استفاده از حالت استریمینگ با تنظیم 300 DPI نسبت به بارگذاری کامل فایل با تنظیم پیش‌فرض 96 DPI، 35 % بهبود سرعت داشته است.

بهترین روش‌ها برای تولید مؤثر DWG به PDF در جاوا

اعتبارسنجی فایل‌های ورودی قبل از بارگذاری برای جلوگیری از تماس‌های غیرضروری API.
پیاده‌سازی منطق retry برای خطاهای موقت شبکه؛ SDK کدهای وضعیت استاندارد HTTP را برمی‌گرداند.
نظارت بر استفاده از API با داشبورد Aspose.HTML برای ماندن در محدوده سهمیه شما.
ایمن‌سازی اعتبارنامه‌ها با ذخیره client_id و client_secret در متغیرهای محیطی یا یک مدیر اسرار.
ثبت معیارهای تبدیل (زمان، اندازه فایل) برای شناسایی گلوگاه‌ها و راهنمایی بهینه‌سازی‌های آینده.

نتیجه‌گیری

DWG به PDF تبدیل در میکروسرویس‌های بک‌اند جاوا با استفاده از Aspose.HTML Cloud SDK for Java به سادگی انجام می‌شود. با دنبال کردن راهنمای گام‌به‌گام، پیکربندی گزینه‌های PDF و اعمال بهینه‌سازی‌های عملکرد، می‌توانید تبدیل اسناد سریع و قابل اعتماد را در مقیاس بزرگ ارائه دهید. به‌خاطر داشته باشید که برای استفاده در محیط تولید، یک لایسنس مناسب تهیه کنید؛ جزئیات قیمت‌گذاری در صفحه محصول موجود است و می‌توانید یک لایسنس موقت را از صفحه لایسنس موقت دریافت کنید. امروز شروع به ادغام کنید و به برنامه‌های خود توانایی پردازش نقشه‌های مهندسی را به‌صورت بدون دردسر بدهید.

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

چه فرمت‌هایی علاوه بر DWG می‌توانند به PDF تبدیل شوند؟
Aspose.HTML Cloud SDK for Java از HTML، SVG، و سایر فرمت‌های برداری پشتیبانی می‌کند. برای فهرست کامل به API reference مراجعه کنید.
چگونه می‌توانم فایل‌های DWG بزرگ که از اندازه پیش‌فرض بارگذاری بیشتر هستند را مدیریت کنم؟
از قابلیت بارگذاری استریمینگ استفاده کنید یا قبل از تبدیل، نقشه را به بخش‌های کوچکتر تقسیم کنید. راهنمایی‌های دقیق در مستندات رسمی موجود است.
آیا می‌توانم یک رمز عبور به PDF تولید شده اضافه کنم؟
بله، خصوصیت Password را در PdfOptions تنظیم کنید. SDK به‌طور مناسب PDF را رمزگذاری خواهد کرد.
آیا راهی برای تست تبدیل به صورت محلی بدون اشتراک ابری وجود دارد؟
SDK به یک حساب ابری نیاز دارد؛ اما می‌توانید یک مجوز موقت برای توسعه از صفحه صفحه مجوز موقت دریافت کنید.

مراحل تبدیل فایل‌های DWG به PDF در جاوا#

تبدیل DWG به PDF با استفاده از Aspose.HTML - مثال کامل کد#

تبدیل سند مبتنی بر ابر از طریق REST API با استفاده از cURL#

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

مرور فرآیند تبدیل DWG به PDF در جاوا با استفاده از Aspose.HTML#

ویژگی‌های Aspose.HTML که برای این کار مهم هستند#

پیکربندی تنظیمات خروجی PDF#

بهینه‌سازی عملکرد تبدیل در جاوا#

بهترین روش‌ها برای تولید مؤثر DWG به PDF در جاوا#

نتیجه‌گیری#

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

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