Mühendislik çizimlerini evrensel olarak okunabilir PDF’lere dönüştürmek, müşteriler, QA ekipleri veya sonraki analiz boru hatlarıyla tasarım verilerini paylaşması gereken birçok arka uç hizmeti için günlük bir zorluktur. Aspose.HTML Cloud SDK for Java yerel CAD yazılımı gerektirmeden Java uygulamalarında doğrudan DWG to PDF dönüşümünü yöneten sağlam bir kütüphane sağlar. Bu kılavuz, kimlik doğrulama ve dosya yüklemeden dönüşüm, yapılandırma ve performans ayarına kadar tam süreci adım adım gösterir, böylece DWG’den PDF’ye dönüşümü mikro hizmetlerinize güvenle entegre edebilirsiniz.

DWG Dosyalarını Java’da PDF’ye Dönüştürme Adımları

  1. Erişim Tokenı Alın - İstemci kimlik bilgilerinizi kullanarak Aspose.HTML kimlik doğrulama uç noktasından bir JWT tokenı isteyin. Bu token, sonraki tüm API çağrılarını yetkilendirir. 
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();
  1. DWG Dosyasını Yükleyin - DWG dosyasını ekleyerek depolama API’sine çok parçalı (multipart) bir POST isteği gönderin. Yanıt, daha sonra referans alacağınız bir depolama yolu döndürür. 
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");
  1. Dönüştürme Uç Noktasını Çağırın - Bir PdfConversionRequest nesnesi oluşturun, giriş dosya yolunu ayarlayın ve sayfa boyutu ve DPI gibi PDF seçeneklerini belirtin. 
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);
  1. Oluşturulan PDF’yi İndirin - PDF’yi depolamadan alın ve yerel olarak kaydedin veya istemciye geri akış (stream) olarak gönderin. 
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());
  1. Temizleme - İsteğe bağlı olarak, hesabınızı düzenli tutmak için geçici DWG ve PDF dosyalarını bulut depolamadan silin. 
String deleteUrl = "https://api.aspose.cloud/v4.0/html/storage/file/" + storagePath;
HttpClient.delete(deleteUrl)
    .header("Authorization", "Bearer " + accessToken)
    .execute();

DWG’den PDF Dönüştürmesi Aspose.HTML Kullanarak - Tam Kod Örneği

Aşağıdaki program, tüm adımları tek bir çalıştırılabilir Java sınıfında birleştirir. Aspose.HTML Cloud SDK for Java kullanarak kimlik doğrulama, DWG dosyasını yükleme, dönüştürmeyi gerçekleştirme ve PDF sonucunu indirme işlemlerini gösterir.

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
    }
}

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce dosya yollarını (sample.dwg, sample.pdf vb.) gerçek 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 belgeler adresine bakın veya destek ekibi ile iletişime geçin.

cURL kullanarak REST API ile Bulut Tabanlı Belge Dönüştürme

Daha hafif bir yaklaşımı tercih ettiğinizde veya dönüştürmeyi betiklere entegre etmeniz gerektiğinde, Aspose.HTML Cloud REST API doğrudan cURL ile çağrılabilir.

  1. Kimlik Doğrulama ve Erişim Token’ı Al 
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"
  1. Kaynak DWG Dosyasını Yükleyin 
curl -X POST "https://api.aspose.cloud/v4.0/html/storage/file" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "File=@/path/to/sample.dwg"
  1. Dönüşümü Gerçekleştirin
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
           }
         }'
  1. Çıktı PDF’yi İndir
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/output/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.pdf

Uç noktalar ve parametrelerin tam listesi için, API referansına bakın.

Java’da Kurulum ve Ayarlama

Aspose.HTML Cloud SDK for Java’ı Maven projenize ekleyin:

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

Alternatif olarak, kurulum komutunu çalıştırın:

mvn install com.aspose:aspose-html-cloud

En son JAR dosyalarını indirme sayfasından indirin. Bağımlılığı ekledikten sonra, yukarıdaki kod örneklerinde gösterildiği gibi gerekli sınıfları içe aktarın.

Java’da Aspose.HTML Kullanarak DWG’den PDF’ye İşlemine Genel Bakış

DWG dosyaları, vektör verileri, katmanlar ve meta veriler içeren yerel AutoCAD çizimleridir. Bunları PDF’ye dönüştürmek, içeriğin özel bir yazılım olmadan herhangi bir cihazda görüntülenebilmesini sağlar. Aspose.HTML Cloud SDK for Java, format ayrıştırma, renderleme ve PDF oluşturmayı sunucu tarafında yöneterek karmaşıklığı soyutlar ve iş mantığına odaklanmanıza olanak tanır.

Arka uç mikro hizmetleri için temel faydalar şunlardır:

  • Durumsuz işlem - her istek bağımsızdır, konteynerleştirilmiş ortamlar için mükemmeldir.
  • Ölçeklenebilir REST uç noktaları - hizmeti bir yük dengeleyicinin arkasında yatay olarak ölçeklendirebilirsiniz.
  • Yerel CAD kütüphaneleri gerekmez - ağır iş yükü bulutta gerçekleştirilir.

Bu Görev İçin Önemli Olan Aspose.HTML Özellikleri

  • Yüksek doğruluklu renderleme DWG geometrisi, katmanları ve çizgi kalınlıkları için.
  • Yapılandırılabilir PDF seçenekleri sayfa boyutu, DPI, sıkıştırma ve güvenlik gibi.
  • Toplu işleme desteği asenkron iş yönetimi aracılığıyla.
  • Çapraz platform uyumluluğu - Java 8+ çalışan herhangi bir işletim sisteminde çalışır.
  • Sağlam hata yönetimi ayrıntılı yanıt kodlarıyla (API referansına bakınız).

Çıktı PDF Ayarlarını Yapılandırma

Oluşturulan PDF’yi PdfOptions nesnesini ayarlayarak ince ayar yapın:

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

Ayrıca özel yazı tiplerini gömebilir, meta verileri ayarlayabilir ve görüntü kalitesini kontrol edebilirsiniz. Ayrıntılı özellik açıklamaları resmi dokümantasyon içinde mevcuttur.

Java’da Dönüştürme Performansını Optimize Etme

Performans, büyük miktarda çizim işlenirken önemlidir:

  • Erişim belirtecini yeniden kullanın birden fazla dönüşüm için, her seferinde yeni bir belirteç istemek yerine.
  • Akışı etkinleştirin DWG dosyasını önce yüklemek yerine bir akış olarak göndererek, I/O yükünü azaltın.
  • DPI’yi ayarlayın yalnızca ihtiyaç duyulan kadar yüksek; 300 DPI çoğu baskı senaryosu için yeterlidir ve 600 DPI’ye göre işleme süresini yarıya indirir.
  • Çağrıları paralelleştirin Java’nın CompletableFuture veya bir yürütücü hizmeti kullanarak birden fazla dosyayı aynı anda dönüştürün.

Basit bir benchmark, 300 DPI ayarıyla akış modunu kullanırken, varsayılan 96 DPI tam dosya yüklemesine kıyasla %35 hız artışı gösterdi.

Verimli DWG’den PDF’ye Java Üretimi için En İyi Uygulamalar

  • Giriş dosyalarını doğrulayın yüklemeden önce gereksiz API çağrılarından kaçınmak için.
  • Yeniden deneme mantığını uygulayın geçici ağ hataları için; SDK standart HTTP durum kodlarını döndürür.
  • API kullanımını izleyin Aspose.HTML kontrol paneli ile kotanızın içinde kalmak için.
  • Kimlik bilgilerini güvence altına alın client_id ve client_secret değerlerini ortam değişkenlerinde veya bir gizli yönetim aracında saklayarak.
  • Dönüştürme metriklerini kaydedin (zaman, dosya boyutu) darboğazları belirlemek ve gelecekteki iyileştirmelere yön göstermek için.

Sonuç

Java arka uç mikro hizmetlerinde DWG’den PDF’ye dönüşüm, Aspose.HTML Cloud SDK for Java ile oldukça basit hale gelir. Adım adım kılavuzu izleyerek, PDF seçeneklerini yapılandırarak ve performans iyileştirmeleri uygulayarak, ölçekli olarak hızlı ve güvenilir belge dönüşümü sağlayabilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma detayları ürün sayfasında mevcuttur ve geçici bir lisans geçici lisans sayfasından elde edilebilir. Bugün entegrasyona başlayın ve uygulamalarınızı mühendislik çizimlerini sorunsuz bir şekilde işleyebilecek şekilde güçlendirin.

SSS

  • DWG dışındaki hangi formatlar PDF’ye dönüştürülebilir?
    Aspose.HTML Cloud SDK for Java, HTML, SVG ve diğer vektör formatlarını destekler. Tam liste için API referansına bakın.

  • Varsayılan yükleme boyutunu aşan büyük DWG dosyalarını nasıl yönetebilirim?
    Dönüştürmeden önce akış yükleme özelliğini kullanın veya çizimi daha küçük parçalara bölün. Ayrıntılı rehberlik resmi belgelerde mevcuttur.

  • Oluşturulan PDF’ye bir şifre ekleyebilir miyim?
    Evet, PdfOptions içindeki Password özelliğini ayarlayın. SDK PDF’yi buna göre şifreleyecektir.

  • Bulut aboneliği olmadan dönüşümü yerel olarak test etmenin bir yolu var mı?
    SDK bir bulut hesabı gerektirir; ancak, geliştirme için geçici bir lisans alabilirsiniz geçici lisans sayfasından.

Daha Fazla Oku