ตัวถอดรหัส Protocol Buffers

สิ่งที่ตัวถอดรหัส Protobuf แบบไม่มีสคีมายืนยันได้

Protocol Buffers เก็บลำดับแท็กและค่าของฟิลด์ ไม่ได้เก็บประกาศเดิมจากไฟล์ .proto คู่มือการเข้ารหัส protobuf อย่างเป็นทางการ กำหนดแท็กด้วยการเลื่อนหมายเลขฟิลด์ไปสามบิตแล้วรวมกับ Wire Type ซึ่งเทียบเท่ากับ field_number × 8 + wire_type ดังนั้นตัวถอดรหัสจึงยืนยันหมายเลขฟิลด์, Wire Type, ขอบเขตไบต์ และรูปแบบการเข้ารหัสที่เป็นไปได้ตามโครงสร้างได้ แต่ยืนยันไม่ได้ว่า varint ถูกประกาศเป็น uint64, int64, sint64, bool หรือ enum เพราะชนิดเหล่านี้อาจใช้ไบต์ชุดเดียวกัน

ผู้ใช้ต้องเลือกโหมดอินพุตเองเสมอ Hex ยอมรับช่องว่างแบบ ASCII และคำนำหน้า 0x ที่ต้นข้อความได้ไม่เกินหนึ่งชุด Base64 และ Base64URL จะถูกตรวจสอบแยกกันทั้งความยาว แพดดิ้ง และบิตแพดดิ้งที่ไม่ได้ใช้ และห้ามผสมชุดอักขระมาตรฐานกับแบบ URL-safe ข้อความดิบหมายถึงไบต์ UTF-8 ตรงตามที่ TextEncoder ของเบราว์เซอร์สร้าง โดยจะไม่ตีความ Escape ที่ใช้แบ็กสแลช ส่วนอินพุตไฟล์จะใช้ไบต์จริงของไฟล์

Wire Type และการตีความ

ชนิด number ทั่วไปของ JavaScript ไม่สามารถแทนจำนวนเต็ม 64 บิตได้ครบทุกค่าอย่างแม่นยำ ตัวถอดรหัสนี้ใช้ BigInt ตลอด Wire Parser และแปลงจำนวนเต็มที่แม่นยำเป็นสตริงฐานสิบสำหรับแสดงผลและส่งออก ค่าทศนิยมพิเศษ เช่น NaN, ค่าอนันต์ และศูนย์ติดลบ ก็ส่งออกเป็นสตริงด้วย เพื่อไม่ให้ JSON เปลี่ยนค่าเหล่านั้นเป็นค่าอื่นโดยไม่แจ้ง

ทำความเข้าใจความกำกวมของ Length-delimited

Wire Type 2 ใช้กับสตริง ไบต์ดิบ ข้อความฝัง และค่าสเกลาร์ซ้ำแบบ Packed เมื่อไม่มีสคีมา ลำดับไบต์หนึ่งชุดอาจถูกต้องในหลายบทบาทพร้อมกันได้ ตัวอย่างเช่น 2a 03 01 02 03 คือฟิลด์ 5 ที่มีสามไบต์ ไบต์เหล่านี้เป็น Packed Varint [1, 2, 3] ที่ถูกต้อง แต่ก็เป็นไบต์ธรรมดาได้เช่นกัน ตัวถอดรหัสจะแสดงทั้งสองแบบโดยไม่จัดอันดับว่าแบบใดน่าจะถูกกว่า

ค่าที่เป็นไปได้แบบ Nested Message จะปรากฏต่อเมื่อเนื้อหา Length-delimited ทั้งหมดแยกวิเคราะห์เป็นข้อความที่สมบูรณ์ได้เท่านั้น ค่าที่เป็นไปได้แบบ Packed Varint, fixed32 และ fixed64 ก็จะแสดงต่อเมื่อการตีความนั้นใช้ไบต์ครบทั้งหมด ส่วน UTF-8 แบบเข้มงวดต้องถอดรหัสลำดับทั้งหมดได้โดยไม่มีอักขระทดแทน การตรวจสอบเหล่านี้บอกความเป็นไปได้ทางโครงสร้าง ไม่ใช่ชนิดฟิลด์ที่ประกาศไว้

ระบบจะจัดการกลุ่มตามไวยากรณ์ Wire แม้ว่าสคีมาสมัยใหม่มักเลือกใช้ Embedded Message แทน แท็ก Start-group ต้องปิดด้วยแท็ก End-group ที่มีหมายเลขฟิลด์เดียวกัน แท็กจบที่ระดับราก แท็กจบที่ไม่ตรงกัน หรือแท็กจบที่ขาดหาย จะหยุดการถอดรหัส ณ ออฟเซ็ตไบต์ที่แน่นอน ฟิลด์ที่ถอดรหัสเสร็จก่อนข้อผิดพลาดยังคงแสดงอยู่ และไบต์ที่หายไปหรือค่าที่ไม่ทราบจะไม่ถูกแทนเป็นศูนย์ปลอม

ขีดจำกัด การทำ Framing และการจัดการอย่างปลอดภัย

ตัวถอดรหัสรับข้อความที่ไม่มีเฟรมหนึ่งข้อความขนาดไม่เกิน 10 MiB โดยจะไม่แยกสตรีมที่มีความยาวนำหน้า, เฟรม gRPC, ไฟล์ Delimited Message หรือซองการส่งข้อมูลอื่น โปรดนำ Framing ออกก่อน แล้วจึงถอดรหัสเพียงหนึ่งข้อความ Parser ยังจำกัดจำนวนเรคคอร์ดทั้งหมด ความลึกการเรียกซ้ำ จำนวนแถวที่มองเห็น และปริมาณงานตรวจสอบค่าที่เป็นไปได้ การควบคุมเหล่านี้เป็นไปตามแนวคิดของคำแนะนำทางการเกี่ยวกับชุดข้อมูลขนาดใหญ่และขีดจำกัดการติดตั้งใช้งาน: แม้ protobuf จะมีประสิทธิภาพ แต่แท็บวินิจฉัยในเบราว์เซอร์ก็ยังต้องจำกัดหน่วยความจำและงานประมวลผล

หมายเลขฟิลด์ต้องอยู่ระหว่าง 1 ถึง 536,870,911 ตัวถอดรหัสจะแจ้งเตือนหมายเลข 19,000–19,999 เพราะคำแนะนำหมายเลขฟิลด์อย่างเป็นทางการสงวนช่วงนี้ไว้สำหรับการติดตั้งใช้งาน ส่วน Wire Type 6 และ 7 ไม่ถูกต้อง

การแยกวิเคราะห์และส่งออกเกิดขึ้นภายในเครื่อง มุมมองหลายขั้นตอนอาจเก็บเพย์โหลดที่จำกัดขนาดไว้ใน sessionStorage ของแท็บนี้นานสูงสุดสองชั่วโมง และการเริ่มใหม่จะลบข้อมูลดังกล่าว ไม่มีข้อมูลใดถูกใส่ใน URL หรือส่งผ่าน เซิร์ฟเวอร์ของเรา เอาต์พุต JSON ระบุชัดว่าเป็นรายงานการถอดรหัสในรูปแบบเฉพาะของเครื่องมือนี้ ไม่ใช่ ProtoJSON ส่วน CSV ขึ้นต้นด้วย UTF-8 BOM และเติมคำนำหน้าให้เซลล์ที่ดูคล้ายสูตรเพื่อให้เปิดในสเปรดชีตได้ปลอดภัยขึ้น อย่างไรก็ตาม รายงานยังอาจมีข้อมูลลับของแอปพลิเคชัน จึงควรตรวจสอบก่อนแชร์