Skip to content

fix: start notification expire timer only after bubble is displayed - #1691

Open
Ivy233 wants to merge 1 commit into
linuxdeepin:masterfrom
Ivy233:fix/notification-expire-after-display
Open

fix: start notification expire timer only after bubble is displayed#1691
Ivy233 wants to merge 1 commit into
linuxdeepin:masterfrom
Ivy233:fix/notification-expire-after-display

Conversation

@Ivy233

@Ivy233 Ivy233 commented Aug 6, 2026

Copy link
Copy Markdown
Contributor
  1. Remove the immediate pushPendingEntity call from Notify(), so the expire timer no longer starts as soon as a notification is received
  2. Add a bubbleDisplayed signal to BubbleModel, emitted when a bubble is actually inserted into the display model
  3. Connect bubbleDisplayed in BubblePanel and forward it to the notification server through notificationDisplayed
  4. Add a timeout() accessor to NotifyEntity to read the client provided expire timeout
  5. Implement NotificationManager::notificationDisplayed to schedule the timeout only when the bubble is shown, avoiding premature expiry while notifications are still queued
  6. Forward notificationDisplayed via Qt::QueuedConnection in NotifyServerApplet so the pending timeout timer is started in the worker thread it belongs to
  7. Add unit tests for notificationDisplayed

Log: Defer the notification expire timer until the bubble is actually displayed on screen

Influence:

  1. Verify a notification disappears after the default 5 seconds when displayed normally
  2. Verify a notification no longer expires before it is shown when many notifications are queued
  3. Verify hovering over a bubble prevents it from expiring
  4. Run the notification server unit tests

fix: 通知气泡显示后才启动过期计时

  1. 移除 Notify() 中立即调用 pushPendingEntity 的逻辑,通知收到后不再 马上启动过期计时
  2. BubbleModel 中新增 bubbleDisplayed 信号,在气泡实际插入显示模型 时发出
  3. BubblePanel 中连接 bubbleDisplayed,通过 notificationDisplayed 转发给通知服务端
  4. NotifyEntity 新增 timeout() 访问器,用于读取客户端传入的过期时间
  5. 实现 NotificationManager::notificationDisplayed,仅在气泡显示时才调度 超时,避免通知在排队期间提前过期
  6. NotifyServerApplet 中通过 Qt::QueuedConnection 转发 notificationDisplayed,确保过期定时器在其所属的 worker 线程中启动
  7. notificationDisplayed 补充单元测试

Log: 将通知过期计时推迟到气泡真正显示之后

Influence:

  1. 验证正常显示的通知在默认 5 秒后消失
  2. 验证大量通知排队时,通知不会在显示前提前过期
  3. 验证鼠标悬停气泡时通知不会过期消失
  4. 运行通知服务端单元测试

PMS: BUG-372279

Summary by Sourcery

Defer starting notification expiry timers until bubbles are actually displayed on screen.

New Features:

  • Emit a BubbleModel::bubbleDisplayed signal when a notification bubble is inserted or replaced in the display model.
  • Expose NotifyEntity::timeout() to retrieve the client-provided expiry timeout.
  • Add a NotifyServerApplet::notificationDisplayed slot and forward display events to NotificationManager via queued invocation.

Bug Fixes:

  • Prevent notifications from expiring while still queued by scheduling expiry only after the bubble is shown.
  • Ensure notification expiry timers run in the correct worker thread so they fire reliably.

Enhancements:

  • Introduce NotificationManager::notificationDisplayed to start pending expiry timers based on actual display events instead of receipt time.

Tests:

  • Add unit tests covering NotifyServerApplet::notificationDisplayed, including edge-case IDs.

@deepin-ci-robot

Copy link
Copy Markdown

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

@deepin-ci-robot

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: Ivy233

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@sourcery-ai

sourcery-ai Bot commented Aug 6, 2026

Copy link
Copy Markdown

Reviewer's Guide

This PR defers starting the notification expiration timer until a bubble is actually inserted into the UI model, wiring a new bubbleDisplayed signal through BubblePanel to NotificationManager, which now schedules timeouts based on the stored client expire timeout only when notifications are displayed, with thread-safe forwarding from the applet and added unit tests.

Sequence diagram for deferred notification timeout start when bubble is displayed

sequenceDiagram
    participant BubbleModel
    participant BubblePanel
    participant NotifyServerApplet
    participant NotificationManager

    BubbleModel->>BubbleModel: insertBubble / replaceBubble
    BubbleModel-->>BubblePanel: bubbleDisplayed(id)
    BubblePanel->>NotifyServerApplet: notificationDisplayed(id)
    NotifyServerApplet->>NotificationManager: notificationDisplayed(id)
    NotificationManager->>NotificationManager: fetchEntity(id)
    NotificationManager->>NotificationManager: pushPendingEntity(entity, entity.timeout())
Loading

File-Level Changes

Change Details Files
Start notification expiration only when the bubble is displayed instead of on receipt.
  • Removed immediate scheduling of pending notification timeouts in Notify() based on hints expireTimeout.
  • Added a notificationDisplayed(qint64) slot in NotificationManager that fetches the entity, checks validity/urgency, reads its timeout(), and calls pushPendingEntity only for non-critical, expiring notifications.
  • Introduced a timeout() accessor on NotifyEntity to expose the stored expire timeout instead of passing it around separately.
panels/notification/server/notificationmanager.cpp
panels/notification/server/notificationmanager.h
panels/notification/common/notifyentity.cpp
panels/notification/common/notifyentity.h
Signal when a bubble is actually shown and propagate that to the notification server with correct threading semantics.
  • Added a bubbleDisplayed(qint64) signal to BubbleModel and emit it when inserting or replacing bubbles in the model.
  • Connected BubbleModel::bubbleDisplayed in BubblePanel to forward the ID to the notification server via notificationDisplayed using a direct connection.
  • Implemented NotifyServerApplet::notificationDisplayed to forward the call into NotificationManager::notificationDisplayed using Qt::QueuedConnection so the timeout QTimer starts on the worker thread.
panels/notification/bubble/bubblemodel.h
panels/notification/bubble/bubblemodel.cpp
panels/notification/bubble/bubblepanel.cpp
panels/notification/server/notifyserverapplet.h
panels/notification/server/notifyserverapplet.cpp
Add unit coverage for the new notificationDisplayed path to ensure robustness for various IDs.
  • Added a basic NotifyServerApplet test that calls notificationDisplayed with a valid ID to ensure no crashes.
  • Added edge-case tests that call notificationDisplayed with 0, -1, and max qint64, verifying the applet handles these IDs without throwing.
tests/panels/notification/server/notifyserverapplet_test.cpp

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@Ivy233
Ivy233 marked this pull request as ready for review August 6, 2026 06:59

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry @Ivy233, you have reached your weekly rate limit of 500000 diff characters.

Please try again later or upgrade to continue using Sourcery

@deepin-ci-robot

Copy link
Copy Markdown

deepin pr auto review

★ 总体评分:95分

■ 【总体评价】

代码完美解决了通知排队期间提前过期的核心BUG,跨线程定时器启动逻辑设计精准
逻辑严密且符合Qt多线程规范,仅单元测试深度不足扣5分

■ 【详细分析】

  • 1.语法逻辑(完全正确)✓

修复方案在四层调用链中的逻辑传递准确无误。在BubblePanel中使用DirectConnection同步调用同处于主线程的NotifyServerApplet,随后在NotifyServerApplet中使用QueuedConnection将调用跨线程安全地抛给工作线程中的NotificationManager,彻底避免了从主线程直接启动工作线程QTimer导致的定时器不触发问题。在NotificationManager::notificationDisplayed中通过fetchEntity重新获取实体并校验processedType状态,防止了对已处理通知的误操作。
建议:无需修改

  • 2.代码质量(良好)✓

代码命名规范符合Qt风格,关键跨线程操作处配有清晰的注释说明原因。新增的timeout() getter方法职责单一。唯一不足在于新增的单元测试仅覆盖了不崩溃的边界值测试,未对核心的定时器启动逻辑和状态拦截逻辑进行Mock验证。
潜在问题:测试用例仅使用EXPECT_NO_THROW验证不崩溃,无法确认fetchEntity返回无效实体或已处理实体时是否正确阻断了pushPendingEntity的调用
建议:引入Mock对象替换m_persistence,验证在不同processedType和urgency状态下pushPendingEntity被调用的次数

  • 3.代码性能(无性能问题)✓

相比原逻辑,新方案在notificationDisplayed中增加了一次m_persistence->fetchEntity的持久化查询。由于通知显示属于低频用户交互行为,且fetchEntity通常基于内存索引或轻量级本地数据库查询,该开销完全在可接受范围内,不会引起性能瓶颈。
建议:无需修改

  • 4.代码安全(存在0个安全漏洞)✓

漏洞对比统计:新增漏洞 0 个,减少漏洞 0 个,持平 0 个
代码未引入命令注入、内存越界等安全风险,新增的timeout()方法安全返回int型且调用处有0值保护,跨线程信号槽参数传递基础类型 qint64,无敏感信息泄露风险。
建议:无需修改

■ 【改进建议代码示例】

// tests/panels/notification/server/notifyserverapplet_test.cpp
// 建议增加对核心逻辑的Mock测试,验证超时启动的拦截条件
TEST_F(NotifyServerAppletTest, NotificationDisplayedLogicTest) {
    applet->init();
    
    // 假设已通过依赖注入将 m_persistence 替换为 MockPersistence
    MockPersistence *mockPersistence = static_cast<MockPersistence*>(applet->getManager()->persistence());
    MockNotificationManager *mockManager = static_cast<MockNotificationManager*>(applet->getManager());
    
    NotifyEntity validEntity;
    validEntity.setProcessedType(NotifyEntity::NotProcessed);
    validEntity.setTimeout(5000); // 非0且非Critical
    validEntity.setHints(QVariantMap());
    
    // 场景1:正常未处理通知,应触发 pushPendingEntity
    mockPersistence->setMockEntity(validEntity);
    EXPECT_CALL(*mockManager, pushPendingEntity(testing::_, 5000)).Times(1);
    applet->notificationDisplayed(validEntity.id());

    // 场景2:已处理的通知,不应触发 pushPendingEntity
    validEntity.setProcessedType(NotifyEntity::Processed);
    mockPersistence->setMockEntity(validEntity);
    EXPECT_CALL(*mockManager, pushPendingEntity(testing::_, testing::_)).Times(0);
    applet->notificationDisplayed(validEntity.id());

    // 场景3:Critical紧急通知,不应触发 pushPendingEntity
    validEntity.setProcessedType(NotifyEntity::NotProcessed);
    validEntity.setHints(QVariantMap{{"urgency", QVariant::fromValue<uint>(NotifyEntity::Critical)}});
    mockPersistence->setMockEntity(validEntity);
    EXPECT_CALL(*mockManager, pushPendingEntity(testing::_, testing::_)).Times(0);
    applet->notificationDisplayed(validEntity.id());
}

The notification expire timer previously ran in the notification server
(worker thread) and was started when the notification was received, so a
notification waiting in a long display queue could expire before its
bubble was shown. The timeout is now owned by the bubble frontend and
only starts once the bubble is actually displayed.

1. Add a per-bubble single-shot QTimer in BubbleModel that starts when a
bubble is shown (insert/replace) using the client expireTimeout (0: never
expire, -1: 5000ms default, Critical urgency: never expire).
2. On expiry the frontend closes the bubble and calls
notificationClosed(id, bubbleId, Expired) on the server, which moves the
notification from the in-memory store to the center database and emits
NotificationStateChanged(Processed) and the DBus NotificationClosed
signal.
3. Move the hover block to the frontend: setBlockedId pauses/resumes the
per-bubble timer so hovering keeps the bubble on screen, keeping the 1s
grace after unhover and the replaced-bubble blocking behavior.
4. Remove the server-side timeout bookkeeping: notificationDisplayed,
setBlockClosedId, pushPendingEntity, onHandingPendingEntities,
removePendingEntity and the pending-timeout QTimer.
5. Expose BubbleItem::timeout() and NotifyEntity::timeout() for the
frontend timeout computation.
6. Remove the obsolete NotificationDisplayed/SetBlockClosedId tests.

Log: Fixed notifications expiring before their bubble was displayed.

Influence:
1. Send several notifications at once and verify each bubble stays for
the full expire timeout.
2. Verify critical notifications and expireTimeout 0 never close.
3. Hover a bubble and verify it does not expire, then closes 1s after
unhover.
4. Verify expired bubbles are moved to the notification center and the
DBus NotificationClosed(Expired) signal is emitted.
5. Run the notification server unit tests.

fix: 将通知过期计时迁移到气泡前端

通知过期计时此前在通知服务器(工作线程)中运行,收到通知时即启动,导致
长显示队列中的通知可能在显示前就已过期。现将超时逻辑交由气泡前端持有,
气泡真正显示后才开始计时。

1. 在 BubbleModel 中为每个气泡增加单次 QTimer,气泡显示(插入/替换)时
根据客户端 expireTimeout 启动(0:永不过期,-1:默认 5000ms,Critical
优先级:永不过期)。
2. 到期后前端关闭气泡并调用服务器 notificationClosed(id, bubbleId,
Expired),将通知从内存存储迁移到通知中心数据库,并发送
NotificationStateChanged(Processed) 与 DBus NotificationClosed 信号。
3. 将悬停阻塞移到前端:setBlockedId 暂停/恢复对应气泡定时器,使悬停时
气泡不关闭,并保留取消悬停后 1s 缓冲及替换气泡继续阻塞的行为。
4. 移除服务端超时簿记:notificationDisplayed、setBlockClosedId、
pushPendingEntity、onHandingPendingEntities、removePendingEntity 以及
pending-timeout 定时器。
5. 为前端超时计算暴露 BubbleItem::timeout() 与 NotifyEntity::timeout()。
6. 移除过时的 NotificationDisplayed/SetBlockClosedId 测试。

Log: 修复通知在气泡显示前就过期的问题。

Influence:
1. 一次性发送多条通知,验证每个气泡都能保持完整的过期时间。
2. 验证 Critical 通知与 expireTimeout 为 0 的通知永不过期。
3. 悬停气泡验证其不关闭,取消悬停 1s 后关闭。
4. 验证过期气泡进入通知中心,并发出 DBus NotificationClosed(Expired)。
5. 运行通知服务器单元测试。

PMS: BUG-372279
@Ivy233
Ivy233 force-pushed the fix/notification-expire-after-display branch from 430dd63 to fcf70d8 Compare August 6, 2026 11:52
if (interval <= 0)
return;

auto *timer = new QTimer(this);

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这样每个通知都new 个超时的timer?

timer->setSingleShot(true);
timer->setInterval(interval);
connect(timer, &QTimer::timeout, this, [this, id, bubbleId = bubble->bubbleId()] {
m_timeoutTimers.remove(id);

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

timer没delete?

}
}

void BubbleModel::setBlockedId(qint64 id)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这样的话,进入了暂存区域的通知没有超时的机制了,

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants