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

@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.

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

@Ivy233
Ivy233 force-pushed the fix/notification-expire-after-display branch 2 times, most recently from 0b0eb8c to 2ae625f Compare August 7, 2026 06:21
@Ivy233
Ivy233 requested a review from 18202781743 August 7, 2026 06:25
@Ivy233
Ivy233 force-pushed the fix/notification-expire-after-display branch from 2ae625f to 5ef467e Compare August 7, 2026 08:07

Q_EMIT NotificationStateChanged(entity.id(), entity.processedType());

bool critical = false;

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.

这个逻辑去掉了,那定时器没拿这个参数?


bool contains(qint64 key) const;
// Milliseconds left for key, or 0 when it is not tracked.
int remaining(qint64 key) const;

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.

按操作来定义接口吧,不用搞这么通用的,然后让调用者去组合,
这里只有start,stop,clear吧,resume类似传递需要停止的entity,逻辑在内部封装,

* that key. All bookkeeping lives in hash maps, so no QTimer is allocated per
* key and nothing leaks when a key expires or is stopped.
*/
class ExpireTimer : public QObject

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.

暂存区和通知横幅的是不是共用同一个定时器管理的呀,不然这里会不会一个通知有两个定时器在弄呀,

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 an ExpireTimer helper that manages each tracked key's deadline,
   paused remaining time and caller data (such as the bubble id) with a
   single shared single-shot QTimer. It exposes operation-based APIs
   (start/pause/resume/stop/clear) instead of lower-level get/set ones, so
   no QTimer is allocated per notification and nothing leaks on expiry.
2. BubbleModel starts a per-bubble expire timer when a bubble is shown
   (insert/replace) using the client expireTimeout (0: never expire, -1:
   5000ms default, Critical urgency: never expire). On expiry it emits
   bubbleExpired(id, bubbleId).
3. BubblePanel closes the expired bubble and calls
   notificationClosed(id, bubbleId, Expired) on the server.
4. Move the hover block to the frontend: BubbleModel::setBlockedId
   pauses/resumes the expire timer so hovering keeps the bubble on screen,
   keeping the 1s grace after unhover.
5. Give the notification center staging model its own expire timer:
   notifications shown in the staging area also time out, because the
   bubble panel is disabled while the center window is open so the
   bubble-side timers are not running.
6. Make NotificationManager::notificationClosed idempotent. A notification
   is tracked by both the bubble and the staging expire timers, so the
   close is reported only while the entity still exists, preventing a
   notification from being closed twice.
7. Critical notifications never expire on their own, enforced both when
   computing the frontend timeout and on the server.
8. Remove the server-side timeout bookkeeping: notificationDisplayed,
   setBlockClosedId, pushPendingEntity, onHandingPendingEntities,
   removePendingEntity and the pending-timeout QTimer.
9. Expose BubbleItem::timeout() and NotifyEntity::timeout()/urgency() for
   the frontend timeout computation.
10. 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 an expired notification is closed only once and moved to the
   notification center, and the DBus NotificationClosed(Expired) signal is
   emitted once.
5. Open the notification center and verify staged notifications expire
   after their timeout and leave the staging area.
6. Run the notification server unit tests.

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

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

1. 新增 ExpireTimer 工具类:用一个共享的单次 QTimer 管理每个键的过期
   时间、暂停剩余时间及调用方数据(如气泡 ID)。提供 start/pause/resume/
   stop/clear 操作化接口,而非 contains/remaining 这类底层读写操作,不再
   为每个通知分配 QTimer,到期后也不会泄漏对象。
2. BubbleModel 在气泡显示(插入/替换)时根据客户端 expireTimeout 启动
   过期计时(0:永不过期,-1:默认 5000ms,Critical 优先级:永不过期),
   到期时发出 bubbleExpired(id, bubbleId)。
3. 到期后 BubblePanel 关闭气泡并调用服务器 notificationClosed(id,
   bubbleId, Expired)。
4. 将悬停阻塞移到前端:BubbleModel::setBlockedId 暂停/恢复过期计时,使
   悬停时气泡不关闭,并保留取消悬停后 1s 缓冲。
5. 为通知中心暂存模型增加过期计时:暂存区展示的通知同样会超时,因为
   中心窗口打开时气泡面板被禁用,气泡侧的计时器不会运行。
6. 使 NotificationManager::notificationClosed 幂等:同一通知会被气泡与
   暂存模型的过期计时同时跟踪,因此在实体仍存在时才上报关闭,避免通知
   被关闭两次。
7. Critical 通知永不自动过期,前端超时计算与服务端均强制执行。
8. 移除服务端超时簿记:notificationDisplayed、setBlockClosedId、
   pushPendingEntity、onHandingPendingEntities、removePendingEntity 以及
   pending-timeout 定时器。
9. 为前端超时计算暴露 BubbleItem::timeout() 与 NotifyEntity::timeout()/
   urgency()。
10. 移除过时的 NotificationDisplayed/SetBlockClosedId 测试。

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

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

PMS: BUG-372279
@Ivy233
Ivy233 force-pushed the fix/notification-expire-after-display branch from 5ef467e to aa5a30c Compare August 10, 2026 03:27
@deepin-ci-robot

Copy link
Copy Markdown

deepin pr auto review

★ 总体评分:100分

■ 【总体评价】

代码通过引入ExpireTimer类成功将过期逻辑下沉至前端,彻底解决了后端竞态条件与复杂度问题
逻辑严密、设计优秀、性能高效且无任何安全漏洞,属于高质量重构代码

■ 【详细分析】

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

ExpireTimer类通过单一QTimer和三个QHash精准管理生命周期,pause/resume逻辑正确处理了剩余时间的计算与最小剩余时间限制;BubbleModel::setBlockedId准确处理了新旧阻塞ID的切换与定时器状态同步;NotificationManager::notificationClosed中新增的isValid与Critical级别防御性检查完美避免了重复信号与误关问题
建议:无

  • 2.代码质量(优秀)✓

彻底移除了NotificationManager中极易产生竞态的QMultiHash及复杂的onHandingPendingEntities函数,将职责清晰拆分至UI层;effectiveTimeout函数抽取至公共模块消除了魔法数字与重复代码;ExpireTimer类注释详尽,接口语义明确,完全符合单一职责原则与Qt编码规范
建议:无

  • 3.代码性能(高效)✓

使用单一QTimer替代了原先可能存在的多定时器或复杂的后端轮询机制,schedule方法通过std::min_element在O(N)内找到最近到期时间;在桌面通知场景下N极小(通常小于20),此开销可忽略不计,且避免了跨线程的QMetaObject::invokeMethod调用,整体性能表现优异
建议:无

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

漏洞对比统计:新增漏洞 0 个,减少漏洞 0 个,持平 0 个
代码逻辑严谨,新增的防御性检查有效阻止了非法状态下的数据越界或重复处理,无命令注入、缓冲区溢出或信息泄露等安全风险
建议:无

■ 【改进建议代码示例】

// 虽然当前代码无安全漏洞,但为了提升跨线程调用的绝对安全性,
// 建议将 BubblePanel 中的 Qt::DirectConnection 替换为 Qt::AutoConnection,
// 让 Qt 自行判断线程归属,防止未来架构调整时引发线程安全问题。
// 文件:panels/notification/bubble/bubblepanel.cpp

// 修改前:
connect(m_bubbles, &BubbleModel::bubbleExpired, this, [this](qint64 id, uint bubbleId) {
    closeBubble(id);
    QMetaObject::invokeMethod(m_notificationServer, "notificationClosed", Qt::DirectConnection,
                              Q_ARG(qint64, id), Q_ARG(uint, bubbleId), Q_ARG(uint, NotifyEntity::Expired));
});

// 修改后:
connect(m_bubbles, &BubbleModel::bubbleExpired, this, [this](qint64 id, uint bubbleId) {
    closeBubble(id);
    QMetaObject::invokeMethod(m_notificationServer, "notificationClosed", Qt::AutoConnection,
                              Q_ARG(qint64, id), Q_ARG(uint, bubbleId), Q_ARG(uint, NotifyEntity::Expired));
});

@Ivy233
Ivy233 requested a review from 18202781743 August 10, 2026 05:11
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