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
  • დროებითი ლიცენზიის მიღება: რეგისტრირდით დროებითი ლიცენზიის გვერდზე და გაითვალისწინეთ კლიენტის ID და საიდუმლო.

DWT to PDF კონვერსია REST-ის გამოყენებით Java-ში

REST endpoint POST /cad/convert იღებს DWT ფაილს და აბრუნებს PDF დოკუმენტს. მოთხოვნის სხეულში შედის წყაროს ფაილის სახელი, სასურველი გამოსავალის ფორმატი (PDF) და არასავალდებულო კონვერსიის პარამეტრები, როგორიცაა რასტერიზაციის DPI და ფენების დამუშავება. API ფაილს მუშაობს ღრუბლში, რაც იშლება მძიმე ადგილობრივ რენდერინგის სისტემების საჭიროება.

Aspose.CAD Cloud SDK for Java-ის ძირითადი ფუნქციები

  • CAD ფორმატების ფართო მხარდაჭერა: მუშაობს DWT, DWG, DXF, DWF, და სხვა მრავალ ფორმატზე.
  • PDF-ის მაღალი ხარისხის გამომავალი: შენარჩუნებს ხაზის სიგნალებს, ფერებს და ფენებს.
  • სტრიმინგის მხარდაჭერა: ატვირთეთ დიდი ფაილები, არ იტვირთოთ მთელი ფაილი მეხსიერებაში.
  • მორგებადი რენდერის პარამეტრები: აკონტროლეთ DPI, გვერდის ზომა, და ვექტორული vs. რასტერი გამომავალი.
  • უსაფრთხოების ღრუბლოვანი დამუშავება: ყველა მონაცემი გადაცემა 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 თქვენი კლიენტის ID და საიდუმლოთი (secret) გამოყენებით.
  2. DWT ფაილის ატვირთვა: გამოიყენეთ uploadFile ფაილის ნაკადის გადაცემა ღრუბლურ საცავში.
  3. გარდაქმნის პარამეტრების დაყენება: კონფიგურაცია CadConversionOptions DPI-სა და გვერდის ზომისთვის.
  4. გარდაქმნის endpoint-ის გამოძახება: გამოძახეთ convertDocument წყაროს ფაილის სახელით და მიზნის ფორმატით "PDF".
  5. PDF-ის გადმოწერა: მიიღეთ გამოტანის ფაილის ნაკადი და შეინახეთ ლოკალურად.

დეტალური კლასი ინფორმაციისთვის, იხილეთ CadApi მითითების გვერდი.

Java-ის განხორციელება DWT ფაილების PDF-ში გადაყვანისთვის REST-ის გამოყენებით - სრული კოდის მაგალითი

შემდეგი მაგალითი აჩვენებს სრულ end‑to‑end გადაყვანას, რომელიც მოიცავს აუტენტიფიკაციას, ფაილის ატვირთვას, გადაყვანას და გადმოწერას.

შენიშვნა: ეს კოდის მაგალითი აჩვენებს ძირითადი ფუნქციონირებას. თქვენს პროექტში მისი გამოყენებამდე, დარწმუნდით, რომ განაახლეთ ფაილების ბილიკები (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

მოთხოვნის payload-ებზე მეტი დეტალებისთვის, იხილეთ ოფიციალური API დოკუმენტაცია.

დასკვნა

DWT-ის PDF-ში გადაყვანა REST-ის გამოყენებით Java-ში ხდება მარტივი Aspose.CAD Cloud SDK for Java. SDK-ს შეუძლია აუტენტიფიკაციის, ფაილების ნაკადის და მაღალი ხარისხის რენდერის მართვა, ხოლო REST API საშუალებას გაძლევთ ინტეგრირება გადაყვანის ნებისმიერი Java‑ზე დაფუძნებული ბექენდის ან მიკროსერვისში. გახსოვდეთ, რომ წარმოებაში გამოყენებისთვის გადამოწმებული ლიცენზია უნდა გამოიყენოთ; შეგიძლიათ შეძენოთ სრულლიცენზია ან მიიღოთ დროებითი ლიცენზია დროებით ლიცენზიის გვერდიდან. მოცემული ნაბიჯებით, კოდით და cURL მაგალითებით, თქვენ მზად ხართ თქვენი ორგანიზაციის ან SaaS‑ის გადაწყვეტისათვის სანდო CAD‑დან PDF‑ში გადაყვანის დამატება.

ხშირად დასმული კითხვები

როგორ დავაყენო მორგებული გვერდის ზომა PDF-ის გამოსავალისთვის?
გამოიყენეთ setPageWidth და setPageHeight მეთოდები CadConversionOptions ობიექტზე. განზომილებები გამოხატულია პუნქტებში (1 pt = 1/72 ინჩი). მიმართეთ API-ის დოკუმენტაციას სრულ არჩევანის სიისთვის.

რა უნდა გავაკეთო, თუ კონვერტაცია აბრუნებს 500 შეცდომას?
500 შეცდომა ჩვეულებრივ მიუთითებს მხარდაუჭერელ ელემენტებზე წყაროს DWT ფაილში. გამარტივეთ ნახატი კომპლექსური ჰაჩის შაბლონების ან 3D ობიექტების მოცილებით, ან ექსპორტეთ ნახატი DWG-ის უფრო ადრეულ ვერსიაზე ატვირთვამდე. ოფიციალური დოკუმენტაცია იძლევა მითითებებს მხარდაჭერილი ფუნქციებზე.

მიძლია DWT ფაილების, რომელიც კერძო ღრუბლოვან შენახვაშია, გადაყვანა?
დიახ. ატვირთეთ ფაილი Aspose Cloud შენახვაში uploadFile მეთოდის ან შესაბამისი cURL ბრძანების გამოყენებით, შემდეგ მიმართეთ შენახვის ბილიკს კონვერსიის მოთხოვნაში. აუტენტიფიკაცია იმავე OAuth 2.0 ტოკენით ხდება.

DWT‑ის PDF-ში გადაყვანის გზა არსებობს, თუ არ გვინდა, რომ შედეგი დისკზე ჩაიწეროთ?
Both the SDK and the REST API can return the PDF as a stream (InputStream in Java). You can pipe this stream directly to another service or send it back to the client without persisting it on the server.

Read More