Store

Store 模块提供了统一的状态管理能力，主要包含用户数据管理和字典数据管理两个核心功能。通过 useStore() 可以轻松访问这些数据状态。

user

用户数据状态管理，提供完整的用户认证和信息缓存功能。

API

名称	参数	返回值	说明
token	-	string | null	获取当前用户 token
setToken	data: Token	void	设置用户 token 并自动存储到本地缓存
refreshToken	-	void	刷新用户 token
info	-	UserInfoEntity	获取当前用户信息
get	-	Promise<void>	从服务器获取用户信息
set	data: UserInfoEntity	void	设置用户信息并存储到本地缓存
update	data: UserInfoEntity	Promise<void>	更新用户信息（同时调用后端接口）
clear	-	void	清除本地所有用户信息和 token
logout	-	void	退出登录，清除所有数据并跳转到登录页
isNull	-	boolean	判断用户是否已登录（基于用户 ID 字段判断）

类型定义

UserInfoEntity 类型会根据后端用户实体的类型自动生成：

interface UserInfoEntity {
  id?: number;
  unionid?: string;
  avatarUrl?: string;
  nickName?: string;
  phone?: string;
  gender?: number;
  status?: number;
  loginType?: number;
  password?: string;
  description?: string;
  birthday?: string;
  province?: string;
  city?: string;
  district?: string;
  createTime?: string;
  updateTime?: string;
}

interface Token {
  token: string; // 访问令牌
  expire: number; // token 过期时间戳
  refreshToken: string; // 刷新令牌
  refreshExpire: number; // 刷新令牌过期时间戳
}

使用示例

显示用户信息

在模板中绑定用户数据：

<template>
  <cl-text>{{ user.info?.nickName ?? "未登录" }}</cl-text>
</template>

<script lang="ts" setup>
import { useStore } from "@/cool";

const { user } = useStore();
</script>

登录状态检查

import { useStore } from "@/cool";

const { user } = useStore();

// 检查用户是否已登录
if (user.isNull()) {
  console.log("用户未登录，请先登录");
  // 跳转到登录页
  uni.navigateTo({ url: "/pages/user/login" });
} else {
  console.log("当前用户：", user.info?.nickName);
}

更新用户信息

更新用户信息时会同步调用后端接口：

import { useStore } from "@/cool";

const { user } = useStore();

// 更新用户昵称
await user.update({
  nickName: "新昵称",
});

console.log("用户信息更新成功");

Token 管理

import { useStore } from "@/cool";

const { user } = useStore();

// 设置登录 token
user.setToken({
  token: "access_token_here",
  expire: Date.now() + 7200000, // 2小时后过期
  refreshToken: "refresh_token_here",
  refreshExpire: Date.now() + 2592000000, // 30天后过期
});

// 退出登录
user.logout();

dict

字典数据状态管理，提供系统字典数据的缓存和访问功能。

API

名称	参数	返回值	说明
data	-	DictData[]	获取所有字典数据
find	key: string	DictData	根据 key 查找对应的字典数据
get	key: DictKey	DictItem[]	获取指定类型的字典项列表
getItem	key: DictKey, value: any	DictItem | null	根据 key 和 value 获取对应的字典项
getItems	key: DictKey, values: any[]	DictItem[]	根据 key 和多个 value 批量获取字典项
getItemLabel	key: DictKey, value: any	string	根据 key 和 value 获取对应字典项的显示标签
refresh	types?: DictKey[] | null	Promise<void>	刷新字典数据（可指定特定类型）

类型定义

interface DictItem {
  id: number; // 字典项唯一标识
  typeId: number; // 所属字典类型 ID
  label: string; // 显示标签
  name: string; // 字典项名称
  value: any; // 字典项值
  orderNum: number; // 排序序号
  parentId?: number | null; // 父级 ID（用于树形结构）
}

interface DictData {
  key: string; // 字典类型 key
  list: DictItem[]; // 该类型下的字典项列表
}

DictKey 类型会根据后端配置的字典类型自动生成：

type DictKey =
  | "brand" // 品牌类型
  | "occupation" // 职业类型
  | "upgradeType" // 升级类型
  | "complainType" // 投诉类型
  | "feedbackType"; // 反馈类型

使用示例

获取字典列表

import { useStore } from "@/cool";

const { dict } = useStore();

// 获取品牌字典列表
const brandList = dict.get("brand");
console.log(brandList);

/* 输出示例：
[
  {
    id: 1,
    label: "COOL",
    value: 1,
    orderNum: 1
  },
  {
    id: 2,
    label: "闪酷",
    value: 2,
    orderNum: 2
  }
]
*/

获取字典项标签

import { useStore } from "@/cool";

const { dict } = useStore();

// 根据值获取对应的显示标签
const brandLabel = dict.getItemLabel("brand", 1);
console.log(brandLabel); // 输出: "COOL"

刷新字典数据

import { onShow } from "@dcloudio/uni-app";
import { useStore } from "@/cool";

const { dict } = useStore();

// 页面显示时刷新特定字典
onShow(async () => {
  await dict.refresh(["userTag", "userStatus"]);
  console.log("字典数据已更新");
});

// 刷新所有字典数据
await dict.refresh();

注意事项

字典数据同步

• 应用启动时会自动调用 dict.refresh() 获取所有字典数据
• 如果后台管理员修改了字典配置，建议在相关页面手动刷新对应的字典数据
• 字典数据会缓存在本地，避免频繁请求服务器

性能优化建议

• 使用 getItemLabel() 获取单个标签时性能最佳
• 批量获取多个字典项时使用 getItems() 方法
• 合理使用 refresh() 方法，避免不必要的网络请求