JEECG Boot Vue3 3.6.0 实现前端分页不重复请求接口方案

在JEECG Boot Vue3 3.6.0项目中，开发人员经常会遇到需要一次性获取所有数据并在前端实现分页展示的需求。这种场景下，传统的每次翻页都请求接口的方式会造成不必要的网络开销和服务器压力。本文将详细介绍如何在前端实现一次性获取数据后，后续分页操作不再请求接口的优化方案。

技术背景

JEECG Boot是一个基于Spring Boot和Vue.js的企业级快速开发平台。在Vue3版本中，列表组件通常采用分页方式展示数据。默认情况下，每次翻页都会触发新的API请求，这在某些业务场景下并不是最优解。

实现原理

要实现前端分页不重复请求接口，核心思路是：

1. 首次加载时获取全部数据
2. 将数据存储在组件状态中
3. 分页操作仅对本地数据进行切片处理
4. 更新视图而不触发新的API请求

具体实现步骤

1. 修改列表组件数据获取逻辑

在列表组件中，我们需要调整数据获取的方式。首先确保API请求只会在初始化或手动刷新时触发：

// 在setup函数中定义响应式数据
const tableData = ref([])
const allData = ref([]) // 存储全部数据
const loading = ref(false)

// 获取数据方法
const fetchData = async (params = {}) => {
  loading.value = true
  try {
    const res = await api.getList(params)
    allData.value = res.result.records || []
    // 首次加载时显示第一页数据
    updateTableData(1)
  } finally {
    loading.value = false
  }
}

2. 实现前端分页逻辑

添加分页处理方法，根据当前页码和每页大小对全量数据进行切片：

const pagination = reactive({
  current: 1,
  pageSize: 10,
  total: 0,
  showSizeChanger: true,
  showQuickJumper: true,
  pageSizeOptions: ['10', '20', '30', '50']
})

// 更新表格数据
const updateTableData = (currentPage) => {
  const start = (currentPage - 1) * pagination.pageSize
  const end = start + pagination.pageSize
  tableData.value = allData.value.slice(start, end)
  pagination.current = currentPage
  pagination.total = allData.value.length
}

// 分页变化回调
const handleTableChange = (pag) => {
  pagination.pageSize = pag.pageSize
  updateTableData(pag.current)
}

3. 调整模板部分

在模板中，确保分页组件绑定正确的事件和数据：

<a-table
  :columns="columns"
  :dataSource="tableData"
  :pagination="pagination"
  :loading="loading"
  @change="handleTableChange"
>
</a-table>

注意事项

1. 数据量控制：此方案适合数据量不大的场景，如果数据量过大（如超过万条），建议仍采用后端分页
2. 数据一致性：如果数据可能被其他用户修改，需要定期刷新或提供手动刷新按钮
3. 性能优化：对于大数据量，可以考虑使用虚拟滚动等技术优化渲染性能
4. 内存管理：长时间不刷新页面时，注意内存占用问题

扩展功能

添加手动刷新

可以添加一个刷新按钮，允许用户手动获取最新数据：

const handleRefresh = () => {
  fetchData()
}

添加搜索过滤

在本地数据基础上实现搜索过滤功能：

const searchValue = ref('')

const handleSearch = () => {
  if (!searchValue.value) {
    updateTableData(1)
    return
  }
  
  const filtered = allData.value.filter(item => 
    Object.values(item).some(val => 
      String(val).toLowerCase().includes(searchValue.value.toLowerCase())
    )
  )
  
  tableData.value = filtered.slice(0, pagination.pageSize)
  pagination.total = filtered.length
  pagination.current = 1
}

通过以上方案，我们可以在JEECG Boot Vue3项目中实现高效的前端分页功能，减少不必要的网络请求，提升用户体验和系统性能。