Aspose.OMR Cloud SDK for Java, geliştiricilerin Optik İşaret Tanıma (OMR) özelliklerini doğrudan Java uygulamalarından kullanmalarını sağlar. Bu kılavuz, Java’da PDF ile JSON dönüşümünün nasıl yapılacağını, kurulum, kod uygulaması, performans ayarı ve sorun giderme konularını kapsar.

PDF’den JSON’a Dönüştürme - Önkoşullar ve Kurulum

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • Java Development Kit (JDK) 8 veya üzeri makinenizde yüklü olmalıdır.
  • Maven bağımlılık yönetimi için.
  • Aspose Cloud hesabı ve istemci kimliği ile istemci sırrı.

En son sürümü bu sayfadan indirin.

SDK’yı Maven aracılığıyla kurun:

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

Veya komut satırını kullanın:

mvn install com.aspose:aspose-omr-cloud

Java projenize aşağıdaki import ifadelerini ekleyin:

import com.aspose.omr.cloud.ApiClient;
import com.aspose.omr.cloud.Configuration;
import com.aspose.omr.cloud.api.OMRApi;
import com.aspose.omr.cloud.model.*;

Ayrıca kimlik doğrulamayı yapılandırmanız gerekir:

Configuration.getDefaultApiClient().setBasePath("https://api.aspose.cloud");
Configuration.getDefaultApiClient().setClientId("YOUR_CLIENT_ID");
Configuration.getDefaultApiClient().setClientSecret("YOUR_CLIENT_SECRET");

Java’da PDF’den JSON’a

Temel görev, bir PDF dosyasını OMR hizmetine göndermek ve çıkarılan verilerin JSON temsili almayı sağlamaktır. SDK, HTTP çağrılarını soyutlayarak iş mantığınıza odaklanmanıza olanak tanır.

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

  • Yüksek doğruluklu OMR işleme taranmış cevap kağıtları için.
  • Toplu işleme desteği birden fazla PDF için.
  • Doğrudan JSON çıktısı aşağı akış hizmetleri için uygun.
  • Yerleşik bellek optimizasyonu büyük belgeler için.

PDF’den JSON’e Aspose.OMR Cloud SDK ile Performans Ayarlama

Birçok PDF’yi veya çok büyük dosyaları dönüştürürken aşağıdakileri göz önünde bulundurun:

  • Tüm PDF’yi belleğe yüklemeyi önlemek için streaming mode‘u etkinleştirin.
  • Yoğun iş yükleri için JVM heap size‘ı (-Xmx2g veya daha yüksek) artırın.
  • Dosyaları aynı anda işlemek için parallel streams‘i kullanın.

Aspose.OMR Cloud SDK kullanarak büyük PDF dönüşümleri için bellek yönetimi

Büyük PDF’ler OutOfMemoryError hatasına neden olabilir. Bunu hafifletmek için:

  • extractPageRange parametresini kullanarak sayfaları parçalar halinde işleyin.
  • OMRTask nesnelerini kullanımdan hemen sonra serbest bırakın.
  • VisualVM gibi araçlarla bellek kullanımını izleyin.

PDF’ten JSON Dönüşümündeki Yaygın Sorunların Giderilmesi

Hata Mesajı Muhtemel Neden Çözüm
401 Unauthorized Geçersiz istemci kimlik bilgileri İstemci kimliği/gizli anahtarını doğrulayın ve token’ı yeniden oluşturun
InvalidFileFormat Yüklenen dosya PDF değil Dosyanın .pdf uzantısına ve doğru MIME tipine sahip olduğundan emin olun
ConversionTimeout Büyük dosya varsayılan zaman aşımını aşıyor ApiClient yapılandırmasında zaman aşımını artırın

PDF’yi Java’da JSON’a Dönüştürme Adımları

  1. OMR istemcisini başlatın: Yapılandırılmış ApiClient kullanarak bir OMRApi örneği oluşturun.

    OMRApi omrApi = new OMRApi();

  2. PDF dosyasını yükleyin: PDF’yi buluta göndermek için omrApi.uploadFile kullanın.
    Documentation: official documentation.
    API reference: API reference.

  3. Bir dönüşüm görevi oluşturun: Yüklenen dosya kimliği ve JSON çıktısı isteğiyle omrApi.createTask çağırın.

    OMRTaskRequest request = new OMRTaskRequest();
request.setFileId(uploadedFileId);
request.setOutputFormat("json");
OMRTaskResponse task = omrApi.createTask(request);

  4. Görev tamamlanmasını sorgulayın: Durum Completed olana kadar omrApi.getTaskStatus(task.getId()) metodunu tekrar tekrar kontrol edin.

    while (!omrApi.getTaskStatus(task.getId()).getStatus().equals("Completed")) {
    Thread.sleep(2000);
}

  5. JSON sonucunu indirin: omrApi.downloadResult(task.getResultFileId()) kullanarak JSON dosyasını alın.

    byte[] jsonData = omrApi.downloadResult(task.getResultFileId());
Files.write(Paths.get("output.json"), jsonData);

Java’da PDF’den JSON’a - Tam Kod Örneği

Aşağıdaki örnek, yerel bir PDF dosyasından JSON belgesine tam uçtan uca bir dönüşümü Aspose.OMR Cloud SDK for Java kullanarak göstermektedir.

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

cURL kullanarak REST API aracılığıyla Bulut Tabanlı Belge Dönüştürme

Aspose.OMR Cloud SDK ayrıca doğrudan cURL ile çağrılabilen bir REST API sunar. Aşağıda tipik adımlar yer almaktadır.

1. Kimlik doğrulaması yapın ve bir 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"

2. Kaynak PDF’yi Yükle

curl -X POST "https://api.aspose.cloud/v4.0/omr/files" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@sample.pdf"

3. İstek JSON dönüşümü

curl -X POST "https://api.aspose.cloud/v4.0/omr/tasks" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"fileId":"UPLOADED_FILE_ID","outputFormat":"json"}'

4. Oluşturulan JSON dosyasını indirin

curl -X GET "https://api.aspose.cloud/v4.0/omr/files/RESULT_FILE_ID/content" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.json

Daha fazla ayrıntı için, resmi API belgeleri adresine bakın.

Sonuç

Java’da PDF’yi JSON’a dönüştürmek, Aspose.OMR Cloud SDK for Java ile çok basit hale gelir. Kütüphane dosya yüklemeyi, OMR işleme ve JSON oluşturmayı yönetir, böylece geliştiriciler çıktıyı uygulamalarına entegre etmeye odaklanabilir. Üretim kullanımı için uygun bir lisans almayı unutmayın; geçici bir lisansı geçici lisans sayfasından edinebilir veya ürün sayfasında tam fiyatlandırma seçeneklerini inceleyebilirsiniz. SDK yüklü, performans odaklı kod ve net hata yönetimi ile PDF’lerden ölçekli olarak yapılandırılmış verileri güvenilir bir şekilde çıkarabilirsiniz.

SSS

Java’da PDF’den JSON kütüphanesi karmaşık form düzenlerini nasıl işler?
SDK, PDF’nin görsel öğelerini ayrıştırır ve hiyerarşiyi koruyan bir JSON şemasına eşler. Karmaşık düzenler için OMR şablonunu ayarlamanız veya JSON’u sonradan işlemeniz gerekebilir. Şablon özelleştirmesi için resmi belgeler adresine bakın.

Java’da PDF’den JSON’a dönüşüm yaparken biçimlendirmeyi kaybetmeden gerçekleştirebilir miyim?
Evet. Dönüşüm, form alanlarının mantıksal yapısını korur. Görsel stil JSON’un bir parçası olmasa da, konumsal veriler gerektiğinde düzeni yeniden oluşturabileceğinizi garanti eder. En iyi uygulamalar için Java’da Biçimlendirmeyi Kaybetmeden PDF’den JSON’a Dönüşüm bölümüne bakın.

Java’da PDF’den JSON’a dönüşüm için toplu işleme destekleniyor mu?
Kesinlikle. SDK’nın toplu API’si, tek bir istekte birden fazla PDF dosyasını göndermenizi sağlar ve verimli Java’da PDF’den JSON’a Toplu İşleme‘yi mümkün kılar. Döndürülen görev kimliklerini yöneterek her JSON sonucunu alın.

Daha Fazla Oku