HarmonyOS_ArkTs_API(4)

HarmonyOS_ArkTs_API(4)

概述

梦想管理系统是梦想生活规划师应用的核心组件，帮助用户创建、跟踪和实现他们的人生目标。这个复杂的模块处理梦想条目的完整生命周期，从创建和分类到进度跟踪和完成。基于鸿蒙HarmonyOS ArkTS构建，系统提供了一个无缝且直观的界面，让用户将愿望转化为可行的计划。

核心功能

1. 梦想创建与编辑：全面的界面用于添加和修改梦想详情
2. 分类系统：灵活的标签和分类系统
3. 进度追踪：完成状态的视觉指示器
4. 优先级管理：设置和调整梦想优先级的工具
5. 截止日期处理：基于日期的目标设定与提醒
6. 图像关联：附加视觉图像到梦想的能力
7. 隐私控制：将梦想设置为公开或私密的选项

实现

数据模型

梦想实体定义了一套全面的属性：

export interface Dream {
  id: number;
  userId: number;
  title: string;
  description: string;
  category: string;
  priority: number;
  status: number;
  completionRate: number;
  deadline: string;
  createdAt: string;
  updatedAt: string;
  expectedDays: number;
  imageUrl: string;
  isPublic: number;
  tags?: string[];
  tasks?: Task[];
}

API集成

梦想管理功能利用多种API方法与后端交互：

export function createDream(dream: Dream): Promise<Dream> {
  console.info(`开始创建梦想: ${dream.title}`);
  try {
    // 转换为请求数据格式
    const requestData: RequestData = {
      userId: dream.userId,
      title: dream.title,
      description: dream.description,
      category: dream.category,
      priority: dream.priority,
      status: dream.status,
      completionRate: dream.completionRate,
      deadline: dream.deadline,
      imageUrl: dream.imageUrl,
      isPublic: dream.isPublic,
      expectedDays: dream.expectedDays,
      tags: dream.tags || []
    };
    
    return request<Dream>(RequestMethod.POST, `/dreams`, EmptyParams, requestData)
      .then(newDream => {
        // 处理图片URL以在正确的环境中显示
        if (newDream && newDream.imageUrl) {
          newDream.imageUrl = processImageUrl(newDream.imageUrl);
        }
        return newDream;
      });
  } catch (error) {
    // 处理错误，特别关注标签处理问题
    // ...
  }
}

梦想检索与过滤

系统支持基于用户需求的各种梦想检索方法：

// 通过用户ID获取梦想
export function getDreamsByUserId(userId: number): Promise<Dream[]> {
  return request<Dream[]>(RequestMethod.GET, `dreams/user/${userId}`, EmptyParams);
}

// 通过状态获取梦想
export function getDreamsByStatus(userId: number, status: number): Promise<ApiResponse<Dream[]>> {
  return request<ApiResponse<Dream[]>>(RequestMethod.GET, `/dreams/user/${userId}/status/${status}`);
}

// 通过分类获取梦想
export function getDreamsByUserIdAndCategory(userId: number, category: string): Promise<Dream[]> {
  try {
    return request<Dream[]>(RequestMethod.GET, `/dreams/user/${userId}/category/${category}`);
  } catch (error) {
    console.error(`获取用户${category}分类梦想列表失败: ${error instanceof Error ? error.message : String(error)}`);
    throw new Error(`获取用户${category}分类梦想列表失败: ${error instanceof Error ? error.message : String(error)}`);
  }
}

梦想搜索功能

应用程序包含强大的梦想搜索功能：

export function searchDreams(userId: number, keyword: string): Promise<PageResponse<Dream>> {
  try {
    const params: RequestData = { userId, keyword };
    return request<PageResponse<Dream>>(RequestMethod.GET, `/dreams/search`, params as QueryParams);
  } catch (error) {
    console.error(`梦想搜索失败: ${error instanceof Error ? error.message : String(error)}`);
    throw new Error(`梦想搜索失败: ${error instanceof Error ? error.message : String(error)}`);
  }
}

UI组件

梦想管理UI利用了几个专业化组件：

1. DreamListComponent：以网格或列表格式显示梦想，提供排序选项
2. DreamCardComponent：单个梦想的视觉表示，带有进度指标
3. DreamEditForm：用于添加和编辑梦想详情的全面表单
4. DreamDetailView：展示所有梦想信息和相关任务的扩展视图
5. DreamProgressTracker：显示完成百分比和时间线的视觉组件

高级功能

统计与分析

系统包含对梦想进度的统计分析：

export function getDreamStats(userId: number): Promise<DreamStats> {
  try {
    // 从后端API获取数据，API返回ApiResponse格式
    return request<ApiResponse<DreamStats>>(RequestMethod.GET, `/dreams/user/${userId}/stats`)
      .then(response => {
        // 处理ApiResponse，提取data字段并返回
        if (response && response.data) {
          console.info(`成功获取梦想统计: ${JSON.stringify(response.data)}`);
          return response.data;
        }
        // 如果响应没有data字段，抛出错误
        throw new Error('获取梦想统计数据失败: 响应格式错误');
      });
  } catch (error) {
    console.error(`获取梦想统计数据失败: ${error instanceof Error ? error.message : String(error)}`);
    throw new Error(`获取梦想统计数据失败: ${error instanceof Error ? error.message : String(error)}`);
  }
}

梦想管理系统是目标跟踪和实现的综合解决方案，通过结构化且直观的界面为用户提供强大的工具，帮助他们记录、组织和实现自己的梦想。