useMany

useMany hook 用于批量获取多条数据记录。

功能特点

• 📄 批量查询 - 根据 ID 列表获取多条资源
• 📱 自动缓存 - 智能缓存管理，避免重复请求
• 🔄 自动重新验证 - 数据过期时自动刷新
• ⚡ 实时状态 - 提供加载、错误、成功状态
• 🛡️ 错误处理 - 自动处理网络错误和认证失败
• 🎯 多数据源 - 支持指定不同的数据提供者

接口关系

该hook调用数据提供者的 getMany(options, manage, auth) 方法获取多条数据。

// 数据提供者接口
interface IDataProvider {
  getMany(
    options: IDataProviderGetManyOptions,
    manage?: IManageHook,
    auth?: IUserState
  ): Promise<IDataProviderResponse>
}

// 请求选项接口
interface IDataProviderGetManyOptions {
  path: string                                          // API 路径
  ids: (string | number)[]                             // 资源 ID 列表
  meta?: Record<string, any>                           // 额外参数
}

// 响应数据接口
interface IDataProviderResponse {
  message?: string                          // 响应消息
  data?: any                                // 响应数据
  meta?: Record<string, any>                // 元数据信息
  [key: string]: any                        // 其他自定义字段
}

使用方法

import { useMany } from '@duxweb/dvha-core'

const { data, isLoading, isError, error } = useMany({
  path: 'users',
  ids: [1, 2, 3]
})

常用参数

const { data, isLoading, isError, error, refetch } = useMany({
  // 必需参数
  path: 'users',           // API 路径
  ids: [1, 2, 3, 4, 5],    // 资源 ID 列表

  // 可选参数
  meta: {                  // 额外参数
    include: 'profile,roles'
  },
  providerName: 'default', // 数据提供者名称，默认为 'default'
  onError: (err) => {      // 错误回调
    console.error('批量获取失败:', err)
  }
})

参数说明

参数	类型	必需	说明
path	string	✅	API 资源路径
ids	(string | number)[]	✅	资源 ID 列表
meta	Record<string, any>	❌	传递给 API 的额外参数
providerName	string	❌	数据提供者名称，默认为 'default'
onError	(error: any) => void	❌	错误处理回调
options	IDataQueryOptions	❌	TanStack Query 选项

返回值

字段	类型	说明
data	Ref<any>	响应数据
isLoading	Ref<boolean>	是否加载中
isError	Ref<boolean>	是否出错
error	Ref<any>	错误信息
refetch	Function	重新获取数据

动态 ID 列表查询

import { useMany } from '@duxweb/dvha-core'
import { ref, watch } from 'vue'

const selectedIds = ref([1, 2, 3])

const { data, isLoading, refetch } = useMany({
  path: 'users',
  ids: selectedIds.value
})

// 监听 ID 列表变化，自动重新获取
watch(selectedIds, () => {
  refetch()
})

多数据提供者示例

import { useMany } from '@duxweb/dvha-core'

// 使用默认数据提供者获取多个用户
const { data: users } = useMany({
  path: 'users',
  ids: [1, 2, 3]
})

// 使用分析服务获取多个报告
const { data: reports } = useMany({
  path: 'reports',
  ids: ['report-1', 'report-2', 'report-3'],
  providerName: 'analytics'
})

// 使用支付服务获取多个订单
const { data: orders } = useMany({
  path: 'orders',
  ids: ['order-1', 'order-2'],
  providerName: 'payment',
  meta: {
    include: 'items,shipping'
  }
})

响应格式

{
  "message": "获取成功",
  "data": [
    {
      "id": 1,
      "name": "张三",
      "email": "zhangsan@example.com"
    },
    {
      "id": 2,
      "name": "李四",
      "email": "lisi@example.com"
    },
    {
      "id": 3,
      "name": "王五",
      "email": "wangwu@example.com"
    }
  ]
}