Files
SyncCalendar/entry/src/main/ets/common/CardDataService.ets
T

356 lines
17 KiB
Plaintext
Raw Normal View History

2026-09-13 15:50:37 +08:00
// entry/src/main/ets/common/CardDataService.ets
// 服务卡片数据:从本地库取"今天起"的日程(含 RRULE 展开),输出 JSON 给卡片渲染
import { common } from '@kit.AbilityKit';
import { formBindingData, formProvider } from '@kit.FormKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { preferences } from '@kit.ArkData';
import { CalendarDataService, DisplayEvent } from './CalendarDataService';
import { LunarUtil } from './LunarUtil';
import { LogUtil } from './LogUtil';
import { TimelineUtil, DayTimeline } from './TimelineUtil';
2026-09-13 15:50:37 +08:00
/** 卡片单条日程(按天分组:组内全天事件在前、有时间的按开始时间排序) */
export class CardItem {
title: string = '';
time: string = ''; // 开始时间 '08:30' / '全天'
endTime: string = ''; // 结束时间 '10:00'(全天事件为空)
date: string = ''; // '9月15日'
showDate: boolean = false; // 是否为当天分组的第一条(卡片上渲染日期头)
calName: string = ''; // 所属日历本名(右侧显示,颜色同日历色)
color: string = '#007DFF';
// 当前时间红线:start/end 为日程实际起止毫秒(用于定位"现在"位置);
// showNowLine 表示该日程上方应绘制红线,isNow 表示该日程正在进行中
startMs: number = 0;
endMs: number = 0;
showNowLine: boolean = false; // 红线画在该日程上方
isNow: boolean = false; // 该日程正在进行中
nowLineBelow: boolean = false; // 今天所有有时间日程已结束:红线画在最后一条下方
2026-09-13 15:50:37 +08:00
}
/** 卡片「全天/跨天」日程(**必须带 eventKey**,否则卡片侧 ForEach 的 key 会重复 → 只渲染出第一条) */
export class CardAllDay {
eventKey: string = '';
title: string = '';
color: string = '#007DFF';
isAllDay: boolean = true;
}
2026-09-13 15:50:37 +08:00
/** 卡片整体数据 */
export class CardData {
eventsJson: string = '[]';
dateText: string = '';
lunarText: string = '';
2026-09-14 09:07:47 +08:00
// 2x2 卡片强化:月-日(x月x日,年份冗余故省略)/ 星期 / 今日日程条数
dateMd: string = '';
weekday: string = '';
todayCount: number = 0;
ongoingCount: number = 0; // 此刻正在进行的日程条数(2x2 卡片红点提示用)
2026-09-14 11:09:15 +08:00
// 2x4 卡片右侧「正在进行」列表:与 eventsJson 同结构(CardItem[]),只含此刻进行中/下一个日程
ongoingJson: string = '[]';
// 4x4 / 6x4 卡片:今日 0-23 时间轴(TimelineBlock[] JSON)与当前时间纵向比例
timelineJson: string = '[]';
nowRatio: number = 0; // 当前时间在当天时间轴上的比例(0~1),卡片画红线用
nowLabel: string = ''; // 当前时间文字(如 '14:05'
allDayJson: string = '[]'; // 全天/跨天日程(CardAllDay[] JSON,卡片画在最上方)
// ===== 卡片翻页(上一天 / 下一天 / 回到今天)=====
dayOffset: number = 0; // 相对今天的天数偏移(0=今天)
isToday: boolean = true; // 当前显示的是否为今天(非今天不画红线)
dayCount: number = 0; // 当前显示日的日程条数(含全天)
2026-09-13 15:50:37 +08:00
}
export class CardDataService {
private static readonly MAX_ITEMS: number = 50;
// 已添加卡片的 formId 注册表(同进程内有效)
private static formIds: string[] = [];
// formIds 持久化(App 重启后内存注册表会清空,从 preferences 恢复,保证推送不丢卡片)
private static readonly PREF_STORE: string = 'card_form_ids';
private static readonly PREF_KEY: string = 'form_ids';
// 每张卡片的"翻页偏移"(formId → 相对今天的天数)。卡片不能滚动,靠翻页看别的日期。
// 放在这里是为了让 FormExtension(按钮翻页)与 App 内刷新共用同一份状态。
private static offsets: Map<string, number> = new Map<string, number>();
static setDayOffset(formId: string, off: number): void {
CardDataService.offsets.set(formId, off);
}
static getDayOffset(formId: string): number {
return CardDataService.offsets.get(formId) ?? 0;
}
static clearDayOffset(formId: string): void {
CardDataService.offsets.delete(formId);
}
2026-09-13 15:50:37 +08:00
/** 注册卡片:内存 + 持久化 */
static async registerForm(context: common.Context, formId: string): Promise<void> {
if (formId !== '' && !CardDataService.formIds.includes(formId)) {
CardDataService.formIds.push(formId);
}
await CardDataService.saveFormIds(context);
}
/** 注销卡片:内存 + 持久化 */
static async unregisterForm(context: common.Context, formId: string): Promise<void> {
CardDataService.formIds = CardDataService.formIds.filter((id: string): boolean => id !== formId);
await CardDataService.saveFormIds(context);
}
private static async saveFormIds(context: common.Context): Promise<void> {
try {
const store: preferences.Preferences =
await preferences.getPreferences(context, CardDataService.PREF_STORE);
await store.put(CardDataService.PREF_KEY, CardDataService.formIds.join(','));
await store.flush();
} catch (err) {
const e = err as BusinessError;
console.error(`保存 formIds 失败: ${e.message}`);
}
}
private static async loadPersistedFormIds(context: common.Context): Promise<void> {
try {
const store: preferences.Preferences =
await preferences.getPreferences(context, CardDataService.PREF_STORE);
const raw: string = await store.get(CardDataService.PREF_KEY, '') as string;
for (const id of raw.split(',')) {
if (id !== '' && !CardDataService.formIds.includes(id)) {
CardDataService.formIds.push(id);
}
}
} catch (err) {
// 读取失败则仅用内存注册表
}
}
/** App 内同步完成后调用:刷新所有已添加的卡片 */
static async pushToAllForms(context: common.Context): Promise<void> {
// 先恢复持久化的 formId(App 重启后内存注册表为空)
await CardDataService.loadPersistedFormIds(context);
if (CardDataService.formIds.length === 0) {
return;
}
// 各卡片可能翻到了不同日期 → 按偏移分组构建,避免把用户翻走的日期拽回今天
const cache: Map<number, formBindingData.FormBindingData> =
new Map<number, formBindingData.FormBindingData>();
const fallback: formBindingData.FormBindingData =
formBindingData.createFormBindingData(await CardDataService.buildCardData(context, 0));
cache.set(0, fallback);
2026-09-13 15:50:37 +08:00
const stale: string[] = [];
for (const formId of CardDataService.formIds) {
const off: number = CardDataService.getDayOffset(formId);
let binding: formBindingData.FormBindingData | undefined = cache.get(off);
if (binding === undefined) {
binding = formBindingData.createFormBindingData(
await CardDataService.buildCardData(context, off));
cache.set(off, binding);
}
2026-09-13 15:50:37 +08:00
try {
await formProvider.updateForm(formId, binding);
} catch (err) {
const e = err as BusinessError;
console.error(`卡片 ${formId} 刷新失败(移除注册): ${e.message}`);
stale.push(formId);
}
}
for (const id of stale) {
CardDataService.formIds = CardDataService.formIds.filter((x: string): boolean => x !== id);
}
if (stale.length > 0) {
await CardDataService.saveFormIds(context);
}
}
private static startOfDay(ms: number): number {
const d = new Date(ms);
return new Date(d.getFullYear(), d.getMonth(), d.getDate()).getTime();
}
/** 组装卡片数据(异步:查询本地库) */
/** 构建卡片数据。
* @param dayOffset 相对"今天"的天数偏移(卡片翻页用:负数=过去,0=今天,正数=未来)
* 非今天时不输出 nowRatio(红线不显示)。 */
static async buildCardData(context: common.Context, dayOffset: number = 0): Promise<CardData> {
2026-09-14 09:07:47 +08:00
const data = new CardData();
try {
LogUtil.init(context);
const now = new Date();
const weekCn: string[] = ['周日', '周一', '周二', '周三', '周四', '周五', '周六'];
const fullWeekCn: string[] = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
const todayStart: number = CardDataService.startOfDay(now.getTime());
const baseStart: number = todayStart + dayOffset * 86400000; // 当前卡片显示的"那一天"0 点
const base: Date = new Date(baseStart);
const prefix: string = dayOffset === 0 ? '今天 ' : (dayOffset === 1 ? '明天 ' :
(dayOffset === -1 ? '昨天 ' : ''));
data.dateText = `${prefix}${base.getMonth() + 1}月${base.getDate()}日 ${weekCn[base.getDay()]}`;
data.lunarText = LunarUtil.lunarDayText(baseStart);
data.dateMd = `${base.getMonth() + 1}月${base.getDate()}日`;
data.weekday = fullWeekCn[base.getDay()];
data.dayOffset = dayOffset;
data.isToday = dayOffset === 0;
const start: number = baseStart < todayStart ? baseStart : todayStart;
const end: number = (baseStart > todayStart ? baseStart : todayStart) + 60 * 86400000;
2026-09-13 15:50:37 +08:00
const sources = await CalendarDataService.loadSources(context);
const events: DisplayEvent[] = await CalendarDataService.loadEvents(context, start, end, sources);
// 1) 过滤:保留"今天 0 点以来"的日程(今天已结束的也显示,否则重复日程的
// 第一次发生会被隐藏,表现为"第一次不显示、第二次及以后显示");
// 2) 按天分组,组内全天在前、有时间按开始时间排序;
2026-09-13 15:50:37 +08:00
// 3) 平铺输出并给每组第一条打 showDate 标记(日期头只跟在自己日期前面)
// 跨天日程:已开始未结束的归到"今天"、按全天显示,不再从开始那天重复显示
const todayKey: number = CardDataService.startOfDay(now.getTime());
const upcoming: DisplayEvent[] = events
.filter((e: DisplayEvent): boolean => e.endTime >= todayKey);
2026-09-13 15:50:37 +08:00
const dayKey = (ms: number): number => CardDataService.startOfDay(ms);
const spansDays = (e: DisplayEvent): boolean =>
dayKey(e.endTime) > dayKey(e.startTime);
2026-09-14 11:09:15 +08:00
// 已开始的跨天日程按全天展示(不参与时间轴定位)
const isDayLong = (e: DisplayEvent): boolean => e.isAllDay || spansDays(e);
2026-09-13 15:50:37 +08:00
const groups = new Map<number, DisplayEvent[]>();
for (const e of upcoming) {
// 跨天且已开始:归今天;其余归开始日
const key: number = spansDays(e) && dayKey(e.startTime) < todayKey
? todayKey : dayKey(e.startTime);
const arr = groups.get(key);
if (arr === undefined) {
groups.set(key, [e]);
} else {
arr.push(e);
}
}
const dayKeys: number[] = Array.from(groups.keys()).sort((a: number, b: number): number => a - b);
const items: CardItem[] = [];
const p = (n: number): string => n < 10 ? '0' + n : String(n);
outer:
for (const key of dayKeys) {
// 日期头文字由分组日期生成(与列表视图一致:第一天就是"今天"),
// 不能用事件的 startTime——跨天日程归组到今天后,日期头仍是开始日会造成"从开始显示"的假象
const gd = new Date(key);
const dateLabel: string = key === todayKey
? '今天'
: `${gd.getMonth() + 1}月${gd.getDate()}日`;
2026-09-13 15:50:37 +08:00
const list = groups.get(key) as DisplayEvent[];
const allDay = list.filter((e: DisplayEvent): boolean =>
e.isAllDay || spansDays(e)); // 跨天日程按全天展示
const timed = list.filter((e: DisplayEvent): boolean =>
!e.isAllDay && !spansDays(e))
.sort((a: DisplayEvent, b: DisplayEvent): number => a.startTime - b.startTime);
const ordered: DisplayEvent[] = allDay.concat(timed);
for (let i = 0; i < ordered.length; i++) {
if (items.length >= CardDataService.MAX_ITEMS) {
break outer;
}
const e = ordered[i];
const isDayLong: boolean = e.isAllDay || spansDays(e);
const d = new Date(e.startTime);
const item = new CardItem();
item.title = e.title === '' ? '(无标题)' : e.title;
item.time = isDayLong ? '全天' : `${p(d.getHours())}:${p(d.getMinutes())}`;
if (isDayLong) {
item.endTime = '';
} else {
const de = new Date(e.endTime);
item.endTime = `${p(de.getHours())}:${p(de.getMinutes())}`;
}
item.date = dateLabel;
2026-09-13 15:50:37 +08:00
item.showDate = i === 0; // 当天分组第一条 → 卡片上显示日期头
item.calName = e.calName;
item.color = e.color;
// 红线定位:记录实际起止毫秒(用于卡片渲染时判断"现在"位置)
item.startMs = e.startTime;
item.endMs = e.endTime;
2026-09-13 15:50:37 +08:00
items.push(item);
}
}
// 红线逻辑:仅对"今天"分组、且为"有时间"的日程生效(全天/跨天按全天展示,不参与时间轴定位)
const nowMs: number = Date.now();
let linePlaced: boolean = false;
// 1) 正在进行的日程(start<=now<end)→ 红线画在其上方,并标记 isNow
for (const it of items) {
if (it.date === '今天' && it.time !== '全天' && it.startMs <= nowMs && nowMs < it.endMs) {
it.isNow = true;
it.showNowLine = true;
linePlaced = true;
break;
}
}
// 2) 否则:红线画在"下一个尚未开始"的有时间日程上方
if (!linePlaced) {
for (const it of items) {
if (it.date === '今天' && it.time !== '全天' && it.startMs > nowMs) {
it.showNowLine = true;
linePlaced = true;
break;
}
}
}
// 3) 否则:今天所有有时间日程均已结束 → 红线画在最后一条下方(标记"今日已结束")
if (!linePlaced) {
for (let k = items.length - 1; k >= 0; k--) {
const it = items[k];
if (it.date === '今天' && it.time !== '全天') {
it.nowLineBelow = true;
linePlaced = true;
break;
}
}
}
// 进行中条数:用于 2x2 卡片红点提示
data.ongoingCount = items.filter((i: CardItem): boolean => i.isNow).length;
2026-09-13 15:50:37 +08:00
data.eventsJson = JSON.stringify(items);
2026-09-14 09:07:47 +08:00
// 今日日程条数:item.date === '今天' 的均为今天分组(含全天/跨天进行中)
data.todayCount = items.filter((i: CardItem): boolean => i.date === '今天').length;
2026-09-14 11:09:15 +08:00
// ===== 2x4 卡片右侧:**当前时间之后最近的 2 条**日程 =====
// 规则:只取"还没开始"的有时间日程(startTime >= now),
// **排除全天 / 跨天**,按开始时间升序取前 2 条。
// 不再区分"进行中 / 即将开始" —— 卡片上不再显示这些字样。
const upcomingNext: DisplayEvent[] = upcoming
.filter((e: DisplayEvent): boolean => !isDayLong(e) && e.startTime >= nowMs)
2026-09-14 11:09:15 +08:00
.sort((a: DisplayEvent, b: DisplayEvent): number => a.startTime - b.startTime);
const ongoingPick: DisplayEvent[] = upcomingNext.slice(0, 2);
2026-09-14 11:09:15 +08:00
const ongoingItems: CardItem[] = [];
for (const e of ongoingPick) {
const dayLong: boolean = isDayLong(e);
const ds = new Date(e.startTime);
const de = new Date(e.endTime);
const oi = new CardItem();
oi.title = e.title === '' ? '(无标题)' : e.title;
oi.time = dayLong ? '全天' : `${p(ds.getHours())}:${p(ds.getMinutes())}`;
oi.endTime = dayLong ? '' : `${p(de.getHours())}:${p(de.getMinutes())}`;
oi.calName = e.calName;
oi.color = e.color;
oi.startMs = e.startTime;
oi.endMs = e.endTime;
oi.isNow = false;
2026-09-14 11:09:15 +08:00
ongoingItems.push(oi);
}
data.ongoingJson = JSON.stringify(ongoingItems);
// ===== 4x4 / 6x4 卡片:**当前显示日**的时间轴(色块按时间平铺,冲突分列)=====
const dayEvents: DisplayEvent[] = events.filter((e: DisplayEvent): boolean =>
e.startTime < baseStart + 86400000 && e.endTime > baseStart);
const tl: DayTimeline = TimelineUtil.build(dayEvents, baseStart);
TimelineUtil.markNow(tl.blocks, nowMs);
data.timelineJson = JSON.stringify(tl.blocks);
// 注意:不能直接 stringify(DisplayEvent) —— 它没有 eventKey 字段,
// 卡片侧 ForEach 会拿到 undefined 导致 key 重复(表现为"全天只显示一条")
const allDayItems: CardAllDay[] = [];
for (const e of tl.allDay) {
const ad = new CardAllDay();
ad.eventKey = TimelineUtil.keyOf(e);
ad.title = e.title === '' ? '(无标题)' : e.title;
ad.color = e.color;
ad.isAllDay = e.isAllDay;
allDayItems.push(ad);
}
data.allDayJson = JSON.stringify(allDayItems);
// 只有"今天"才给红线比例;翻到别的日期时给 -1(卡片侧 nowR<0 → 不画红线)
data.nowRatio = data.isToday ? TimelineUtil.nowRatio(nowMs) : -1;
data.nowLabel = TimelineUtil.nowLabel(nowMs);
data.dayCount = tl.blocks.length + tl.allDay.length;
LogUtil.write(`卡片数据刷新:${items.length} 条,今日 ${data.todayCount} 条,进行中 ${ongoingItems.length} 条,时间轴 ${tl.blocks.length} 块`);
2026-09-13 15:50:37 +08:00
} catch (err) {
LogUtil.write(`卡片数据刷新失败: ${JSON.stringify(err)}`);
}
return data;
}
}