ABP文档笔记 - 通知
基础概念
两种通知发送方式
- 直接发送给目标用户
- 用户订阅某类通知,发送这类通知时直接分发给它们。
两种通知类型
- 一般通知:任意的通知类型
“如果一个用户发送一个好友请求,那么通知我”就是一个此类型的通知 - 实体通知:与一个特定的实体关联,
“如果一个用户给这张(photo)图片发了评论,那么通知我”就是一个基于实体的通知,因为它与一个特定的photo实体关联,用户可能想为某些图片发出通知,而不是所有图片
通知数据
一个通知通常包含一个通知数据,但有些通知也可能不需要数据
例如:“如果一个用户发送一个好友请求,那么通知我”该通知可能有两个数据属性:发送者名字(谁发送了这个好友请求)和备注(发送者写在请求里的信息),很明显,通知数据类型与通知类型是紧密联系的,不同的通知类型有不同的数据类型。
ABP已经提供足以满足大部分情况的预定义通知数据类型,简单的信息可以用MessageNotificationData,本地化和可参数化的通知信息可以使用LocalizableMessageNotificationData。
通知重要性级别
通知重要性有5个级别,定义在NotificationSeverity枚举里:Info,Success,Warn,Error和Fatal,默认为Info。
示例
订阅通知
INotificationSubscriptionManager提供了用来订阅通知的API,例如:
public class MyService : ITransientDependency
{private readonly INotificationSubscriptionManager _notificationSubscriptionManager;public MyService(INotificationSubscriptionManager notificationSubscriptionManager){_notificationSubscriptionManager = notificationSubscriptionManager;}//订阅一个一般通知public async Task Subscribe_SentFrendshipRequest(int? tenantId, long userId){await _notificationSubscriptionManager.SubscribeAsync(new UserIdentifier(tenantId, userId), "SentFrendshipRequest"); }//订阅一个实体通知public async Task Subscribe_CommentPhoto(int? tenantId, long userId, Guid photoId){await _notificationSubscriptionManager.SubscribeAsync(new UserIdentifier(tenantId, userId), "CommentPhoto", new EntityIdentifier(typeof(Photo), photoId)); }
}
每一个通知类型都应当有一个唯一的名称(如示例中的SentFrendshipRequest 和CommentPhoto)。
INotificationSubscriptionManager还有UnsubscribeAsync,IsSubscribedAsync,GetSubscriptionsAsyn等方法来管理订阅。
发布通知
INotificationPublisher用来发布通知,例如:
public class MyService : ITransientDependency
{private readonly INotificationPublisher _notiticationPublisher;public MyService(INotificationPublisher notiticationPublisher){_notiticationPublisher = notiticationPublisher;}//发送一个一般通知给一个特定用户public async Task Publish_SentFrendshipRequest(string senderUserName, string friendshipMessage, UserIdentifier targetUserId){await _notiticationPublisher.PublishAsync("SentFrendshipRequest", new SentFrendshipRequestNotificationData(senderUserName, friendshipMessage), userIds: new[] { targetUserId });}//发送一个实体通知给一个特定用户public async Task Publish_CommentPhoto(string commenterUserName, string comment, Guid photoId, UserIdentifier photoOwnerUserId){await _notiticationPublisher.PublishAsync("CommentPhoto", new CommentPhotoNotificationData(commenterUserName, comment), new EntityIdentifier(typeof(Photo), photoId), userIds: new[] { photoOwnerUserId });}//发送一个一般通知给所有当前租户(在会话里)里的订阅它的用户public async Task Publish_LowDisk(int remainingDiskInMb){//Example "LowDiskWarningMessage" content for English -> "Attention! Only {remainingDiskInMb} MBs left on the disk!"var data = new LocalizableMessageNotificationData(new LocalizableString("LowDiskWarningMessage", "MyLocalizationSourceName"));data["remainingDiskInMb"] = remainingDiskInMb;await _notiticationPublisher.PublishAsync("System.LowDisk", data, severity: NotificationSeverity.Warn); }
}
通知类型
在第一个例子里, 我们发布一个通知给一个单独的用户,SentFrendshipRequestNotificationData应该继承于NotificationData,如下所示:
[Serializable]
public class SentFrendshipRequestNotificationData : NotificationData
{public string SenderUserName { get; set; }public string FriendshipMessage { get; set; }public SentFrendshipRequestNotificationData(string senderUserName, string friendshipMessage){SenderUserName = senderUserName;FriendshipMessage = friendshipMessage;}
}
第二个例子,我们发送一个通知给一个特定用户并传递一个特定实体,通知数据类不需要可序列化(因为默认使用JSON序列器),但建议把它标记为可序列化,因为你可能会在不同应用中移动而且你将来也可能想使用二进制可序列化器。当然如前面所述,通知数据是可选的,并不是所有的通知都需要它。
注意:如果我们发布一个通知给一个特定用户,那么这个用户不需要订阅这个通知。
第三个例子,我们没有定义一个专用的通知数据类,而是直接使用内容的LocalizableMessageNotificationData类,并使用基于字典的数据,并发布一个“Warn”通知,LocalizableMessageNotificationData可以存储基于字典的任意数据(如果自定义的通知数据类继承于NotificationData类,那么也可以这么用),我们使用“remainingDiskInMb”作为本地化参数,本地化信息可以包含这些参数(如示例中的“Attention!Only{remainingDiskInMb} MBs left on the disk!”)。
用户通知管理器IUserNotificationManager
IUserNotificationManager用来管理用户的通知,它get,update或delete一个用户的通知,你可以用它为你的应用准备一个通知列表页面。
实时通知IRealTimeNotifier + SignalR
虽然可以用IUserNotificationManager来查询通知,但我们通常想推送一个实时通知到客户端。
通知系统使用IRealTimeNotifier来发送实时通知给用户,这可以使用任何类型的实时通讯系统实现,我们可以用一个单独实现的SignalR包,启动模板已经安装了SignalR,查看SignalR集成文档获取更多信息。
注意:通知系统用一个后台作业异步调用IRealTimeNotifier,所以,通知可能会有一点点的延迟。
客户端
当接收到一个实时的通知,ABP在客户端触发一个全局事件,你可以用如下的方式注册来得到通知:
abp.event.on('abp.notifications.received', function (userNotification) {console.log(userNotification);
});
每接收到一个实时通知,都会触发abp.notifications.received事件事件,你可以像上面那样注册该事件来获取通知,查看javascript事件总线文档获取事件更多信息。一个收到的“System.LowDisk”通知的Json示例:
{"userId": 2,"state": 0,"notification": {"notificationName": "System.LowDisk","data": {"message": {"sourceName": "MyLocalizationSourceName","name": "LowDiskWarningMessage"},"type": "Abp.Notifications.LocalizableMessageNotificationData","properties": {"remainingDiskInMb": "42"}},"entityType": null,"entityTypeName": null,"entityId": null,"severity": 0,"creationTime": "2016-02-09T17:03:32.13","id": "0263d581-3d8a-476b-8e16-4f6a6f10a632"},"id": "4a546baf-bf17-4924-b993-32e420a8d468"
}
在这个对象里:
- userId:当前用户Id,通常你不需要这个因为你知道当前的户。
- state:UserNotificationState的枚举值,0:Unread(未读),1:Read(已读)。
- notification:通知明细:
- notificationName:这个通知的唯一名称(发布时也用这个名称)。
- data:通知数据,在这个示例里,我们使用LocalizableMessageNotificationData(和之前发布的示例一致):
- message:本地化的消息信息,我们可以用sourceName和name来本地化界面上的消息。
- type:通知数据类型,全类型名,包含命名空间,当在处理通知数据时,我们可以检查这个类型。
- properties:基于字典的自定义属性。
- entityType、entityTypeName和entityId:实体信息(如果这是一个实体实时通知)
- severity:一个NotificationSeverity枚举值,0:Info,1:Success,2:Warn,3:Error,4:Fatal。
- id:通知Id。
- id:用户通知Id。
把通知信息显示给用户
abp.event.on('abp.notifications.received', function (userNotification) {if (userNotification.notification.data.type === 'Abp.Notifications.LocalizableMessageNotificationData') {var localizedText = abp.localization.localize(userNotification.notification.data.message.name,userNotification.notification.data.message.sourceName);$.each(userNotification.notification.data.properties, function (key, value) {localizedText = localizedText.replace('{' + key + '}', value);});alert('New localized notification: ' + localizedText);} else if (userNotification.notification.data.type === 'Abp.Notifications.MessageNotificationData') {alert('New simple notification: ' + userNotification.notification.data.message);}
});
为了能处理通知数据,我们应当检查这个数据类型,这个例子简单的从通知数据里获取消息,如果是本地化的消息(LocalizableMessageNotificationData),我们本地化这个消息并替换参数, 如果是简单消息(MessageNotificationData),我们直接获取这个消息,当然,在真实的项目里,我们不会使用alert函数,我们可以使用abp.notify api来显示良好的UI通知。
如果你想实现上面这样的逻辑,有一个更容易且富有弹性的方式,当接收到一个推送的通知,你只需要一行代码来显示UI通知:
abp.event.on('abp.notifications.received', function (userNotification) {abp.notifications.showUiNotifyForUserNotification(userNotification);
});
这显示一个UI通知,如下所示(上面描述的推送的System.LowDisk通知):
它可工作于内容的通知数据类型(LocalizableMessageNotificationData和MessageNotificationData),如果你是自定义的通知数据类型,那么你应该像下面这样注册数据格式:
abp.notifications.messageFormatters['MyProject.MyNotificationDataType'] = function(userNotification) {return ...; //此处格式化并返回消息
};
因此,showUiNotifyForUserNotification可以为你的数据类型创建显示的消息,如果你只是需要格式的消息,你可以直接使用abp.notifications.getFormattedMessageFromUserNotification(userNotification), 它内部被showUiNotifyForUserNotification。
通知存储
通知系统使用INotificationStore来持久化通知,该接口实现后才能使通知系统正常工作,你可以自己实现它或使用已经实现它的module-zero。
通知定义
你不需要在用前先定义一个通知,你只管使用任何通知名称而无需定义,但是,定义它可能给你带来额外的好处,例如,定义后你可以在你的应用里检查所有的通知。鉴于这种情况,我们可以为我们的模块定义一个通知供应器,如下所示:
public class MyAppNotificationProvider : NotificationProvider
{public override void SetNotifications(INotificationDefinitionContext context){context.Manager.Add(new NotificationDefinition("App.NewUserRegistered",displayName: new LocalizableString("NewUserRegisteredNotificationDefinition", "MyLocalizationSourceName"),permissionDependency: new SimplePermissionDependency("App.Pages.UserManagement")));}
}
在模块的PreInitialize事件里注册它
Configuration.Notifications.Providers.Add<MyAppNotificationProvider>();
最后,你可以在你应用中注入并使用INotificationDefinitionManager来获取通知定义,接着你可能想准备一个允许用户自己订阅这些通知的页面。
转载于:https://www.cnblogs.com/wj033/p/6507321.html
ABP文档笔记 - 通知相关推荐
- HOOMD Blue 文档笔记
HOOMD Blue文档笔记 基于hoomd 1.0.2 userdoc http://codeblue.umich.edu/hoomd-blue/doc/index.html 3. 快速开始 例程: ...
- 1、ABP 文档介绍
ABP 文档介绍 Quick Start Getting Started Architecture Infrastructure ABP是一个开源且文档友好的应用程序框架.ABP不仅仅是一个框架,它还 ...
- Vue官网2文档笔记
文章目录 $event $on Class 与 Style 绑定 对象语法 列表渲染 v-for 中使用对象 事件处理 事件修饰符 插槽 具名插槽 解构插槽 prop 动态组件&异步组件 访问 ...
- NE40E华为产品文档-----笔记(2022.9.28)
** NE40E华为产品文档-----笔记(2022.9.28) ** P34开始 全连接full Mesh 中文解释:全网状 英文来历:Full Mesh表示网络的一种连接形式,即所有结点之间都直接 ...
- 这几款文档笔记工具,你习惯用哪个?
前言 俗话说的好:"好记性不如烂笔头",平时工作记录笔记的确是一个良好的习惯,做文档笔记可以在我们遗忘时进行回看,方便查找,代替人的大脑.有时程序写多了,很不愿意去强制记忆一些东西 ...
- 文档笔记----nodejs菜鸟教程
<html><head><meta charset="utf-8"><title>文档笔记----nodejs菜鸟教程</ti ...
- ABP文档 - Javascript Api - AJAX
本节内容: AJAX操作相关问题 ABP的方式 AJAX 返回信息 处理错误 HTTP 状态码 WrapResult和DontWrapResult特性 Asp.net Mvc 控制器 Asp.net ...
- Apple Developer文档笔记(一)AppKit App Structure
导语 这篇文章是方便自己学习理解苹果开发者的文档的笔记,希望能给有需要的同学一些帮助,因为自己翻译理解的内容, 必然存在一些不足,还望指出. Apple Developer (https://deve ...
- Apple Developer文档笔记(二)Bundle Resources Foundation
导语 这篇文章是方便自己学习理解苹果开发者的文档的笔记,希望能给有需要的同学一些帮助,因为自己翻译理解的内容, 必然存在一些不足,还望指出. Apple Developer (https://deve ...
- python入门教程jupyter_python数据分析师快速入门1Jupyter文档笔记工具
简介 Jupyter Notebook是一个Web应用程序,允许您创建和共享包含实时代码,方程式,可视化和说明文本的文档. Jupyter Notebook类似于画布或环境,它允许您使用编程语言来执行 ...
最新文章
- ONNX MLIR方法
- ValueError: not enough values to unpack (expected 3, got 0)问题
- sqlserver 新建只读权限用户
- javascript与jQuery对照学习总结(一)(一些常规操作)
- 雷军反击董明珠:感觉董总好像认输了似的
- 河南信息工程学校计算机组装比赛,计算机技术系承办2019全员化试点项目计算机网络装调赛项...
- cf246E. Blood Cousins Return
- SQL必知必会-事物处理
- 理解Fragment生命周期(一)
- 记工软件 包工头记工软件 建筑记工软件 工程记工软件
- 空气污染扩散模型-高斯烟羽烟团模型原理及GIS应用示例
- 传感器研究NO1.陀螺仪
- PHP实现站内信设计思路与方案
- 什么叫做风险纳税人?如何解除风险
- 【tkGo】将Excel里的图片链接替换为图片(Excel嵌入图片)
- svm matlab 图像分割,勇哥的视觉实验:SVM分类器(二) 支持向量机的应用例子,图片分割...
- setTimeout()和setInterval()的区别和转换
- PT100温度电阻转换器
- APP地推的一些经验
- 青岛 android培训哪家好,青岛android培训学习班
热门文章
- 间歇性孤独症,我喜欢的,是你刚好在我身边
- python柱状图颜色_Python 绘制 柱状图
- Android人脸识别的初步学习
- 阿里云DataV使用笔记
- 用prototype 方法$A() uncheck radio button
- mysql 触发器 instead of_SQL Server Instead Of触发器
- xsmax无法进入dfu模式_iPhone XR/XS/XS Max 如何进入恢复模式或 DFU 模式?
- Neokylin基础命令
- java与wps_java能否wps调用页码
- word,wps设置页眉和页码