Protocol Buffers Kod Çözücü

Şemasız bir Protobuf kod çözücü neyi kanıtlayabilir?

Protocol Buffers, özgün .proto bildirimlerini değil alan etiketleri ve değerlerden oluşan bir diziyi saklar. Resmî protobuf kodlama kılavuzu her etiketi (field_number << 3) | wire_type olarak tanımlar. Bu nedenle kod çözücü alan numarasını, wire türünü, bayt sınırlarını ve yapısal olarak mümkün kodlamaları kesinleştirebilir. Aynı baytlar farklı bildirimlerde kullanılabildiği için bir varint’in uint64, int64, sint64, bool veya enum olduğunu kanıtlayamaz.

Giriş modu her zaman açıkça seçilir. Hex, ASCII boşluklara ve en fazla bir baştaki 0x değerine izin verir. Base64 ile Base64URL; uzunluk, padding ve kullanılmayan dolgu bitleri dâhil ayrı doğrulanır; standart ve URL-safe alfabeler karıştırılamaz. Ham metin, tarayıcının TextEncoder bileşeninin ürettiği UTF-8 baytlarının aynısıdır, ters eğik çizgili kaçışlar yorumlanmaz. Dosyada birebir baytlar kullanılır.

Wire türleri ve yorumlar

JavaScript’in sıradan Number türü her 64 bit tamsayıyı kesin gösteremez. Ayrıştırıcı baştan sona BigInt kullanır ve kesin tamsayıları görüntüleme ile dışa aktarma için ondalık dizeye dönüştürür. NaN, sonsuzluklar ve negatif sıfır gibi özel kayan nokta değerleri de JSON’un sessizce değiştirmemesi için dize olarak aktarılır.

Uzunlukla sınırlandırılmış belirsizliği anlamak

Wire türü 2; dizeler, ham baytlar, gömülü mesajlar ve packed tekrarlanan skaler değerler için kullanılır. Şema olmadan bir bayt dizisi birkaç role aynı anda uyabilir. Örneğin 2a 03 01 02 03, üç bayt içeren 5. alandır. Bunlar geçerli packed varint’ler [1, 2, 3] olduğu gibi sıradan baytlardır. Kod çözücü iki adayı da gösterir ve olasılık sıralaması yapmaz.

İç içe mesaj adayı yalnızca uzunlukla sınırlandırılmış gövdenin tamamı eksiksiz mesaj olarak ayrıştırılırsa görünür. Packed varint, fixed32 ve fixed64 adayları da tüm baytları tüketmelidir. Katı UTF-8 adayı, dizinin tamamını değiştirme karakteri olmadan çözmelidir. Bunlar yapısal olasılıklardır; alanın bildirilmiş türü değildir.

Modern şemalar çoğunlukla gömülü mesajları tercih etse de gruplar wire dil bilgisine göre işlenir. Başlangıç etiketi aynı alan numaralı bitiş etiketiyle kapanmalıdır. Kök düzeyinde bitiş, farklı numara veya eksik kapanış tam bayt ofsetinde önemli hata üretir. Önceden çözülen eksiksiz alanlar görünür kalır; eksik baytlar ve bilinmeyen değerler hiçbir zaman sahte sıfıra dönüşmez.

Sınırlar, framing ve güvenli kullanım

Kod çözücü 10 MiB’a kadar çerçevesiz tek mesaj kabul eder. Uzunluk önekli akışları, gRPC frame’lerini, sınırlandırılmış mesaj dosyalarını veya taşıma zarflarını ayırmaz. Önce framing’i kaldırın, sonra tek mesajı çözün. Ayrıştırıcı kayıt sayısını, özyineleme derinliğini, görünür satırları ve aday işlemlerini sınırlar; bu yaklaşım resmî büyük veri kümeleri ve uygulama sınırları rehberleriyle uyumludur.

Alan numaraları 1 ile 536.870.911 arasında olmalıdır. Resmî alan numarası kılavuzu 19.000–19.999 aralığını uygulamalara ayırdığı için uyarı gösterilir. Wire türleri 6 ve 7 geçersizdir.

Ayrıştırma ve dışa aktarma yerel olarak gerçekleşir. Çok adımlı görünüm, sınırlı payload’u bu sekmenin sessionStorage alanında en fazla iki saat tutabilir; baştan başlamak siler. URL’ye hiçbir şey eklenmez ve sunucularımız üzerinden gönderilmez. JSON, açıkça bu araca özgü biçimde bir çözümleme raporudur; ProtoJSON değildir. CSV, UTF-8 BOM ile başlar ve e-tabloda daha güvenli açılması için formüle benzeyen hücreleri etkisizleştirir. Rapor yine de gizli uygulama verileri içerebilir; paylaşmadan önce inceleyin.