#MultiRecordResource

Resource hướng đến collection: request trả về array, hỗ trợ phân trang, filter, sort và CRUD. Phù hợp với các kịch bản "nhiều bản ghi" như table, list. Khác với APIResource, MultiRecordResource chỉ định tên resource qua setResourceName(), tự động xây dựng URL như users:list, users:create, và có sẵn các khả năng phân trang, filter, hàng được chọn, v.v.

Quan hệ kế thừa: FlowResource → APIResource → BaseRecordResource → MultiRecordResource.

Cách tạo: ctx.makeResource('MultiRecordResource') hoặc ctx.initResource('MultiRecordResource'). Trước khi sử dụng cần setResourceName('tên collection') (như 'users'); trong RunJS, ctx.api được inject bởi môi trường runtime.

#Kịch bản áp dụng

#Định dạng dữ liệu

• getData() trả về array bản ghi, tức là trường data của API list
• getMeta() trả về metadata phân trang, v.v.: page, pageSize, count, totalPage, v.v.

#Tên resource và data source

#Tham số request (filter / field / sort)

#Phân trang

#Hàng đã chọn (kịch bản table)

#CRUD và thao tác list

#Cấu hình và sự kiện

#Ví dụ

#List cơ bản

ctx.initResource('MultiRecordResource');
ctx.resource.setResourceName('users');
ctx.resource.setPageSize(20);
await ctx.resource.refresh();
const rows = ctx.resource.getData();
const total = ctx.resource.getCount();

#Filter và sort

ctx.resource.setResourceName('users');
ctx.resource.setFilter({ status: 'active' });
ctx.resource.setSort(['-createdAt']);
ctx.resource.setFields(['id', 'nickname', 'email']);
await ctx.resource.refresh();

#Mở rộng quan hệ

ctx.resource.setResourceName('orders');
ctx.resource.setAppends(['user', 'items']);
await ctx.resource.refresh();
const orders = ctx.resource.getData();

#Tạo và lật trang

await ctx.resource.create({ name: '张三', email: 'zhangsan@example.com' });

await ctx.resource.next();
await ctx.resource.previous();
await ctx.resource.goto(3);

#Xóa hàng loạt hàng đã chọn

const rows = ctx.resource?.getSelectedRows?.() || [];
if (rows.length === 0) {
  ctx.message.warning('请先选择数据');
  return;
}
await ctx.resource.destroySelectedRows();
ctx.message.success(ctx.t('已删除'));

#Lắng nghe sự kiện refresh

ctx.resource?.on?.('refresh', () => {
  const data = ctx.resource.getData();
  ctx.render(<ul>{data?.map((r) => <li key={r.id}>{r.name}</li>)}</ul>);
});
await ctx.resource?.refresh?.();

#Resource quan hệ (sub-table)

const res = ctx.makeResource('MultiRecordResource');
res.setResourceName('users.roles');
res.setSourceId(ctx.record?.id);
await res.refresh();
const roles = res.getData();

#Lưu ý

• setResourceName bắt buộc: Trước khi sử dụng phải gọi setResourceName('tên collection'), nếu không sẽ không thể xây dựng URL request.
• Resource quan hệ: Khi tên resource là parent.child (như users.tags), cần setSourceId(primary key bản ghi cha) trước.
• Debounce refresh: Nhiều lần gọi refresh() trong cùng event loop chỉ thực thi lần cuối, tránh request trùng lặp.
• getData là array: data được trả về bởi API list chính là array bản ghi, getData() trả về trực tiếp array đó.

#Liên quan

• ctx.resource - Instance resource trong ngữ cảnh hiện tại
• ctx.initResource() - Khởi tạo và bind vào ctx.resource
• ctx.makeResource() - Tạo instance resource mới, không bind
• APIResource - Resource API thông dụng, request theo URL
• SingleRecordResource - Hướng đến bản ghi đơn