Market > GraphQL
Tổng quan
GraphQL là plugin giúp EzyPlatform mở rộng hệ thống API theo hướng linh hoạt hơn, đặc biệt hữu ích khi cần gom dữ liệu từ nhiều nguồn, tạo endpoint truy vấn riêng, hoặc cho phép frontend lấy đúng phần dữ liệu cần dùng.
Plugin cung cấp bộ công cụ để tạo và quản lý GraphQL fetcher cho cả khu vực web và admin. Mỗi fetcher có thể được định nghĩa bằng JavaScript, kèm schema mô tả tham số đầu vào và dữ liệu trả về. Nhờ đó, lập trình viên có thể bổ sung truy vấn mới nhanh chóng mà không cần tạo thêm controller Java cho từng nhu cầu nhỏ.
Các tính năng chính
- Tạo GraphQL schema tự động từ các fetcher đã đăng ký.
- Hỗ trợ nhóm fetcher để tổ chức query rõ ràng hơn.
- Viết logic lấy dữ liệu bằng JavaScript với quyền truy cập vào request, query arguments, bean trong hệ thống, cấu hình ứng dụng, logger và thông tin người dùng đăng nhập.
- Hỗ trợ fetcher yêu cầu đăng nhập và kiểm tra authentication ở runtime.
- Sinh tài liệu REST API dạng OpenAPI/Swagger từ các controller được scan.
- Cung cấp trang xem GraphQL schema và Swagger UI cho web/admin, có thể bật tắt trong phần cài đặt.
- Cho phép quản lý system endpoint kèm bearer token để kết nối tới các điểm truy cập nội bộ an toàn.
- Hỗ trợ event handler script và Ezy Function để mở rộng logic xử lý sự kiện.
- Tích hợp MCP server cho admin, giúp các công cụ AI có thể đọc schema, gọi tool, đọc resource, lấy prompt và hỗ trợ thao tác với dữ liệu/cấu hình theo quyền admin.
GraphQL phù hợp cho các dự án EzyPlatform cần xây dựng API nhanh, tài liệu hóa API tự động, hoặc muốn mở rộng hệ thống bằng script mà vẫn giữ được khả năng quản lý qua admin UI. Plugin đặc biệt hữu ích khi làm website nội dung, thương mại điện tử, dashboard quản trị, công cụ AI nội bộ hoặc các hệ thống cần expose dữ liệu có kiểm soát cho frontend và automation tool.
Lưu ý: plugin không thay thế toàn bộ REST API hiện có. Thay vào đó, nó bổ sung một lớp truy vấn GraphQL, tài liệu API và cơ chế mở rộng bằng script để giúp hệ thống dễ tích hợp, dễ thử nghiệm và dễ phát triển hơn.