ABP框架 v2.7.0已经发布!

ABP框架和ABP商业版 v2.7已经发布.我们没有为2.4,2.5和2.6发布博客文章,所以这篇文章也将涵盖这几个版本中新增内容和过去的2个月里我们完成了什么.

关于发布周期与开发

之前说过我们已经开始每两个星期发布一个新的次要功能版本,一般在星期四.我们的目标是尽快提供新功能.

在过去的7-8周里, 我们在1,300+次提交中完成和合并了数百个issue和pull request, 这只是ABP框架的库.每日提交的次数不断增加：

ABP.IO平台正在快速增长,我们从社区获取的贡献越来越多.

ABP框架有哪些新增内容?

对象扩展系统(Object Extending System)

在过去的几个版本中,我们主要集中在以NuGet/NPM包使用现有模块时, 提供扩展的方法,

对象扩展系统允许模块开发者创建可扩展的模块并允许应用开发者更容易地定制和扩展.

例如,你可以这样为Identity模块的User实体添加两个扩展属性:

ObjectExtensionManager.Instance.AddOrUpdate<IdentityUser>(options =>{options.AddOrUpdateProperty<string>("SocialSecurityNumber");options.AddOrUpdateProperty<bool>("IsSuperUser");});

也很容易为这些属性定义验证规则：

ObjectExtensionManager.Instance.AddOrUpdateProperty<IdentityUserCreateDto, string>("SocialSecurityNumber",options =>{options.Attributes.Add(new RequiredAttribute());options.Attributes.Add(new StringLengthAttribute(32) {MinimumLength = 6});});

你甚至可以编写自定义代码来验证属性.它会自动适用于应用服务, 控制器或页面的参数对象.

实体的扩展属性通常存储在数据库表的一个单独的JSON格式的字段中,但是你也可以轻松地使用EF Core映射配置该属性为一个表字段：

ObjectExtensionManager.Instance.AddOrUpdateProperty<IdentityUser, string>("SocialSecurityNumber",options =>{options.MapEfCore(b => b.HasMaxLength(32));});

请参见有关该系统的详细信息对象扩展文档.

也可参见自定义现有模块指南,以了解所有可能的自定义选项.

文本模板包

Volo.Abp.TextTemplating是v2.7.0中新加入的包.此前,Volo.Abp.Emailing包也有类似的功能,但它的功能是有限的,实验性质的并且和发送邮件紧密耦合在一起.

新文本模板包允许你定义基于文本的模板, 可以很容易地本地化和重用.你可以定义布局模板并且与其它模板共享.

目前,我们正在使用它发送邮件.一个需要发送邮件的模块通常定义了一个模板.如：

<h3>{{L "PasswordReset"}}</h3><p>{{L "PasswordResetInfoInEmail"}}</p><div><a href="{{model.link}}">{{L "ResetMyPassword"}}</a>
</div>

这是一个典型的密码重置邮件模板.

模板系统是基于开源的Scriban库.因此,它支持if条件,循环等等.
model用于将数据传递到模板(就像ASP.NET Core MVC).
L是一个特殊函数用于本地化给定的字符串.

为所有邮件使用相同的布局是一个典型应用.所以,你可以定义一个布局模板.这是框架自带的标准的布局：

<!DOCTYPE html>
<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head><meta charset="utf-8" />
</head>
<body>{{content}}
</body>
</html>

布局中应该有一个{{content}}区域用来呈现子内容(就像MVC中的RenderBody()).

最终应用程序可以很容易地通过覆盖模板内容来自定义它.

每当你需要渲染模板时,提供模板名称和model来使用ITemplateRenderer服务.详情请参见文本模板文档.我们甚至还为ABP商业版创建了UI(请参见下面的相关章节).

订阅异常

ABP框架的异常处理系统会自动处理异常并且为客户端返回相应的结果.在某些情况下,你可能希望每当异常发生时有一个回调.通过这种方式,例如,你可以发送邮件或采取基于异常的任何动作.

只需要在你的应用程序中创建一个从ExceptionSubscriber派生的类：

public class MyExceptionSubscriber : ExceptionSubscriber
{public override async Task HandleAsync(ExceptionNotificationContext context){//TODO...}
}

更多信息请参见异常处理.

其他

在之前的发布中框架也有很多小的功能和改进.这里列举几个：

新增了AbpLocalizationOptions.DefaultResourceType用来设置应用程序的默认资源类型.通过这种方式,当资源未指定时, 本地化系统使用默认的资源.最新的应用程序启动模板已经配置了,你也可以为你现有的应用程序设置它.
权限定义新增了IsEnabled.通过这种方式,你可以从应用程序中完全禁用权限和隐藏相关功能.这可在一些应用程序中做为功能开关的方式.用法请参见#3486.
框架中定义的所有本地化资源新增了荷兰语和德语本地化.感谢贡献者们.

ABP商业版有哪些新增内容?

ABP商业版的目标是基于ABP框架项目提供预构建的应用程序功能,代码生成工具,专业的主题,先进的示例和高级支持.

我们正在并行工作于ABP商业版与ABP框架功能对齐,并提供更多的模块,主题选项和工具.

本节将介绍ABP商业版这边有哪些进展.

模块实体扩展系统

模块实体扩展系统是相对于对象扩展系统(上面介绍的)的一个更高级别的API,并提供了一种简单的方法来向现有实体中增加扩展属性.一个新的扩展属性可以很容易地自动成为HTTP API和用户界面的一部分.

例如：向Identity模块的User实体中添加SocialSecurityNumber

ObjectExtensionManager.Instance.Modules().ConfigureIdentity(identity =>{identity.ConfigureUser(user =>{user.AddOrUpdateProperty<string>( //属性类型: string"SocialSecurityNumber", //属性名property =>{//验证规则property.Attributes.Add(new RequiredAttribute());property.Attributes.Add(new StringLengthAttribute(64) {MinimumLength = 4});//...该属性的其它配置});});});

仅通过这样的配置,用户界面就将具有新的属性(在表中和在创建/编辑表单中)：