网站迁移纪实:从Web Form 到 Asp.Net Core (Abp vNext 自定义开发)
问题和需求
从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相关文件到自定义项目对应的目录中,直接修改就可以了。需要修改的文件如下图:
网站的颜色等需要修改文件global-styles.css:
首页
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服务器不熟悉,折腾了一些时间,不过最后也成功了。
到现在新网站运行了两个多月,基本没有遇到太大的问题。效果还是不错的,速度提升很多。