问题和需求

从2004年上线,ZLDNN.COM运行已经超过16年了,一直使用DotNetNuke平台(现在叫DNN Platform),从最初的DotNetNuke 2.1到现在使用的7.4。先是在亦庄的独立服务器托管,后来迁到美国的PowerDNN的云服务器ECS,再后来迁移到阿里云的ECS,采用Windows 2008系统,运行几年以后,C盘已经满了,可又没有办法清理,网站速度越来越慢,干脆长痛不如短痛,彻底更新一下。

DotNetNuke严重依赖Web Form技术,其开发团队到现在也没有找到从.Net Framework迁移到.Net Core以及最新的.Net 5或.Net 6的合适技术路线,导致其只能在Windows下运行。另外一个问题是DotNetNuke只能使用SqlServer数据库,无法使用更便宜更灵活的数据库。网站的迁移实际上是在满足现有基本功能的前提下,采用新的技术重新开发。在选择新的技术之前,首先需要梳理一下网站的功能,确定哪些需要保留,哪些可以通过其它方式替代,哪些可以暂时不实现。网站需要保留的部分包括:

  • 数据:包括用户数据、订单数据、技术支持数据等。
  • 网站页面的Url: 大部分Url已经是SEO友好,但有些页面仍然采用web form模式,比如GetLicense.aspx,这部分Url也需要保留。
  • 关键功能:诸如订单接收、产品激活等。

其它的需求还有,希望网站可以运行在维护成本比较低的轻量级应用服务器中,可以采用MySql等开源数据库,视觉效果上尽量与原有系统相同等等。还要留有用户管理已经用户注册的接口。

在大的技术路线上,仍然采用.Net体系,研究了几种技术,包括Qutane、Orchard等,最后决定采用Abp vNext进行开发。

开发

将开发中遇到的具体问题和最终的解决方案总结一下。

外观

采用ABP自带的Theme,根据现有网站的风格进行修改,保持风格大体一致。修改的办法是从Abp源码中复制Theme相关文件到自定义项目对应的目录中,直接修改就可以了。需要修改的文件如下图:
网站迁移纪实:从Web Form 到 Asp.Net Core (Abp vNext 自定义开发)-LMLPHP
网站的颜色等需要修改文件global-styles.css:
网站迁移纪实:从Web Form 到 Asp.Net Core (Abp vNext 自定义开发)-LMLPHP

首页

DotNetNuke完全采用动态页面,原来的首页采用的是HTML模块加上DNNArticle的子模块,考虑到首页的更新频率不高,这次采用静态页面。

维护页面

这部分主要是产品、版本、订单等等的维护,属于标准的CRUD界面。这部分采用ABP的标准化设计,首先设计各个实体,然后使用AbpHelper.Gui和AbpHelper.CLI生成相关代码和界面。所生成的界面基本可以使用,需要改造的地方是增加查询功能和调整权限。这里简单介绍一下如何增加查询功能。
ABP MVC/Razor Page 模板生成的基于DataTables.Net的页面支持分页和排序,但缺省情况下不支持查询,需要根据实际情况自行添加。我们可以利用DataTables.Net自带的查询功能实现查询。

首先修改Application项目,增加带有查询的Application服务。先在PagedAndSortedResultRequestDto基础上定义带有关键字的Dto:

    public class OrderNotificationSearchDto: PagedAndSortedResultRequestDto
    {
        public string Key { get; set; }
    }

然后在Application 服务中增加查询服务:

        public async Task<PagedResultDto<OrderNotificationDto>> GetSearchListAsync(OrderNotificationSearchDto input)
        {
            var query = await CreateFilteredQueryAsync(input);
            if (!string.IsNullOrEmpty(input.Key))
            {
                query = query.Where(o => o.InvoiceID.Contains(input.Key)
                || o.OptionName.Contains(input.Key)
                || o.PackageName.Contains(input.Key)
                || o.BillToEmail.Contains(input.Key));
            }

            var totalCount = await AsyncExecuter.CountAsync(query);

            query = ApplySorting(query, input);
            query = ApplyPaging(query, input);

            var entities = await AsyncExecuter.ToListAsync(query);
            var entityDtos = await MapToGetListOutputDtosAsync(entities);

            return new PagedResultDto<OrderNotificationDto>(
                totalCount,
                entityDtos
            );
        }

然后需要改造客户端,首先将index.js中datatables的设置searching改为true:

   var dataTable = $('#OrderNotificationTable').DataTable(abp.libs.datatables.normalizeConfiguration({
        processing: true,
        serverSide: true,
        paging: true,
        searching: true,

接下来修改ajax的定义:

//ajax: abp.libs.datatables.createAjax(service.getList),
        ajax: abp.libs.datatables.createAjax(service.getSearchList, inputAction, responseCallback),

将getList修改为新的getSearchList,增加新的传入参数和Callback。这两个函数定义如下:

   var inputAction = function (requestData, dataTableSettings) {
        var ctl = $("#OrderNotificationTable_filter input").val();

        return {
            key: ctl,
        };
    };

    var responseCallback = function (result) {

        // your custom code.

        return {
            recordsTotal: result.totalCount,
            recordsFiltered: result.totalCount,
            data: result.items
        };
    };

网站数据的导入

这部分主要包括产品数据和与激活相关的数据,采用自己写的一个面向.Net Core的ADO库,将原有的数据导出到Xml中,在新的应用中从Xml中读取数据进行初始化。

产品内容页

产品的内容原来保持在数据库中,现在改为在文件中保存,加载产品页时,从文件读出展示。

外部数据交换

主要包括接收从DNNStore发来的数据和产品激活两部分。采用Application Service实现,通过Apb框架的动态Web Api可以访问。

Url重定位

包括与外界交换数据的Url和为了保证SEO一致的界面Url。采用.Net Core的ReWrite中间件实现,感觉这部分真的很好用。代码如下:


            var options = new RewriteOptions()
            .AddRewrite(@"^GetLicense.aspx", "Products/Services/ManualActivate",true)
            .AddRewrite(@"^Products/currentpage/(\d+)", "Products?currentpage=$1", true)
            .AddRewrite(@"^ProductDetail/(.+)", "Products/ViewDetail?name=$1", true)
            .AddRewrite(@"^LicenseCode.aspx", "api/app/activate/req-license-code", true)
            .AddRewrite(@"^desktopmodules/OrderNotification/OrderNotify.aspx", "api/app/activate/save-order", true)
             app.UseRewriter(options);

还有其它一些细节包括关闭多租户、关闭用户注册、国际化修改等等。

从十一前开始,断断续续开发了两到三周的时间。

部署和运行

以前一直在Windows生态中,部署应用似乎不是大问题,只有在IIS上创建网站或者应用就可以了。现在希望将ZLDNN.COM迁移到阿里云的轻量级服务器,在Linux系统下部署,还是遇到一些挑战。

首先解决.Net Core应用在Linux上运行的问题。由于在生产环境中只运行一个.Net Core应用,所以在生成部署文件时采用独立运行模式,这样就不需要在生产环境中安装.Net框架。这一步没有遇到大问题,测试应用能够运行。

然后是ABP应用在生产环境上运行,这里遇到一个问题,Couldn’t find a valid ICU package installed on the system.这个问题在本地测试没有遇到,查了一下是没有安装ICU库,安装完成后问题解决了。

数据库的配置没有遇到太大麻烦,但在后期运行时出现了MySql异常退出的问题,发现是内存问题,创建内存交换文件后解决了。

Apache服务器配置花了一些时间,因为两个域名驻留在同一个服务器上,需要将Apache服务器配置为反向代理服务器,由于对Apache服务器不熟悉,折腾了一些时间,不过最后也成功了。

到现在新网站运行了两个多月,基本没有遇到太大的问题。效果还是不错的,速度提升很多。

12-31 03:34