Cách thực hiện chuyển đổi DWT sang PDF bằng REST trong Java

Tự động chuyển đổi các bản vẽ CAD sang PDF là điều cần thiết cho nhiều ứng dụng doanh nghiệp và SaaS cần hiển thị, chia sẻ hoặc lưu trữ thiết kế. Aspose.CAD Cloud SDK for Java cung cấp một thư viện dựa trên REST mạnh mẽ, giúp đơn giản hoá công việc này cho các nhà phát triển Java. Trong hướng dẫn này, bạn sẽ thấy cách thiết lập SDK, khám phá các tính năng chính, cấu hình các tùy chọn hiệu năng và thực hiện chuyển đổi toàn bộ DWT sang PDF bằng cả mã Java và lệnh cURL.

Cài đặt và Thiết lập trong Java

Phần này bao gồm mọi thứ bạn cần trước khi viết mã.

System Requirements: Java 8 hoặc cao hơn, Maven 3.5+, kết nối internet để gọi API.
Download: Tải thư viện mới nhất từ trang này.
Maven Dependency

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

Lệnh Cài đặt

mvn install com.aspose:aspose-cad-cloud

Nhận Giấy phép Tạm thời: Đăng ký tại trang giấy phép tạm thời và ghi lại client ID và secret.

Chuyển đổi DWT sang PDF bằng REST trong Java

Endpoint REST POST /cad/convert chấp nhận tệp DWT và trả về tài liệu PDF. Thân yêu cầu bao gồm tên tệp nguồn, định dạng đầu ra mong muốn (PDF), và các cài đặt chuyển đổi tùy chọn như DPI rasterization và xử lý lớp. API xử lý tệp trên đám mây, loại bỏ nhu cầu sử dụng các engine render nặng cục bộ.

Các tính năng chính của Aspose.CAD Cloud SDK cho Java

Broad CAD Format Support: Xử lý DWT, DWG, DXF, DWF, và nhiều định dạng khác.
High‑Quality PDF Output: Giữ nguyên độ dày đường, màu sắc và lớp.
Streaming Support: Tải lên các tệp lớn mà không cần tải toàn bộ tệp vào bộ nhớ.
Customizable Rendering Options: Kiểm soát DPI, kích thước trang và đầu ra vector so với raster.
Secure Cloud Processing: Tất cả dữ liệu được truyền qua HTTPS với xác thực OAuth 2.0.

Cấu hình Aspose.CAD Cloud SDK để đạt hiệu suất tối ưu

Tinh chỉnh quá trình chuyển đổi bằng cách điều chỉnh đối tượng CadConversionOptions:

setDpi(int dpi) - DPI cao hơn cải thiện chi tiết nhưng làm tăng kích thước tệp.
setPageWidth(int width) / setPageHeight(int height) - Xác định kích thước trang một cách rõ ràng.
setLayers(String[] layers) - Chỉ chuyển đổi các lớp đã chọn để giảm thời gian xử lý.

Các cài đặt này được tài liệu hoá trong API reference.

Khắc phục các lỗi chuyển đổi thường gặp

Lỗi	Nguyên nhân có thể	Giải pháp
401 Unauthorized	Token truy cập không hợp lệ hoặc đã hết hạn	Tạo lại token bằng thông tin xác thực client của bạn.
413 Payload Too Large	Tệp vượt quá giới hạn 100 MB	Tách bản vẽ hoặc nén nó trước khi tải lên.
500 Internal Server Error	Các thực thể không được hỗ trợ trong tệp DWT	Loại bỏ các thực thể phức tạp hoặc đơn giản hoá bản vẽ trước khi chuyển đổi.

Các bước chuyển đổi tệp DWT sang định dạng PDF thông qua REST API trong Java

Tạo client API: Khởi tạo CadApi với ID client và secret của bạn.
Tải lên tệp DWT: Sử dụng uploadFile để truyền luồng tệp lên lưu trữ đám mây.
Đặt tùy chọn chuyển đổi: Cấu hình CadConversionOptions cho DPI và kích thước trang.
Gọi endpoint chuyển đổi: Gọi convertDocument với tên tệp nguồn và "PDF" làm định dạng đích.
Tải xuống PDF: Lấy luồng tệp đầu ra và lưu nó cục bộ.

Để biết thông tin chi tiết về lớp, xem trang tham khảo CadApi.

Triển khai Java để Chuyển đổi Tệp DWT sang PDF bằng REST - Ví dụ mã đầy đủ

Ví dụ sau đây trình bày quá trình chuyển đổi toàn diện từ đầu đến cuối, bao gồm xác thực, tải lên tệp, chuyển đổi và tải xuống.

Lưu ý: Ví dụ mã này trình bày chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật các đường dẫn tệp (input.dwt, output.pdf, v.v.) để phù hợp với vị trí tệp thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Chuyển đổi tệp CAD từ xa sang PDF qua REST API bằng cURL

Việc chuyển đổi tương tự có thể được thực hiện bằng các lệnh cURL đơn giản, điều này hữu ích cho việc kiểm tra nhanh hoặc tích hợp với các dịch vụ không phải Java.

Lấy token truy cập

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ải lên tệp 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"

Yêu cầu chuyển đổi sang 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
           }
         }'

Tải xuống PDF đã chuyển đổi

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

Để biết thêm chi tiết về payload của yêu cầu, xem tài liệu API chính thức.

Kết luận

Việc chuyển đổi DWT sang PDF bằng REST trong Java trở nên đơn giản với Aspose.CAD Cloud SDK for Java. SDK xử lý xác thực, truyền luồng tệp và việc render chất lượng cao, trong khi REST API cho phép bạn tích hợp quá trình chuyển đổi vào bất kỳ backend hoặc microservice nào dựa trên Java. Hãy nhớ áp dụng giấy phép hợp lệ cho môi trường sản xuất; bạn có thể mua giấy phép đầy đủ hoặc lấy giấy phép tạm thời từ trang giấy phép tạm thời. Với các bước, mã và ví dụ cURL đã cung cấp, bạn đã sẵn sàng thêm chức năng chuyển đổi CAD‑to‑PDF đáng tin cậy vào giải pháp doanh nghiệp hoặc SaaS của mình.

Câu hỏi thường gặp

Làm thế nào để chỉ định kích thước trang tùy chỉnh cho đầu ra PDF?
Sử dụng các phương thức setPageWidth và setPageHeight trên đối tượng CadConversionOptions. Các kích thước được biểu diễn bằng điểm (1 pt = 1/72 inch). Tham khảo API reference để biết danh sách đầy đủ các tùy chọn.

Nếu quá trình chuyển đổi trả về lỗi 500, tôi nên làm gì?
Lỗi 500 thường cho biết có các thực thể không được hỗ trợ trong tệp DWT nguồn. Đơn giản hoá bản vẽ bằng cách loại bỏ các mẫu hatch phức tạp hoặc các đối tượng 3D, hoặc xuất bản vẽ sang phiên bản DWG cũ hơn trước khi tải lên. Tài liệu chính thức cung cấp hướng dẫn về các tính năng được hỗ trợ.

Tôi có thể chuyển đổi các tệp DWT được lưu trữ trong bộ nhớ đám mây riêng không?
Vâng. Tải tệp lên Aspose Cloud storage bằng phương thức uploadFile hoặc lệnh cURL tương ứng, sau đó tham chiếu đường dẫn lưu trữ trong yêu cầu chuyển đổi. Xác thực được thực hiện bằng cùng một token OAuth 2.0.

Có cách nào chuyển đổi DWT sang PDF mà không ghi đầu ra ra đĩa không?
Cả SDK và REST API đều có thể trả về PDF dưới dạng luồng (InputStream trong Java). Bạn có thể chuyển luồng này trực tiếp tới dịch vụ khác hoặc gửi lại cho client mà không cần lưu trữ trên máy chủ.

Cài đặt và Thiết lập trong Java#

Chuyển đổi DWT sang PDF bằng REST trong Java#

Các tính năng chính của Aspose.CAD Cloud SDK cho Java#

Cấu hình Aspose.CAD Cloud SDK để đạt hiệu suất tối ưu#

Khắc phục các lỗi chuyển đổi thường gặp#

Các bước chuyển đổi tệp DWT sang định dạng PDF thông qua REST API trong Java#

Triển khai Java để Chuyển đổi Tệp DWT sang PDF bằng REST - Ví dụ mã đầy đủ#

Chuyển đổi tệp CAD từ xa sang PDF qua REST API bằng cURL#

Kết luận#

Câu hỏi thường gặp#

Read More#