ABP框架 v2.9发布！

ABP框架和ABP商业版2.9已经发布,这是3.0之前的最后一个版本!　这篇文章将涵盖本次发布中的新增内容.

ABP框架2.9有哪些新增内容？

你可以中GitHub的发行说明中看到所有的变更.这篇文章将只包括重要特征/变更.

预编译Razor Pages

在之前的版本, 预构建的页面(应用模块)和视图组件是在运行时编译. 现在,它们使用了预编译. 我们测试了的应用程序启动时间(尤其是MVC UI)已经减少了50%以上.换句话说,它比之前的版本快两倍.速度变化也影响你第一次访问某一个页面时.

这是一个v2.8和v2.9启动应用程序模板的对比结果:

### v2.800:00:04.891 [INF] Starting web host.
00:00:07.662 [INF] Now listening on: https://localhost:44391
00:00:17.315 [INF] Request finished in 7756.6218ms 200 text/html;Total: 12.42s### v2.900:00:13.720　[INF] Starting web host.
00:00:16.639　[INF] Now listening on: https://localhost:44369
00:00:18.957　[INF] Request finished in 1780.5461ms 200 text/html;Total: 5.24s

你不用做任何改动就能获得新方法带来的益处.　重写UI页/组件和之前一样也能正常工作.　我们将在v3.0中继续致力于性能上的提升.

组织机构系统

Identity模块现在有了呼声最高的功能: 组织机构!

组织机构系统用来在应用程序中创建分层组织树.这样你可以使用该组织树来授权应用程序中的数据和功能.

文档将很快到来......

新的Blob存储包

我们创建了一个新的Blob存储包用来存储任意二进制对象.它一般用于在应用程序中存储文件.这个包提供了一个抽象,因此任何应用程序或模块都能以存储提供器无关的方式来保存和获取文件.

目前实现了两个存储提供器:

Volo.Abp.BlobStoring.FileSystem包, 在本地文件系统中存储对象/文件.
Volo.Abp.BlobStoring.Database模块, 在数据库中存储对象/文件.目前支持Entity Framework Core(因此,你可以使用任何关系数据库和MongoDB).

Azure BLOB提供器将会在3.0中可用. 你可请求其他的云提供器或在GitHub库上提交你自己的贡献.

Blob存储系统的一个好处是,它允许你创建多个容器(每个容器是一个Blob存储),并为每个容器使用不同的存储提供器.

示例:使用默认的容器保存和取得一个字节数组

public class MyService : ITransientDependency
{private readonly IBlobContainer _container;public MyService(IBlobContainer container){_container = container;}public async Task FooAsync(){//保存一个BLOBbyte[] bytes = GetBytesFromSomeWhere();await _container.SaveAsync("my-unique-blob-name", bytes);//获取一个BLOBbytes = await _container.GetAllBytesAsync("my-unique-blob-name");}
}

它可以使用byte[]和Stream对象.

示例:使用类型化(命名)容器来保存和获取stream

public class MyService : ITransientDependency
{private readonly IBlobContainer<TestContainer> _container;public MyService(IBlobContainer<TestContainer> container){_container = container;}public async Task FooAsync(){//保存一个BLOBStream stream = GetStreamFromSomeWhere();await _container.SaveAsync("my-unique-blob-name", stream);//获取一个BLOBstream = await _container.GetAsync("my-unique-blob-name");}
}

TestContainer只是一个用来标识容器的空类:

[BlobContainerName("test")] //指定容器的名字
public class TestContainer
{}

类型化(命名)容器可被配置为使用不同的存储提供器而不是默认的.在开发可复用的模块时, 始终使用类型化的容器是一个很好的做法,这样最终应用程序可以为这个容器配置提供器,而不影响其他容器.

示例:为TestContainer配置文件系统提供器

Configure<AbpBlobStoringOptions>(options =>
{options.Containers.Configure<TestContainer>(configuration =>{configuration.UseFileSystem(fileSystem =>{fileSystem.BasePath = "C:\\MyStorageFolder";});});
});

查看blob存储文档以获取更多的信息.

Entity Framework Core的Oracle集成包

我们创建了一个Oralce集成包,这样你就可以为EF Core轻松地切换到Oracle.它已经为框架和预构建的模块进行了测试.

查看文档开始使用Oracle集成包.

自动判断数据库提供器

当你用EF Core开发一个可复用的应用程序模块时,你通常要将你的模块开发为DBMS无关的.但是,不同的DBMS有一些微小的(有时是很大的)区别.现在如何你执行基于DBMS的自定义映射,可以使用ModelBuilder.IsUsingXXX()扩展方法:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{base.OnModelCreating(modelBuilder);modelBuilder.Entity<Phone>(b =>{//...if (modelBuilder.IsUsingPostgreSql()) //检查是否在使用PostgreSQL!{b.Property(x => x.Number).HasMaxLength(20);}else{b.Property(x => x.Number).HasMaxLength(32);}});
}

除了上面这种的傻傻的例子,你可以任意配置你的映射!

ABP CLI　翻译命令

abp translate是一个新的命令,当你的源代码库中包含多个JSON本地化文件时, 它可用来简化翻译本地化文件,

该命令的主要目的是翻译ABP框架的本地化文件(因为abp库在不同的文件中含有成千上万个本地化文件需要翻译).

非常感谢如果你使用这个命令将框架资源翻译为你的母语.

查看文档来学习如何使用它.也可查看贡献指南.

新的虚拟文件系统浏览器模块

感谢@liangshiw创建并贡献了一个新的模块用来浏览虚拟文件系统中的文件.它适用于MVC UI并显示所有应用程序中的虚拟文件.示例截图: