CMS Kit Pro：URL 转发系统

使用 CMS Kit Pro 模块功能需具备 ABP Team 或更高级许可。

CMS Kit 提供 URL 转发 系统，可创建重定向至其他页面或外部网站的 URL。

启用 URL 转发系统

CMS Kit 功能默认处于禁用状态。因此，在使用前需要先启用所需功能。您可以通过全局功能系统在开发阶段启用/禁用 CMS Kit 功能，或使用 ABP 的功能系统在运行时禁用 CMS Kit 功能。

除启用短链接全局功能外，还需在最终应用程序中添加 UrlShortingMiddleware 中间件：

using Volo.CmsKit.Pro.Public.Web.Middlewares;
.
.
        public override void OnApplicationInitialization(ApplicationInitializationContext context)
        {
            var app = context.GetApplicationBuilder();

            app.UseMiddleware<UrlShortingMiddleware>();
            .
            .

用户界面

菜单项

URL 转发：打开 URL 转发管理页面。

页面

URL 转发管理页面

您可以在解决方案的管理端创建新转发规则，或更新/删除现有规则。

配置选项

ShortenedUrlCacheOptions

ShortenedUrlCacheOptions 用于配置 URL 转发系统的缓存设置。示例：

Configure<ShortenedUrlCacheOptions>(options =>
{
    options.CacheAllOnStartup = true; // 在启动时缓存所有短链接
});

内部实现

领域层

聚合

本模块遵循实体最佳实践与规范。

ShortenedUrl

• ShortenedUrl（聚合根）：代表系统中的 URL 映射关系。

仓储

本模块遵循仓储最佳实践与规范。

为此功能定义的定制仓储：

• IShortenedUrlRepository

应用层

应用服务

• UrlShortingAdminAppService（实现 IUrlShortingAdminAppService）：实现 URL 转发管理的业务用例
• UrlShortingPublicAppService（实现 IUrlShortingPublicAppService）：实现面向公共网站的 URL 转发业务用例

数据库提供程序

通用配置

数据表/集合前缀与架构

所有数据表/集合默认使用 Cms 前缀。如需修改表前缀或设置架构名称（若数据库提供商支持），可在 CmsKitDbProperties 类中设置静态属性。

连接字符串

本模块使用 CmsKit 作为连接字符串名称。若未定义该名称的连接字符串，将回退至 Default 连接字符串。

详见连接字符串文档。

Entity Framework Core

数据表

• CmsShortenedUrls

MongoDB

集合

• CmsShortenedUrls