Primeng DataView懒加载与分页优化:实现客户端缓存以减少API请求

primeng dataview懒加载与分页优化:实现客户端缓存以减少api请求

本文旨在解决Primeng DataView在使用懒加载和分页时可能出现的重复API请求问题。通过在客户端实现页面数据的缓存机制,结合搜索参数的智能判断,优化了数据加载逻辑,确保仅在必要时才向后端发起请求,从而显著提升了数据视图的性能和用户体验,避免了不必要的网络开销和数据重复获取。

引言

Primeng的DataView组件提供了强大的数据展示能力,支持分页、排序和过滤等功能。当处理大量数据时,结合懒加载(Lazy Loading)模式可以显著提高前端应用的响应速度和用户体验,因为它只在需要时才从后端获取数据。然而,在实现懒加载和分页功能时,尤其是在用户频繁切换页面或应用搜索/过滤条件时,如果不进行适当的优化,可能会导致重复的API请求,从而增加服务器负担和降低客户端性能。

本文将详细探讨如何通过在客户端实现智能的页面数据缓存机制,来优化Primeng DataView的懒加载和分页行为,确保数据仅在首次加载或搜索条件发生变化时从API获取,而在用户访问已加载过的页面时直接从缓存中获取。

面临的挑战

在Primeng DataView中,当[lazy]=”true”时,onLazyLoad事件会在组件初始化、分页、排序或过滤条件改变时触发。如果同时使用onPage事件,或者在onLazyLoad内部不加区分地进行API调用,可能会遇到以下问题:

重复API请求: 用户在不同页面之间切换时,即使数据已经加载过,也可能再次触发API请求。数据不一致: 如果API请求频率过高,或者处理逻辑不当,可能导致DataView显示的数据与实际期望的数据不符。性能下降: 频繁的网络请求会增加延迟,消耗用户带宽,尤其是在移动网络环境下,用户体验会大打折扣。

初始的尝试可能包括在onPageChange和loadProducts中都进行API调用,但这会导致API请求的重复发送,并且由于异步操作,数据更新可能混乱。

解决方案:客户端页面缓存与智能请求

为了解决上述问题,我们引入一个客户端缓存机制,利用一个JavaScript对象来存储已加载的每一页数据。当用户请求某一页数据时,首先检查缓存中是否存在该页数据;如果存在且搜索条件未改变,则直接使用缓存数据;否则,才向API发起请求。

核心思路

缓存结构: 使用一个对象(例如 pagesItems),以页码作为键,存储对应页的产品列表作为值。搜索参数跟踪: 除了缓存产品数据,还需要存储当前的搜索参数(如 name, category, brands, priceRange, size),以便在用户切换页面时判断搜索条件是否发生变化。条件性API请求: 在onLazyLoad事件处理函数中,根据当前请求的页码和存储的搜索参数,决定是从缓存中读取数据还是发起新的API请求。强制刷新: 提供一个机制,例如搜索按钮点击,来强制清除缓存并重新发起API请求。

实现步骤

1. 定义数据接口

为了清晰地表示分页产品和搜索参数,我们定义以下接口:

// src/app/interface/product/pagable-products.tsexport interface PageableProducts {  products: Product[];  total_pages: number;  total_products: number;}// src/app/interface/product/product.tsexport interface Product {  id?: string;  brand: string;  name: string;  price: number;  category: string;  subcategory: string;  stock: number;  description: string;  image_url: string;}// src/app/interface/search/search.tsexport interface Search {  size: number;  page: number;  category?: string;  subcategory?: string;  brands?: string[];  priceRange?: number[];  name?: string;}

2. 产品服务 (ProductService)

产品服务负责向后端API发起请求,根据搜索参数获取分页产品数据。

// src/app/service/product.service.tsimport { Injectable } from '@angular/core';import { HttpClient, HttpHeaders, HttpParams } from "@angular/common/http";import { catchError, Observable, of, tap } from "rxjs";import { PageableProducts } from "../interface/product/pagable-products";import { Search } from "../interface/search/search";@Injectable({  providedIn: 'root'})export class ProductService {  private productUrl: string = 'http://localhost:8080/product/api';  httpOptions = {    headers: new HttpHeaders({'Content-Type': 'application/json'})  };  constructor(private http: HttpClient) { }  searchProducts(searchQuery: Search): Observable {    let queryParams = new HttpParams();    // 构建查询参数    if (searchQuery.name) queryParams = queryParams.append("name", searchQuery.name);    if (searchQuery.category) queryParams = queryParams.append("category", searchQuery.category);    if (searchQuery.subcategory) queryParams = queryParams.append("subcategory", searchQuery.subcategory);    if (searchQuery.brands && searchQuery.brands.length > 0) queryParams = queryParams.append("brands", searchQuery.brands.join(',')); // 假设后端接受逗号分隔    if (searchQuery.priceRange && searchQuery.priceRange.length === 2) {      queryParams = queryParams.append("pMin", searchQuery.priceRange[0]);      queryParams = queryParams.append("pMax", searchQuery.priceRange[1]);    }    if (searchQuery.page !== null && searchQuery.page >= 0) queryParams = queryParams.append("page", searchQuery.page);    if (searchQuery.size !== null && searchQuery.size > 0) queryParams = queryParams.append("size", searchQuery.size);    console.log(`Sending API request with params: ${queryParams.toString()}`);    return this.http.get(`${this.productUrl}/public/search`, { params: queryParams }).pipe(      tap(_ => console.log(`Fetched products for page ${searchQuery.page}`)),      catchError(this.handleError('searchProducts', { products: [], total_pages: 0, total_products: 0 }))    );  }  private handleError(operation = 'operation', result?: T) {    return (error: any): Observable => {      console.error(`${operation} failed: ${error.message}`);      return of(result as T);    };  }}

3. 搜索组件 (SearchComponent)

这是实现缓存逻辑的核心部分。

// src/app/search/search.component.tsimport { Component, OnInit } from '@angular/core';import { ActivatedRoute } from '@angular/router';import { Title } from '@angular/platform-browser';import { Product, PageableProducts } from '../interface/product/product'; // 假设Product和PageableProducts在同一个文件import { Search } from '../interface/search/search';import { ProductService } from '../service/product.service';import { CategoryService } from '../service/category.service'; // 假设存在import { BrandService } from '../service/brand.service';     // 假设存在import { CategoryDto } from '../interface/category/category-dto'; // 假设存在import { BrandDto } from '../interface/brand/brand-dto';     // 假设存在import { StorageService } from '../service/storage.service'; // 假设存在,用于购物车@Component({  selector: 'app-search',  templateUrl: './search.component.html',  styleUrls: ['./search.component.css']})export class SearchComponent implements OnInit {  virtualProducts: Product[] = []; // Primeng DataView实际显示的数据  selectedSize = 40; // 每页产品数量  totalRecords = 0; // 总产品数量  selectedPage = 0; // 当前页码 (0-indexed)  first = 0;        // Primeng DataView的first属性,表示当前页第一条记录的索引  // 搜索参数  name?: string;  category: string = '';  subcategory?: string;  selectedBrands: string[] = [];  priceRange: number[] = [0, 4000];  selectedPriceRange: number[] = [20, 1000];  // 过滤选项  subcategories: string[] = [];  brands: string[] = [];  sizeOptions: number[] = [5, 20, 40, 60, 80, 100, 200, 500];  loading: boolean = false; // DataView的加载状态  pagesItems: { [key: string]: any } = {}; // 客户端缓存,键为页码或'searchParams'/'size'等  constructor(    private categoryService: CategoryService,    private brandService: BrandService,    private productService: ProductService,    private route: ActivatedRoute,    private titleService: Title,    private storageService: StorageService // 用于购物车功能  ) { }  ngOnInit(): void {    this.route.params.subscribe(params => {      this.category = params['category'];      this.updateFilterValues(); // 获取分类和品牌选项      if (this.category) {        this.titleService.setTitle(this.category);      }      // 页面初始化时,根据当前路由参数构建初始搜索条件      const initialSearchParams: Search = {        size: this.selectedSize,        page: this.selectedPage,        category: this.category,        subcategory: this.subcategory,        brands: this.selectedBrands,        priceRange: this.selectedPriceRange,        name: this.name      };      // 发起初始搜索请求      this.search(initialSearchParams);      // 延迟更新virtualProducts,确保API响应已到达并缓存      setTimeout(() => {        if (this.pagesItems[this.selectedPage]) {          this.virtualProducts = [...this.pagesItems[this.selectedPage]];        }      }, 500); // 适当调整延迟时间    });  }  /**   * 向API发起产品搜索请求,并将结果缓存。   * @param searchParams 当前的搜索参数。   */  search(searchParams: Search): void {    this.loading = true;    this.productService.searchProducts(searchParams).subscribe({      next: (value: PageableProducts) => {        // 缓存当前的搜索参数和分页大小        this.pagesItems['searchParams'] = {          category: searchParams.category,          subcategory: searchParams.subcategory,          brands: searchParams.brands,          priceRange: searchParams.priceRange,          name: searchParams.name        };        this.pagesItems['size'] = searchParams.size;        this.pagesItems['page'] = searchParams.page; // 缓存当前请求的页码        // 缓存当前页的产品数据        this.pagesItems[searchParams.page] = [...value.products];        this.totalRecords = value.total_products;        this.loading = false;        console.log(`API fetched page ${searchParams.page}, total products: ${this.totalRecords}`);      },      error: (err) => {        console.error('Search API error:', err);        this.loading = false;      }    });  }  /**   * Primeng DataView的onLazyLoad事件处理函数。   * 根据分页或搜索条件变化,决定从缓存加载或发起API请求。   * @param event LazyLoadEvent对象,包含first、rows等信息。   * @param isButtonClicked 标记是否由搜索按钮点击触发,用于强制刷新缓存。   */  loadProducts(event: any, isButtonClicked: boolean): void {    this.loading = true;    this.first = event.first;    this.selectedSize = event.rows;    this.selectedPage = Math.floor(this.first / this.selectedSize); // 计算当前页码    const currentSearchParams: Search = {      size: this.selectedSize,      page: this.selectedPage,      category: this.category,      subcategory: this.subcategory,      brands: this.selectedBrands,      priceRange: this.selectedPriceRange,      name: this.name    };    // 如果是搜索按钮点击,或者搜索条件发生变化,则清空缓存并重新开始    if (isButtonClicked || (this.pagesItems && !this.isSameSearchParams(currentSearchParams))) {      this.pagesItems = {}; // 清空整个缓存      this.pagesItems['searchParams'] = { ...currentSearchParams }; // 更新为新的搜索参数      this.pagesItems['size'] = this.selectedSize;      this.pagesItems['page'] = this.selectedPage;    }    // 检查缓存中是否存在当前页的数据    if (this.pagesItems[this.selectedPage] === undefined) {      console.log(`Page ${this.selectedPage} not in cache. Fetching from API...`);      // 如果缓存中没有,则发起API请求      this.search(currentSearchParams);      // 延迟更新virtualProducts,等待API响应并缓存      setTimeout(() => {        if (this.pagesItems[this.selectedPage]) {          this.virtualProducts = [...this.pagesItems[this.selectedPage]];        }        this.loading = false;        event.forceUpdate = true; // 强制DataView更新      }, 500); // 适当调整延迟时间    } else {      console.log(`Page ${this.selectedPage} found in cache. Loading from cache...`);      // 如果缓存中有,则直接从缓存加载      this.virtualProducts = [...this.pagesItems[this.selectedPage]];      this.loading = false;      event.forceUpdate = true; // 强制DataView更新    }  }  /**   * 比较当前搜索参数与缓存中的搜索参数是否一致。   * 用于判断是否需要清空缓存并重新搜索。   * @param currentParams 当前的搜索参数。   * @returns 如果搜索参数一致则返回true,否则返回false。   */  isSameSearchParams(currentParams: Search): boolean {    const cachedParams = this.pagesItems['searchParams'];    if (!cachedParams) return false; // 缓存中没有搜索参数,视为不一致    // 比较各个搜索字段,注意数组和对象的深层比较    const areBrandsSame = JSON.stringify(currentParams.brands?.sort()) === JSON.stringify(cachedParams.brands?.sort());    const arePriceRangeSame = JSON.stringify(currentParams.priceRange) === JSON.stringify(cachedParams.priceRange);    return currentParams.name === cachedParams.name &&           currentParams.category === cachedParams.category &&           currentParams.subcategory === cachedParams.subcategory &&           areBrandsSame &&           arePriceRangeSame &&           currentParams.size === this.pagesItems['size']; // 也要比较每页大小  }  /**   * 搜索按钮点击事件,重置分页并强制刷新缓存。   */  OnSearchButtonClick(): void {    this.first = 0; // 重置到第一页    this.loadProducts({ first: this.first, rows: this.selectedSize, forceUpdate: true }, true);  }  // --- 其他辅助方法 ---  private fetchCategories(category: string): void {    this.categoryService.getSubcategoriesByCategoryName(category).subscribe((categories: CategoryDto[]) => {      this.subcategories = categories.map((c: CategoryDto) => c.name);    });  }  private fetchBrands(category: string): void {    this.brandService.getBrandsByCategoryName(category).subscribe((brands: BrandDto[]) => {      this.brands = brands.map((b: BrandDto) => b.name);    });  }  updateFilterValues(): void {    if (this.category) {      this.fetchCategories(this.category);      this.fetchBrands(this.category);    }  }  addToCart(productId: string | undefined): void {    if (productId) {      this.storageService.addToCart(productId);      console.log('Cart:', this.storageService.getCart());    }  }}

4. HTML模板 (search.component.html)

DataView组件的配置需要绑定到组件的属性和事件上。

Price Range: {{selectedPriceRange[0]}} - {{selectedPriceRange[1]}}

{{ product.name }}
{{ product.subcategory }}

以上就是Primeng DataView懒加载与分页优化:实现客户端缓存以减少API请求的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1523663.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月20日 16:06:31
下一篇 2025年12月20日 16:06:43

相关推荐

  • CSS mask属性无法获取图片:为什么我的图片不见了?

    CSS mask属性无法获取图片 在使用CSS mask属性时,可能会遇到无法获取指定照片的情况。这个问题通常表现为: 网络面板中没有请求图片:尽管CSS代码中指定了图片地址,但网络面板中却找不到图片的请求记录。 问题原因: 此问题的可能原因是浏览器的兼容性问题。某些较旧版本的浏览器可能不支持CSS…

    2025年12月24日
    900
  • 如何用dom2img解决网页打印样式不显示的问题?

    用dom2img解决网页打印样式不显示的问题 想将网页以所见即打印的的效果呈现,需要采取一些措施,特别是在使用了bootstrap等大量采用外部css样式的框架时。 问题根源 在常规打印操作中,浏览器通常会忽略css样式等非必要的页面元素,导致打印出的结果与网页显示效果不一致。这是因为打印机制只识别…

    2025年12月24日
    800
  • 如何用 CSS 模拟不影响其他元素的链接移入效果?

    如何模拟 css 中链接的移入效果 在 css 中,模拟移入到指定链接的效果尤为复杂,因为链接的移入效果不影响其他元素。要实现这种效果,最简单的方法是利用放大,例如使用 scale 或 transform 元素的 scale 属性。下面提供两种方法: scale 属性: .goods-item:ho…

    2025年12月24日
    700
  • Uniapp 中如何不拉伸不裁剪地展示图片?

    灵活展示图片:如何不拉伸不裁剪 在界面设计中,常常需要以原尺寸展示用户上传的图片。本文将介绍一种在 uniapp 框架中实现该功能的简单方法。 对于不同尺寸的图片,可以采用以下处理方式: 极端宽高比:撑满屏幕宽度或高度,再等比缩放居中。非极端宽高比:居中显示,若能撑满则撑满。 然而,如果需要不拉伸不…

    2025年12月24日
    400
  • PC端H5项目如何实现适配:流式布局、响应式设计和两套样式?

    PC端的适配方案及PC与H5兼顾的实现方案探讨 在开发H5项目时,常用的屏幕适配方案是postcss-pxtorem或postcss-px-to-viewport,通常基于iPhone 6标准作为设计稿。但对于PC端网项目,处理不同屏幕大小需要其他方案。 PC端屏幕适配方案 PC端屏幕适配一般采用流…

    2025年12月24日
    300
  • CSS 元素设置 10em 和 transition 后为何没有放大效果?

    CSS 元素设置 10em 和 transition 后为何无放大效果? 你尝试设置了一个 .box 类,其中包含字体大小为 10em 和过渡持续时间为 2 秒的文本。当你载入到页面时,它没有像 YouTube 视频中那样产生放大效果。 原因可能在于你将 CSS 直接写在页面中 在你的代码示例中,C…

    2025年12月24日
    400
  • 如何实现类似横向U型步骤条的组件?

    横向U型步骤条寻求替代品 希望找到类似横向U型步骤条的组件或 CSS 实现。 潜在解决方案 根据给出的参考图片,类似的组件有: 图片所示组件:图片提供了组件的外观,但没有提供具体的实现方式。参考链接:提供的链接指向了 SegmentFault 上的另一个问题,其中可能包含相关的讨论或解决方案建议。 …

    2025年12月24日
    800
  • 如何让小说网站控制台显示乱码,同时网页内容正常显示?

    如何在不影响用户界面的情况下实现控制台乱码? 当在小说网站上下载小说时,大家可能会遇到一个问题:网站上的文本在网页内正常显示,但是在控制台中却是乱码。如何实现此类操作,从而在不影响用户界面(UI)的情况下保持控制台乱码呢? 答案在于使用自定义字体。网站可以通过在服务器端配置自定义字体,并通过在客户端…

    2025年12月24日
    800
  • 如何优化CSS Grid布局中子元素排列和宽度问题?

    css grid布局中的优化问题 在使用css grid布局时可能会遇到以下问题: 问题1:无法控制box1中li的布局 box1设置了grid-template-columns: repeat(auto-fill, 20%),这意味着容器将自动填充尽可能多的20%宽度的列。当li数量大于5时,它们…

    2025年12月24日
    800
  • SASS 中的 Mixins

    mixin 是 css 预处理器提供的工具,虽然它们不是可以被理解的函数,但它们的主要用途是重用代码。 不止一次,我们需要创建多个类来执行相同的操作,但更改单个值,例如字体大小的多个类。 .fs-10 { font-size: 10px;}.fs-20 { font-size: 20px;}.fs-…

    2025年12月24日
    000
  • 如何在地图上轻松创建气泡信息框?

    地图上气泡信息框的巧妙生成 地图上气泡信息框是一种常用的交互功能,它简便易用,能够为用户提供额外信息。本文将探讨如何借助地图库的功能轻松创建这一功能。 利用地图库的原生功能 大多数地图库,如高德地图,都提供了现成的信息窗体和右键菜单功能。这些功能可以通过以下途径实现: 高德地图 JS API 参考文…

    2025年12月24日
    400
  • 如何使用 scroll-behavior 属性实现元素scrollLeft变化时的平滑动画?

    如何实现元素scrollleft变化时的平滑动画效果? 在许多网页应用中,滚动容器的水平滚动条(scrollleft)需要频繁使用。为了让滚动动作更加自然,你希望给scrollleft的变化添加动画效果。 解决方案:scroll-behavior 属性 要实现scrollleft变化时的平滑动画效果…

    2025年12月24日
    000
  • CSS mask 属性无法加载图片:浏览器问题还是代码错误?

    CSS mask 属性请求图片失败 在使用 CSS mask 属性时,您遇到了一个问题,即图片没有被请求获取。这可能是由于以下原因: 浏览器问题:某些浏览器可能在处理 mask 属性时存在 bug。尝试更新到浏览器的最新版本。代码示例中的其他信息:您提供的代码示例中还包含其他 HTML 和 CSS …

    2025年12月24日
    000
  • 如何为滚动元素添加平滑过渡,使滚动条滑动时更自然流畅?

    给滚动元素平滑过渡 如何在滚动条属性(scrollleft)发生改变时为元素添加平滑的过渡效果? 解决方案:scroll-behavior 属性 为滚动容器设置 scroll-behavior 属性可以实现平滑滚动。 html 代码: click the button to slide right!…

    2025年12月24日
    500
  • 如何用 CSS 实现链接移入效果?

    css 中实现链接移入效果的技巧 在 css 中模拟链接的移入效果可能并不容易,因为它们不会影响周围元素。但是,有几个方法可以实现类似的效果: 1. 缩放 最简单的方法是使用 scale 属性,它会放大元素。以下是一个示例: 立即学习“前端免费学习笔记(深入)”; .goods-item:hover…

    2025年12月24日
    000
  • 网页使用本地字体:为什么 CSS 代码中明明指定了“荆南麦圆体”,页面却仍然显示“微软雅黑”?

    网页中使用本地字体 本文将解答如何将本地安装字体应用到网页中,避免使用 src 属性直接引入字体文件。 问题: 想要在网页上使用已安装的“荆南麦圆体”字体,但 css 代码中将其置于第一位的“font-family”属性,页面仍显示“微软雅黑”字体。 立即学习“前端免费学习笔记(深入)”; 答案: …

    2025年12月24日
    000
  • 如何选择元素个数不固定的指定类名子元素?

    灵活选择元素个数不固定的指定类名子元素 在网页布局中,有时需要选择特定类名的子元素,但这些元素的数量并不固定。例如,下面这段 html 代码中,activebar 和 item 元素的数量均不固定: *n *n 如果需要选择第一个 item元素,可以使用 css 选择器 :nth-child()。该…

    2025年12月24日
    200
  • 如何用 CSS 实现类似卡券的缺口效果?

    类似卡券的布局如何实现 想要实现类似卡券的布局,可以使用遮罩(mask)来实现缺口效果。 示例代码: .card { -webkit-mask: radial-gradient(circle at 20px, #0000 20px, red 0) -20px;} 效果: 立即学习“前端免费学习笔记(…

    2025年12月24日
    000
  • 使用 SVG 如何实现自定义宽度、间距和半径的虚线边框?

    使用 svg 实现自定义虚线边框 如何实现一个具有自定义宽度、间距和半径的虚线边框是一个常见的前端开发问题。传统的解决方案通常涉及使用 border-image 引入切片图片,但是这种方法存在引入外部资源、性能低下的缺点。 为了避免上述问题,可以使用 svg(可缩放矢量图形)来创建纯代码实现。一种方…

    2025年12月24日
    100
  • 如何用纯代码实现自定义宽度和间距的虚线边框?

    自定义宽度和间距的虚线边框 提问: 如何创建一个自定义宽度和间距的虚线边框,如下图所示: 元素宽度:8px元素高度:1px间距:2px圆角:4px 解答: 传统的解决方案通常涉及使用 border-image 引入切片的图片来实现。但是,这需要引入外部资源。本解答将提供一种纯代码的方法,使用 svg…

    2025年12月24日
    000

发表回复

登录后才能评论
关注微信