CAD çizimlerinin PDF‘ye otomatik olarak dönüştürülmesi, tasarımları görüntüleme, paylaşma veya arşivleme ihtiyacı duyan birçok kurumsal ve SaaS uygulaması için hayati öneme sahiptir. Aspose.CAD Cloud SDK for Java Java geliştiricileri için bu görevi basitleştiren güçlü bir REST‑tabanlı kütüphane sunar. Bu rehberde SDK’yı nasıl kuracağınızı, temel özelliklerini keşfedeceğinizi, performans seçeneklerini yapılandıracağınızı ve hem Java kodu hem de cURL komutları kullanarak tam bir DWT dosyasını PDF’ye dönüştürmeyi nasıl gerçekleştireceğinizi göreceksiniz.

Java’da Kurulum ve Ayarlar

Bu bölüm, kod yazmadan önce ihtiyacınız olan her şeyi kapsar.

  • Sistem Gereksinimleri: Java 8 ve üzeri, Maven 3.5+, API çağrıları için internet bağlantısı.
  • İndirme: En son kütüphaneyi bu sayfadan edinin.
  • Maven Bağımlılığı
<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-cad-cloud</artifactId>
    <version>23.12</version>
</dependency>
  • Kurulum Komutu
mvn install com.aspose:aspose-cad-cloud

DWT’den PDF’ye Dönüştürme REST ile Java’da

REST uç noktası POST /cad/convert bir DWT dosyasını kabul eder ve bir PDF belgesi döndürür. İstek gövdesi kaynak dosya adını, istenen çıktı formatını (PDF) ve rasterizasyon DPI’sı ve katman işleme gibi isteğe bağlı dönüşüm ayarlarını içerir. API dosyayı bulutta işler, ağır yerel render motorlarına olan ihtiyacı ortadan kaldırır.

Aspose.CAD Cloud SDK for Java’ın Temel Özellikleri

  • Geniş CAD Format Desteği: DWT, DWG, DXF, DWF, ve daha fazlasını işler.
  • Yüksek Kaliteli PDF Çıktısı: Çizgi kalınlıklarını, renkleri ve katmanları korur.
  • Akış Desteği: Tüm dosyayı belleğe yüklemeden büyük dosyaları yüklemenizi sağlar.
  • Özelleştirilebilir Render Seçenekleri: DPI, sayfa boyutu ve vektör vs. raster çıktıyı kontrol edin.
  • Güvenli Bulut İşleme: Tüm veriler HTTPS üzerinden OAuth 2.0 kimlik doğrulamasıyla iletilir.

Aspose.CAD Cloud SDK’yi Optimum Performans İçin Yapılandırma

Dönüşümü, CadConversionOptions nesnesini ayarlayarak ince ayar yapın:

  • setDpi(int dpi) - Daha yüksek DPI detayları iyileştirir ancak dosya boyutunu artırır.
  • setPageWidth(int width) / setPageHeight(int height) - Açık sayfa boyutlarını tanımlar.
  • setLayers(String[] layers) - İşleme süresini azaltmak için yalnızca seçilen katmanları dönüştürür.

Bu ayarlar API referansında belgelenmiştir.

Ortak Dönüştürme Hatalarını Giderme

Hata Olası Neden Çözüm
401 Yetkisiz Geçersiz veya süresi dolmuş erişim belirteci İstemci kimlik bilgilerinizi kullanarak belirteci yeniden oluşturun.
413 Yük Çok Büyük Dosya 100 MB sınırını aşıyor Yüklemeden önce çizimi bölün veya sıkıştırın.
500 Dahili Sunucu Hatası DWT dosyasındaki desteklenmeyen varlıklar Dönüştürmeden önce karmaşık varlıkları kaldırın veya çizimi basitleştirin.

DWT Dosyalarını REST API Kullanarak Java’da PDF Formatına Dönüştürme Adımları

  1. API istemcisi oluşturun: CadApi‘yi istemci kimliğiniz ve gizli anahtarınızla başlatın.
  2. DWT dosyasını yükleyin: uploadFile kullanarak dosyayı bulut depolamaya akıtın.
  3. Dönüştürme seçeneklerini ayarlayın: DPI ve sayfa boyutu için CadConversionOptions yapılandırın.
  4. Dönüştürme uç noktasını çağırın: Kaynak dosya adını ve hedef format olarak "PDF"‘yi belirterek convertDocument‘i çalıştırın.
  5. PDF’yi indirin: Çıktı dosya akışını alın ve yerel olarak kaydedin.

Ayrıntılı sınıf bilgileri için, CadApi referans sayfasına bakın.

Java ile REST Kullanarak DWT Dosyalarını PDF’ye Dönüştürme - Tam Kod Örneği

Aşağıdaki örnek, kimlik doğrulama, dosya yükleme, dönüşüm ve indirme dahil olmak üzere tam uçtan uca bir dönüşümü göstermektedir.

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce dosya yollarını (input.dwt, output.pdf, vb.) gerçek dosya konumlarınıza göre güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğini doğruladığınızdan ve geliştirme ortamınızda kapsamlı bir şekilde test ettiğinizden emin olun. Herhangi bir sorunla karşılaşırsanız, lütfen resmi dokümantasyona bakın veya destek ekibi ile iletişime geçin.

cURL kullanarak REST API üzerinden Uzaktan CAD Dosyasını PDF’ye Dönüştürme

Aynı dönüşüm, basit cURL komutlarıyla gerçekleştirilebilir; bu, hızlı testler veya Java dışı hizmetlerle entegrasyon için faydalıdır.

  1. Erişim belirteci alın
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 dosyasını yükleyin
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’ye dönüştürme isteği
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. Dönüştürülmüş PDF’yi indirin
curl -X GET "https://api.aspose.cloud/v3.0/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

İstek yükleri hakkında daha fazla ayrıntı için, resmi API belgelerine bakın.

Sonuç

DWT’yi PDF’ye REST kullanarak Java’da dönüştürmek, Aspose.CAD Cloud SDK for Java ile oldukça basit hale gelir. SDK kimlik doğrulama, dosya akışı ve yüksek kaliteli render işlemlerini yönetirken, REST API dönüşümü herhangi bir Java tabanlı backend veya mikroservise entegre etmenizi sağlar. Üretim ortamı için geçerli bir lisans uygulamayı unutmayın; tam bir lisans satın alabilir veya geçici lisans sayfasından geçici bir lisans edinebilirsiniz. Sağlanan adımlar, kod ve cURL örnekleriyle, kurumsal veya SaaS çözümünüze güvenilir CAD‑to‑PDF dönüşümünü eklemeye hazırsınız.

SSS

PDF çıktısı için özel bir sayfa boyutu nasıl belirlerim?
PDF çıktısı için özel bir sayfa boyutu belirlemek için CadConversionOptions nesnesindeki setPageWidth ve setPageHeight yöntemlerini kullanın. Boyutlar nokta cinsinden ifade edilir (1 pt = 1/72 inç). Tam seçenek listesi için API referansına bakın.

Dönüşüm 500 hatası döndürürse ne yapmalıyım?
500 hatası genellikle kaynak DWT dosyasındaki desteklenmeyen varlıkları gösterir. Çizimi, karmaşık tarama desenlerini veya 3D nesnelerini kaldırarak basitleştirin veya yüklemeden önce çizimi daha eski bir DWG sürümüne dışa aktarın. Resmi dokümantasyon desteklenen özellikler hakkında rehberlik sağlar.

DWT dosyalarını özel bir bulut depolamasında saklayabilir miyim?
Evet. Dosyayı Aspose Cloud storage’a uploadFile yöntemi veya ilgili cURL komutunu kullanarak yükleyin, ardından dönüşüm isteğinde depolama yolunu referans verin. Kimlik doğrulama aynı OAuth 2.0 tokenı ile yapılır.

DWT’yi PDF’ye, çıktıyı diske yazmadan dönüştürmenin bir yolu var mı?
SDK ve REST API’si, PDF’yi bir akış olarak döndürebilir (InputStream Java’da). Bu akışı doğrudan başka bir hizmete yönlendirebilir veya sunucuda kalıcı olarak saklamadan istemciye geri gönderebilirsiniz.

Read More