คู่มือ

อธิบาย watcher ที่เริ่มจากปัญหาการพัฒนาจริง เช่น การเขียนสัญญา API ซ้ำ การสร้างโครงสร้าง handler และสตริงฟิลด์ MongoDB ผ่านการไหลของข้อมูลจากแหล่งที่มาและผลลัพธ์ที่สร้างขึ้น

แต่ละ watcher เริ่มจากงานวนซ้ำที่แตกต่างกัน

Swagger watcher เริ่มต้นจากปัญหาในการเขียน API สัญญาใหม่จาก backend endpoint และ DTO ในขณะที่ Handler Generator เริ่มจากปัญหาในการสร้าง class และ method skeleton ทุกครั้งที่เพิ่ม router Entity Fields ถูกสร้างขึ้นเพื่อลดข้อผิดพลาดในชื่อ field และ MongoDB query และ AsyncAPI เป็นฟังก์ชันที่ขยายกระบวนการอัตโนมัตินี้ไปยัง RSocket

คู่มือจะอธิบายตามกฎที่ source ถูกอ่านและเชื่อมโยงไปยังไฟล์ใดมากกว่าที่จะเป็นเพียงรายการฟังก์ชัน เมื่อผลลัพธ์ที่สร้างขึ้นไม่ตรงตามที่คาดหวัง ให้ตรวจสอบ project path, package และ source pattern ที่รองรับก่อนการทำงานใน runtime

คู่มือแยกตามหัวข้อ

WatchForMainRun

ทำการดำเนินการอัตโนมัติในการพัฒนาหลายอย่างในครั้งแรกและเรียกใช้ watcher ที่จำเป็นอีกครั้งเมื่อมีการเปลี่ยนแปลง source

Swagger / OpenAPI

สร้าง API สัญญาที่ frontend สามารถอ่านได้จาก RouterFunction, handler และ DTO ที่เขียนไว้ใน backend แล้ว

Handler Generator

สร้างและปรับปรุง class และ method skeleton ที่ซ้ำซ้อนตาม handler reference ที่ประกาศใน router

Entity Fields

สร้าง enum เพื่อไม่ให้มีการทำซ้ำชื่อ field และ collection ใน MongoDB query เป็น raw string

RSocket AsyncAPI

ใช้หลักการ source-of-truth เช่นเดียวกับ REST กับ RSocket route และ payload type

ค่าเริ่มต้นของโปรเจกต์ & โหลดใหม่

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

External JAR & Type Mapping

กำหนด decompile และ schema mapping เพื่อให้ handler และ DTO ที่อยู่ในโมดูลทั่วไปสามารถใช้เป็นต้นฉบับของ API สัญญาได้

การแก้ไขปัญหา

เมื่อผลลัพธ์ที่สร้างขึ้นหายไป ให้ตรวจสอบ source pattern, package, path และขอบเขตของ watcher ตามลำดับ