ร้องขอ Roots ของไคลเอ็นต์

การรู้ว่ามีรูตอยู่เป็นเพียงขั้นแรก ขั้นที่สองคือขอรายการปัจจุบันจากไคลเอ็นต์จริง ๆ เพื่อให้เซิร์ฟเวอร์ตัดสินใจได้ว่าจะอ่านหรือเขียนที่ใด 📨

ในกรณีนี้ทิศทางจะสลับกันคือ เซิร์ฟเวอร์ส่งคำขอ และไคลเอ็นต์ตอบกลับ วิธีการที่เรียกคือ roots/list ซึ่งใช้ขอรายการทั้งหมดที่ไคลเอ็นต์เปิดเผยอยู่ในขณะนั้น

ใน Python SDK คุณไม่จำเป็นต้องสร้าง JSON ดิบเอง แต่ใช้วัตถุบริบทของคำขอที่ส่งต่อให้เครื่องมือของคุณ ซึ่งเป็นตัวห่อหุ้มเซสชันที่กำลังเชื่อมต่อกับไคลเอ็นต์

จากบริบทนั้น ให้เรียก list_roots() และรอผลลัพธ์ SDK จะส่ง roots/list ให้คุณเอง และส่งคำตอบของไคลเอ็นต์กลับมาเป็นผลลัพธ์ที่มีชนิดกำกับ

คำตอบจะมีรายการรูต แต่ละรายการมี uri และชื่อที่ไม่จำเป็นต้องมี ซึ่งเป็นโครงสร้างเล็ก ๆ แบบเดียวกับที่เห็นก่อนหน้านี้ และพร้อมให้คุณวนซ้ำตรวจสอบ

คำตอบที่ถูกต้องอาจเป็นรายการว่าง ซึ่งหมายความว่าขณะนี้ไคลเอ็นต์ไม่มีรูตให้ใช้งาน ดังนั้นควรวางแผนทางเลือกสำรองที่เหมาะสม แทนการสันนิษฐานว่ามีโฟลเดอร์อยู่

การเรียก list_roots จะมีความหมายก็ต่อเมื่อไคลเอ็นต์รองรับรูต เซิร์ฟเวอร์ที่ทำงานอย่างสุภาพจะตรวจสอบความสามารถที่ประกาศไว้ก่อนขอข้อมูล เพื่อหลีกเลี่ยงข้อผิดพลาดบนโฮสต์ที่ไม่มีความสามารถนี้

ดึงข้อมูลรูตเมื่อจำเป็นต้องใช้ เช่น ตอนเริ่มต้นเครื่องมือจัดการไฟล์ การขอข้อมูลเมื่อจำเป็นช่วยให้ข้อมูลเป็นปัจจุบัน หากผู้ใช้เพิ่งเปิดโฟลเดอร์อื่น

uri ของรูตอาจเป็นสตริงอย่าง file:///home/ada หากต้องการใช้งาน ให้แยกวิเคราะห์ URI file:// เป็นพาธระบบไฟล์จริงก่อนเปิดสิ่งใดภายในนั้น

หากไคลเอ็นต์รองรับ ไคลเอ็นต์สามารถส่งการแจ้งเตือนเมื่อรูตเปลี่ยนแปลงได้ การดักจับการแจ้งเตือนนี้ทำให้คุณดึงรายการใหม่แทนการทำงานจากข้อมูลเก่าที่ไม่เป็นปัจจุบัน

คำขอยังคงล้มเหลวหรือหมดเวลาได้ ให้ครอบการเรียกไว้เพื่อให้คำตอบที่หายไปส่งผลเป็นข้อความที่ชัดเจนสำหรับเครื่องมือ แทนที่จะเกิดการหยุดทำงาน 🛟

คุณรอผลลัพธ์จาก list_roots() บนเซสชัน วนซ้ำผ่านรูตที่ส่งกลับมา แยกวิเคราะห์ uri file:// แต่ละรายการ และจัดการคำตอบที่ว่างเปล่าหรือล้มเหลว เมื่อรูตเปลี่ยนแปลง ให้ขอข้อมูลใหม่ ✅