รับคำขอ

ทำไมเราต้อง GET blocks และมันทำงานอย่างไร?

เมื่อคุณพัฒนาส่วนหน้า คุณจะต้องเรียกใช้ BP ที่แตกต่างกันบนส่วนหลังอย่างหลีกเลี่ยงไม่ได้ ในการเรียกใช้ BP คุณต้องเรียกจุดสิ้นสุด ในการทำเช่นนี้ AppMaster จะสร้างบล็อก คำขอเซิร์ฟเวอร์ สำหรับแต่ละ จุดสิ้นสุด บล็อกเหล่านี้มีฟิลด์อินพุตและเอาต์พุตเดียวกันกับ จุดสิ้นสุด ที่เกี่ยวข้อง และทำหน้าที่เป็นวิธีเริ่มต้น

บล็อก GET ตามหลักการของ REST API จะต้องดึงข้อมูลบางส่วน บ่อยที่สุด บล็อก GET จะดึงข้อมูลจากโมเดลในฐานข้อมูล (ทั้งหมดหรือตามเกณฑ์ที่กำหนด)

เช่นเดียวกับบล็อก คำขอเซิร์ฟเวอร์ ทั้งหมด แต่ละบล็อก GET จะเชื่อมโยงกับจุดสิ้นสุดของตัวเอง URL ของปลายทางจะแสดงในชื่อของบล็อก

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

ฟิลด์อินพุตและเอาต์พุตของ GET block

ป้อนข้อมูล

• Endpoint ID จุดสิ้นสุด – กำหนดจุดสิ้นสุดที่บล็อกควรเข้าถึง ฟิลด์นี้ถูกตั้งค่าโดยอัตโนมัติ
• _offset – อนุญาตให้ระบุว่าบล็อกใดจะรับข้อมูล รูปแบบจำนวนเต็ม
• _limit – จำนวนระเบียนที่บล็อกโหลด ค่าเริ่มต้นคือ 25 สูงสุดในแต่ละครั้งคือ 500 รูปแบบจำนวนเต็ม
• _sort_order – สองค่าที่เหมาะสมสำหรับฟิลด์นี้: asc – ลำดับการจัดเรียงโดยตรง และ desc – ลำดับย้อนกลับ; รูปแบบสตริง
• _sort_by – กำหนดฟิลด์ของโมเดลข้อมูลที่จะจัดเรียงรายการ รูปแบบสตริง
• Ids – รายการรหัสเรกคอร์ด อนุญาตให้รับบันทึกตามรหัสเฉพาะ รูปแบบจำนวนเต็มอาร์เรย์
• _search – ค้นหาค่าที่กำหนดในรูปแบบข้อมูล รูปแบบสตริง
• _search_exact – เปิด/ปิดการค้นหาแบบตรงทั้งหมด; รูปแบบบูลีน
• _ search_in – ค้นหาตามฟิลด์เฉพาะ; รูปแบบสตริงอาร์เรย์

มาดูฟิลด์ที่เกี่ยวข้องกับการค้นหาให้ละเอียดยิ่งขึ้น

_search – ค้นหาข้อมูลที่ตรงกันตลอดทั้งโมเดลข้อมูล และจะพบโดยไม่คำนึงถึงฟิลด์ที่มีค่าอยู่

ตัวอย่างเช่น ลองตั้งค่าฟิลด์ _search เป็น John ถ้าในตัวแบบข้อมูล สำหรับระเบียนหนึ่ง ค่าของฟิลด์ชื่อคือ John และสำหรับอีกระเบียนหนึ่ง ค่าของฟิลด์อีเมลคือ [email protected] การค้นหาจะพบเรกคอร์ดทั้งสองนี้

_search_exact – การเปิดใช้งานฟิลด์นี้หมายความว่าผลลัพธ์จะรวมระเบียนที่ตรงกับข้อความค้นหาทั้งหมด

_search_in – ที่นี่ คุณสามารถตั้งค่าฟิลด์ที่ควรทำการค้นหา ตัวอย่างเช่น หากเราต้องการค้นหาเฉพาะชื่อและไม่พิจารณากรณีที่ชื่อเป็นส่วนหนึ่งของอีเมล เราสามารถใช้ _search_in และค้นหาเฉพาะจากฟิลด์ชื่อ

ค้นหาฟิลด์แบบจำลองข้อมูล

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

เอาต์พุต

• _success – ผลการค้นหา; รูปแบบบูลีน
• _httpcode – ขอรหัสตอบกลับ; รูปแบบจำนวนเต็ม
• _error – ข้อความแสดงข้อผิดพลาด; รูปแบบสตริง
• Data – บันทึกที่ได้รับ; รูปแบบโมเดลอาร์เรย์
• Count – จำนวนรายการที่ได้รับ รูปแบบจำนวนเต็ม

ฟิลด์ _with

ปรากฏในบล็อกที่คำขอส่งไปยังโมเดลข้อมูลที่เกี่ยวข้อง ช่วยให้คุณรับข้อมูลจากโมเดลข้อมูลที่มีการร้องขอและจากโมเดลข้อมูลที่เกี่ยวข้อง

มาดูฟิลด์ _with โดยใช้แอปพลิเคชันตัวอย่างที่เก็บรายชื่อหนังสือและหมวดหมู่ของหนังสือ

สร้างแบบจำลองข้อมูลสองแบบ: book และ category ใน book เราเพิ่มฟิลด์ book_name และใน category เราเพิ่มฟิลด์ category_name

สร้างการเชื่อมต่อระหว่างพวกเขา ลองวาดจากหมวดหมู่ไปยังหนังสือและตั้งค่าประเภทของความสัมพันธ์เป็น has_many เนื่องจากหมวดหมู่หนึ่งสามารถอ้างถึงหนังสือที่แตกต่างกันได้

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

ตั้งค่าฟิลด์นี้ใน Get block สำหรับแต่ละตาราง

ตอนนี้มาเปิดแอปพลิเคชันของเราและตรวจสอบให้แน่ใจว่าคิวรีทำงานอยู่และข้อมูลที่ถูกต้องปรากฏในตาราง