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

292 lines
14 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';
/** 卡片单条日程(按天分组:组内全天事件在前、有时间的按开始时间排序) */
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
}
/** 卡片整体数据 */
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 = '[]';
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';
/** 注册卡片:内存 + 持久化 */
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 data: CardData = await CardDataService.buildCardData(context);
const binding: formBindingData.FormBindingData =
formBindingData.createFormBindingData(data);
const stale: string[] = [];
for (const formId of CardDataService.formIds) {
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();
}
/** 组装卡片数据(异步:查询本地库) */
static async buildCardData(context: common.Context): 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[] = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
data.dateText = `${now.getMonth() + 1}月${now.getDate()}日 ${weekCn[now.getDay()]}`;
data.lunarText = LunarUtil.lunarDayText(now.getTime());
// 2x2 卡片强化字段:月-日(x月x日,年份冗余省略)、星期全名、今日日程条数
data.dateMd = `${now.getMonth() + 1}月${now.getDate()}日`;
data.weekday = fullWeekCn[now.getDay()];
2026-09-13 15:50:37 +08:00
const start: number = CardDataService.startOfDay(now.getTime());
const end: number = start + 60 * 86400000;
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 卡片右侧:正在进行 / 下一个 日程(最多 3 条,作为 2x2 的右侧扩展)=====
// 规则:① 进行中或已开始未结束的(含全天/跨天,按 0 点起算)优先,最多 2 条;
// ② 不足时用"今天还没开始的下一个有时间日程"补 1 条。全部按开始时间升序。
const floorMs = Math.max(nowMs, todayKey);
const ongoingAll: DisplayEvent[] = upcoming
.filter((e: DisplayEvent): boolean => e.startTime <= nowMs && e.endTime > floorMs)
.sort((a: DisplayEvent, b: DisplayEvent): number => a.startTime - b.startTime);
let ongoingPick: DisplayEvent[] = ongoingAll.slice(0, 2);
if (ongoingPick.length < 2) {
const next: DisplayEvent | undefined = upcoming
.filter((e: DisplayEvent): boolean => !isDayLong(e) && e.startTime > nowMs)
.sort((a: DisplayEvent, b: DisplayEvent): number => a.startTime - b.startTime)[0];
if (next !== undefined) {
ongoingPick = ongoingPick.concat([next]);
}
}
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 = e.startTime <= nowMs && e.endTime > nowMs;
ongoingItems.push(oi);
}
data.ongoingJson = JSON.stringify(ongoingItems);
LogUtil.write(`卡片数据刷新:${items.length} 条,今日 ${data.todayCount} 条,进行中 ${ongoingItems.length} 条`);
2026-09-13 15:50:37 +08:00
} catch (err) {
LogUtil.write(`卡片数据刷新失败: ${JSON.stringify(err)}`);
}
return data;
}
}