#MultiRecordResource

Um Resource voltado para coleções (tabelas de dados): as requisições retornam um array e suportam paginação, filtragem, ordenação e operações CRUD. É adequado para cenários de "múltiplos registros", como tabelas e listas. Diferente do APIResource, o MultiRecordResource especifica o nome do recurso via setResourceName(), constrói automaticamente URLs como users:list e users:create, e possui capacidades integradas de paginação, filtragem e seleção de linhas.

Herança: FlowResource → APIResource → BaseRecordResource → MultiRecordResource.

Formas de criação: ctx.makeResource('MultiRecordResource') ou ctx.initResource('MultiRecordResource'). Antes de usar, você deve chamar setResourceName('nome_da_coleção') (ex: 'users'); no RunJS, o ctx.api é injetado pelo ambiente de execução.

#Cenários de uso

#Formato de dados

• getData() retorna um array de registros, que corresponde ao campo data da resposta da API de listagem.
• getMeta() retorna metadados de paginação e outros: page, pageSize, count, totalPage, etc.

#Nome do recurso e fonte de dados

#Parâmetros de requisição (Filtro / Campos / Ordenação)

#Paginação

#Linhas selecionadas (Cenários de tabela)

#CRUD e operações de lista

#Configuração e eventos

#Exemplos

#Lista básica

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();

#Filtragem e ordenação

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

#Carregamento de associações

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

#Criação e paginação

await ctx.resource.create({ name: 'João Silva', email: 'joao.silva@example.com' });

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

#Excluir linhas selecionadas em massa

const rows = ctx.resource?.getSelectedRows?.() || [];
if (rows.length === 0) {
  ctx.message.warning('Por favor, selecione os dados primeiro');
  return;
}
await ctx.resource.destroySelectedRows();
ctx.message.success(ctx.t('Excluído'));

#Ouvindo o evento 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?.();

#Recurso de associação (Subtabela)

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

#Notas

• setResourceName é obrigatório: Você deve chamar setResourceName('nome_da_coleção') antes do uso, caso contrário, a URL da requisição não poderá ser construída.
• Recursos de associação: Quando o nome do recurso está no formato pai.filho (ex: users.tags), você deve chamar setSourceId(chave_primaria_do_pai) primeiro.
• Debounce no refresh: Múltiplas chamadas para refresh() dentro do mesmo loop de eventos executarão apenas a última para evitar requisições redundantes.
• getData retorna um Array: O data retornado pela API de listagem é um array de registros, e getData() retorna este array diretamente.

#Relacionado

• ctx.resource - A instância de recurso no contexto atual
• ctx.initResource() - Inicializa e vincula ao ctx.resource
• ctx.makeResource() - Cria uma nova instância de recurso sem vincular
• APIResource - Recurso de API genérico solicitado por URL
• SingleRecordResource - Voltado para um único registro