Versiyonlanmış Object Graph JSON Round Trip'leri
HotPDF, yüklenmiş eksiksiz bir indirect-object graph'ini versiyonlanmış JSON'a akıtabilir ve PDF değerlerini bir iş tanımına düzleştirmeden düzenlenebilir bir belgeyi yeniden kurabilir
Schema ve uyumluluk
Geçerli HotPDF-object-graph-2 schema'sı; schemaVersion, minimumReaderVersion, PDF sürümü, trailer Root ve Info referansları, seçilen her indirect object, silinmiş nesne tanımlayıcıları ile snapshot veya incremental türünü kaydeder
Reader'lar geriye dönük uyumluluk için eski HotPDF-object-graph-1 formatını kabul eder ve hedef belgeyi değiştirmeden önce gelecek ya da uyumsuz schema sürümlerini reddeder
Düzenleme round trip'leri için v2 stream API'sini kullanın; çünkü v2, her stream payload'ının ham filtrelenmiş veri mi yoksa decode edilmiş veri mi olduğunu kaydeder
Streaming ve binary payload'lar
ExportLoadedObjectGraphJSONToStream, belge boyutunda bir JSON string'i oluşturmadan nesneleri ve özyinelemeli olarak sıralanmış PDF değerlerini doğrudan hedef stream'e yazar
Ham veya decode edilmiş stream byte'ları çıkarılabilir, chunked base64 olarak gömülebilir veya verilen dizin altına sidecar dosyalar hâlinde yazılabilir
Sidecar adları güvenli yaprak adlardır; yayın, aynı dizindeki geçici bir dosya üzerinden atomik değiştirmeyle yapılır ve import, path traversal içeren ya da mutlak yolları reddeder
Importer, sabit boyutlu input blokları okur ve aynı anda yalnızca bir üst düzey object entry'si oluşturur; bu sırada JSON byte, nesne sayısı ve numarası, değer derinliği, string byte, tekil stream ile toplam stream byte limitlerini uygular
Snapshot ve incremental modları
Snapshot, grafiğin tamamını dışa aktarır; ogjimReplace ise aday belgeyi hedefle değiştirmeden önce doğrular
Artımlı export yalnızca dirty, must-write ve silinmiş nesneleri içerir; ogjimUpdate, referansları mevcut graph ile delta'nın birleşimine göre doğrular, sonra yüklenmiş graph transaction mekanizması üzerinden commit eder
Bozuk bir değer, çözülemeyen bir referans, geçersiz Catalog veya Pages tree, tutarsız doğrudan ya da dolaylı stream Length, tükenen bütçe veya başarısız sidecar okuması hedefi değiştirmeden bırakır
Güvenlik sınırı
JSON graph, PDF nesnelerini ve trailer Root ile Info ilişkilerini içerir; ama asla parola, şifreleme anahtarı veya aktif security-handler durumunu dışa aktarmaz
Bu yüzden değiştirilen snapshot, uygulama kaydetmeden önce çıktı korumasını açıkça yapılandırmadığı sürece şifrelenmemiş olur