四種全局狀態(tài)數(shù)據(jù)

在實際開發(fā)當(dāng)中，會遇到四種全局狀態(tài)數(shù)據(jù)：異步數(shù)據(jù)（一般來自服務(wù)端）、同步數(shù)據(jù)。同步數(shù)據(jù)又分為三種：localstorage、cookie、內(nèi)存。在傳統(tǒng)的 Vue3 當(dāng)中，分別采用不同的機制來處理這些狀態(tài)數(shù)據(jù)，而在 Zova 中只需要采用統(tǒng)一的Model機制

采用 Model 機制統(tǒng)一管理這些全局狀態(tài)數(shù)據(jù)，就可以提供一些通用的系統(tǒng)能力，比如，內(nèi)存優(yōu)化、持久化和SSR支持等等，從而規(guī)范數(shù)據(jù)使用方式，簡化代碼結(jié)構(gòu)，提升代碼的可維護性

特性1. 支持異步數(shù)據(jù)和同步數(shù)據(jù)

Zova Model 的基座是TanStack Query。TanStack Query 提供了強大的數(shù)據(jù)獲取、緩存和更新能力。如果你沒有使用過類似TanStack Query的數(shù)據(jù)管理機制，那么強烈建議了解一下，相信你一定會受到思想的洗禮
但是，TanStack Query 的核心是對異步數(shù)據(jù)（一般來自服務(wù)端）進行管理。Zova Model 在 TanStack Query 的基礎(chǔ)上做了擴展，因此也支持同步數(shù)據(jù)的管理。換而言之，以下所述所有特性和能力同時適用于異步數(shù)據(jù)和同步數(shù)據(jù)

特性2. 自動緩存

對獲取的異步數(shù)據(jù)進行本地緩存，避免重復(fù)獲取。對于同步數(shù)據(jù)，會自動針對 localstorage 或者 cookie 進行讀寫操作

特性3. 自動更新

提供數(shù)據(jù)過期策略，在合適的時機自動更新

特性4. 減少重復(fù)請求

在程序的多個地方同時訪問數(shù)據(jù)，將只調(diào)用一次服務(wù)端 api。如果是同步數(shù)據(jù)，也只針對 localstorage 或者 cookie 調(diào)用一次操作

特性5. 內(nèi)存優(yōu)化

通過 Zova Model 管理的數(shù)據(jù)，雖然是全局范圍的狀態(tài)，但是并不總是占用內(nèi)存，而是提供了內(nèi)存釋放與回收的機制。具體而言，就是在創(chuàng)建 Vue 組件實例時根據(jù)業(yè)務(wù)的需要創(chuàng)建緩存數(shù)據(jù)，當(dāng) Vue 組件實例卸載時釋放對緩存數(shù)據(jù)的引用，到達約定的過期時間如果仍然沒有其他 Vue 組件引用，就會觸發(fā)回收機制(GC)，完成對內(nèi)存的釋放，從而節(jié)約內(nèi)存占用。這對于大型項目，用戶需要長時間進行界面交互的場景，具有顯著的好處

特性6. 持久化

本地緩存可以持久化，當(dāng)頁面刷新時可以自動恢復(fù)，避免服務(wù)端調(diào)用。如果是異步數(shù)據(jù)，就會自動持久化到 IndexDB 中，從而滿足大數(shù)據(jù)量的存儲需要。如果是同步數(shù)據(jù)，就會自動持久化到 localstorage 或者 cookie

內(nèi)存優(yōu)化與持久化配合發(fā)揮作用，對于大型項目效果更佳明顯。比如，第一次從服務(wù)端獲取的數(shù)據(jù)，會生成本地緩存，并自動持久化。當(dāng)頁面不再使用并且過期時，會自動銷毀本地緩存，從而釋放內(nèi)存。當(dāng)再次訪問該數(shù)據(jù)時，會自動從持久化中恢復(fù)本地緩存數(shù)據(jù)，而不是再次從服務(wù)端獲取數(shù)據(jù)

特性7. SSR支持

不同類型的狀態(tài)數(shù)據(jù)，在 SSR 模式下也會有不同的實現(xiàn)機制。Zova Model 把這些狀態(tài)數(shù)據(jù)的差異進行抹平，并且采用統(tǒng)一的機制進行水合，從而讓 SSR 的實現(xiàn)更加自然、直觀，顯著降低了心智負擔(dān)

特性8. 自動命名空間隔離

Zova 通過 Model Bean 來管理數(shù)據(jù)。而 Bean 本身有唯一的標(biāo)識，可以作為數(shù)據(jù)的命名空間，從而自動保證了 Bean 內(nèi)部狀態(tài)數(shù)據(jù)命名的唯一性，避免數(shù)據(jù)沖突

• 參見：Bean標(biāo)識

如何創(chuàng)建一個Model Bean

Zova提供了VS Code插件，通過右鍵菜單可以非常便利的創(chuàng)建一個Model Bean

右鍵菜單 - [模塊路徑]: Zova Create/Bean: Model

依據(jù)提示輸入 model bean 的名稱，比如todo，VSCode 插件會自動添加 model bean 的代碼骨架

比如，在 demo-todo 模塊中創(chuàng)建一個 Model Bean todo

demo-todo/src/bean/model.todo.ts

import { Model } from 'zova';
import { BeanModelBase } from 'zova-module-a-model';
@Model()
export class ModelTodo extends BeanModelBase {}

• 使用@Model 裝飾器
• 繼承自基類 BeanModelBase

異步數(shù)據(jù)

TanStack Query 的核心是對服務(wù)端數(shù)據(jù)進行管理。為簡化起見，這里僅展示select方法的定義與使用:

• 完整代碼示例，請參見：demo-todo

如何定義

@Model()
export class ModelTodo {
  select() {
    return this.$useQueryExisting({
      queryKey: ['select'],
      queryFn: async () => {
        return this.scope.service.todo.select();
      },
    });
  }
}

• 調(diào)用$useQueryExisting 創(chuàng)建 Query 對象
  • 為何不使用$useQuery方法？因為異步數(shù)據(jù)一般是在需要時才進行異步加載。因此我們需要確保在多次調(diào)用select方法時始終返回同一個 Query 對象，所以必須使用$useQueryExisting方法
• 傳入 queryKey，確保本地緩存的唯一性
• 傳入 queryFn，在合適的時機調(diào)用此函數(shù)獲取服務(wù)端數(shù)據(jù)
  • service.todo.select：參見Api服務(wù)

如何使用

demo-todo/src/page/todo/controller.ts

import { ModelTodo } from '../../bean/model.todo.js';
export class ControllerPageTodo {
  @Use()
  $$modelTodo: ModelTodo;
}

• 注入 Model Bean 實例：$$modelTodo

demo-todo/src/page/todo/render.tsx

export class RenderTodo {
  render() {
    const todos = this.$$modelTodo.select();
    return (
      <div>
        <div>isLoading: {todos.isLoading}</div>
        <div>
          {todos.data?.map(item => {
            return <div>{item.title}</div>;
          })}
        </div>
      </div>
    );
  }
}

• 調(diào)用 select 方法獲取 Query 對象
  • render 方法會多次執(zhí)行，重復(fù)調(diào)用 select 方法返回的是同一個 Query 對象
• 直接使用 Query 對象中的狀態(tài)和數(shù)據(jù)
  • 參見：TanStack Query: Queries

如何支持SSR

在 SSR 模式下，我們需要這樣使用異步數(shù)據(jù)：在服務(wù)端加載狀態(tài)數(shù)據(jù)，然后通過 render 方法渲染成 html 字符串。狀態(tài)數(shù)據(jù)和 html 字符串會同時發(fā)送到客戶端，客戶端在進行水合時仍然使用此相同的狀態(tài)數(shù)據(jù)，從而保持狀態(tài)的一致性

要實現(xiàn)以上邏輯，在 Zova Model 中只需要執(zhí)行一個步驟：

demo-todo/src/page/todo/controller.ts

import { ModelTodo } from '../../bean/model.todo.js';
export class ControllerPageTodo {
  @Use()
  $$modelTodo: ModelTodo;
  protected async __init__() {
    const queryTodos = this.$$modelTodo.select();
    await queryTodos.suspense();
    if (queryTodos.error) throw queryTodos.error;
  }
}

• 只需要在__init__方法中調(diào)用suspense等待異步數(shù)據(jù)加載完成

同步數(shù)據(jù): localstorage

由于服務(wù)端不支持window.localStorage，因此 localstorage 狀態(tài)數(shù)據(jù)不參與 SSR 的水合過程

下面演示把用戶信息存入 localstorage，當(dāng)頁面刷新時也會保持狀態(tài)

如何定義

export class ModelUser extends BeanModelBase {
  user?: ServiceUserEntity;
  protected async __init__() {
    this.user = this.$useQueryLocal({
      queryKey: ['user'],
    });
  }
}

• 與異步數(shù)據(jù)定義不同，同步數(shù)據(jù)直接在初始化方法__init__中定義
• 調(diào)用$useQueryLocal 創(chuàng)建 Query 對象
• 傳入 queryKey，確保本地緩存的唯一性

如何使用

直接像常規(guī)變量一樣讀取和設(shè)置數(shù)據(jù)

const user = this.user;
this.user = newUser;

同步數(shù)據(jù): cookie

在服務(wù)端會自動使用Request Header中的 Cookies，在客戶端會自動使用document.cookie，因此會自動保證 SSR 水合過程中 cookie 狀態(tài)數(shù)據(jù)的一致性

下面演示把用戶 Token 存入 cookie，當(dāng)頁面刷新時也會保持狀態(tài)。這樣，在 SSR 模式下，客戶端和服務(wù)端都可以使用相同的jwt token訪問后端 API 服務(wù)

如何定義

export class ModelUser extends BeanModelBase {
  token?: string;
  protected async __init__() {
    this.token = this.$useQueryCookie({
      queryKey: ['token'],
    });
  }
}

• 與異步數(shù)據(jù)定義不同，同步數(shù)據(jù)直接在初始化方法__init__中定義
• 調(diào)用$useQueryCookie 創(chuàng)建 Query 對象
• 傳入 queryKey，確保本地緩存的唯一性

如何使用

直接像常規(guī)變量一樣讀取和設(shè)置數(shù)據(jù)

const token = this.token;
this.token = newToken;

同步數(shù)據(jù): 內(nèi)存

在 SSR 模式下，服務(wù)端定義的全局狀態(tài)數(shù)據(jù)會同步到客戶端，并自動完成水合

下面演示基于內(nèi)存的全局狀態(tài)數(shù)據(jù)

如何定義

zova-ui-quasar/src/suite-vendor/a-quasar/modules/quasar-adapter/src/bean/model.theme.ts

export class ModelTheme extends BeanModelBase {
  cBrand: string;
  protected async __init__() {
    this.cBrand = this.$useQueryMem({
      queryKey: ['cBrand'],
    });
  }
}

• 與異步數(shù)據(jù)定義不同，同步數(shù)據(jù)直接在初始化方法__init__中定義
• 調(diào)用$useQueryMem 創(chuàng)建 Query 對象
• 傳入 queryKey，確保本地緩存的唯一性

如何使用

直接像常規(guī)變量一樣讀取和設(shè)置數(shù)據(jù)

const cBrand = this.cBrand;
this.cBrand = newValue;

結(jié)語

Zova 是一款支持 IOC 容器的 Vue3 框架，在代碼風(fēng)格上結(jié)合了Vue/React/Angular的優(yōu)點，同時規(guī)避他們的缺點，讓我們的開發(fā)體驗更加優(yōu)雅，減輕心智負擔(dān)。Zova已經(jīng)內(nèi)置了大量實用、有趣的功能特性，Model機制僅僅是其中一個

Zova框架已經(jīng)開源，歡迎關(guān)注，參與共建：https://github.com/cabloy/zova。

到此這篇關(guān)于在Vue3中實現(xiàn)四種全局狀態(tài)數(shù)據(jù)的統(tǒng)一管理的方法的文章就介紹到這了,更多相關(guān)Vue3全局狀態(tài)數(shù)據(jù)內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論