将 Net 项目升级 Core项目经验:(二)修复迁移后Net Standard项目中的错误

修复迁移后Net Standard项目中的错误

接上一章,项目编译结果以下: imagehtml

解决依赖dll引用

在Net Framework项目的引用以下: imagegit

各引用和做用:github

  • log4net(1.10.0.0) 用于写框架日志
  • Castle.DynamicProxy(1.1.5.1) 用于代理类生成
  • Micosoft.Practice.EnterpiseLibrary 微软企业库,用于管理数据连接和缓存的功能
  • System.Data.OracleClient 用于连接Oracle数据库
  • System.Data 用于SQL SERVER 、OLeDB、ODBC的数据库操做

这些老的项目引用是不能直接用在Net Standard项目上的,解决过程以下:web

  • [解决] log4net是开源项目,从2.0.6 版开始就已经支持.NET Core,目前是2.0.8,在在开源网站和nuget上能够下载到。经过nuget引用最新的dll,能够无缝兼容
  • [解决] Castle.DynamicProxy也是一个开源的项目,他也具备.NET Core版本对应的DLL(Castle.Core),只是接口和我引用的1.1.5.1的接口有一点点区别,能够调整一点代码解决,同时把老项目的dll也引用最新的dll便可。
  • [移除相关的代码]Micosoft.Practice.EnterpiseLibrary 企业库微软已经很早不支持了,也没有对应的Core版本,个人作法是检查下代码看看这些代码是否能去掉,或用别的方式来实现。
  • System.Data.OracleClient Net Core官方没有出dll来实现,可是有社区已经实现了对应的dll. 目前我没有验证这个功能,只是将相关的类不编译。
  • System.Data 这个参考下面的章节,来解决,由于以前这个dll包含了oledb、odbc、sqlserver的数据库。目前微软有Syste.Data.SqlClient.dll来兼容sql server的其余的都不支持。

新项目的引用截图: imagesql

数据库相关的错误修订

MS Sql Server

Net 和 MS Sql Server交互大多经过Syste.Data.SqlClient.dll中相关类操做,在Core项目中,项目中经过引用Nuget中的 System.Data.SqlClient包,便可修复。数据库

OleDB 和 ODBC

Net Core\Standard再也不支持System.Data.OleDb。 目前没有找到相关 Net Core\Standard 中官方有相关的类库来替代。 因此在编译Net Core\Standard项目时,经过项目文件去除相关类。缓存

移除编译的方式很简单,使用文本编辑器,打开.csproj文件: 以前咱们经过添加一下配置,将代码以快捷方式添加到新项目中session

<ItemGroup>
    <Compile Include="..\..\Beyondbit.Framework\**\*.cs" />
  </ItemGroup>

将咱们不须要的功能排除掉,使用如下语法:mvc

<ItemGroup>
    <Compile Remove="..\..\Beyondbit.Framework\Data\OdbcDbClientProvider.cs" />
    <Compile Remove="..\..\Beyondbit.Framework\Data\OleDbDbClientProvider.cs" />
 </ItemGroup>

经过上面,新项目中,就不会出现OdbcDbClientProvider.cs文件,而老项目还有的。经过这种方式排除和olddb和odbc相关的类。oracle

Oracle

Net Core\Standard再也不支持System.Data.OracleClient。 微软没有提供相关类库来支持,可是有开源社区有实现的版本OracleClientCore ,能够在Nuget 中下载,这个我没有试过是否有效。

修复配置文件读取的错误

Web.config \ App.config

在Net Core 2.0 之后是支持App.config的,在以前Net Core 中的配置不能像咱们在Net Frameword中那样读取配置。 2.0以前Net Core读取配置的方法,能够参考LizeZere 同窗的文章《ASP.NET Core开发-读取配置文件Configuration》和晓晨Master同窗的文章《.NET Core 配置Configuration杂谈

在Net Core\Standard中是没有web.config的概念,No ConfigurationManager in ASP.NET Core,没错.net core 不支持了。
不过能够采起变通的方式来解决,参考binbinxu同窗的文章解决《.NET CORE 2.0 踩坑记录之ConfigurationManager》,验证是有效的。

App.config 读取BUG

实测使用System.Configuration.ConfigurationManager 4.4.1 版本读取配置时,在Web项目或者控制台应用,均可以顺利读取。但我在vs2017建立的MSUnit的测试项目运行集成测试时,读取失败了。目前还没找到方法解决,后续我会反馈BUG在github上。

编译时报“CS0579: Duplicate 'AssemblyFileVersionAttribute' attribute”错误的解决办法

当建立 .NET Core/Standard 2.0项目时,VS不会像.NET Framework项目同样自动生成AssemblyInfo.cs文件。 并且,如果手工在项目中加入之前写好的 AssemblyInfo.cs 文件,编译时会报告“CS0579: Duplicate 'AssemblyFileVersionAttribute' attribute”错误.

参考zyl910同窗的文章解决,验证有效。

修复HttpContext问题

在咱们的老项目,代码里面可能会判断当前是否在Web环境下,会读取一些之前特定的代码,这个问题是最难处理的。如如下代码: image 能够看到编译提示HttpContext在老项目能够,在新项目显示不可用,并出现红线。这是由于在NetCore中System.Web的命名空间不在包含HttpContext类了。经过查询一些文章,有不少的文章都描述了如何在Net Core下,模拟HttpContext.Current的。如:

等等文章。
可是它们都提到了须要在Startup类经过ioc注入东西,个人项目只是一个类库,他能够运行在任何环境下,我该如何在类库中使用HttpContext,而且我不想更改代码。搜索了国内和国外的网站,都没有一个很好的方案。我本身琢磨了一个临时的方案:

  • 在Nuget引用Microsoft.AspNetCore.Http库,这是net core中HttpContextBase的库
  • 在个人新项目类顶级命名空间下,建立一个静态类叫HttpContext,里面具备一个Current的属性,返回NetCore中的HttpContext,代码以下:
using Microsoft.AspNetCore.Http;
using System;
using System.Collections.Generic;
using System.Text;

namespace Beyondbit.Framework
{
    public class HttpContext
    {
        private static IHttpContextAccessor _accessor;

        public static Microsoft.AspNetCore.Http.HttpContext Current => _accessor.HttpContext;

        public static void Configure(IHttpContextAccessor accessor)
        {
            _accessor = accessor;
        }
    }
}
  • 修改代码将System.Web.HttpContext.Current这样的代码改为 HttpContext.Current并引用System.Web命名空间
  • 这样一样的代码便可在老项目编译经过,同时新项目也能编译经过
  • 目前这样是能够编译经过,可是 HttpContext.Current是null. 须要在 mvc core项目中的Startup类中,调用一下Beyondbit.Framework.HttpContext.Configure()方法,将httpConetxt的注入到类库中

HttpContext.Current.Session问题

Net Core中的Session类和Net Framework的类变更很是的大,并且接口都已经变动,好比在Net Framework中HttpContext.Current.Session["Key"] 来获取一个object类型的变量,可是在Net Core中这样是不行的,Session已经不支持[]的写法,HttpContext.Current.Session.TryGetValue,或者扩展方法HttpContext.Current.Session.Get,但这个接口默认返回的是byte[]类型,或者HttpContext.Current.Session.GetString这样的方法获取。 这样的代码已经和Net Framework没法兼容。

目前无奈的作法是:

  1. 修改代码去除session的读取,这个须要根据具体功能来调整,不能一律去除,要否则影响原来的功能
  2. 经过条件编译,来使得net core项目不支持这些功能,而老项目编译时依然支持, 在新项目中添加条件编译的标志NETSTANDARD2_0,而后典型的代码以下:
if (HttpContext.Current == null)
                    return "";

#if NETSTANDARD2_0
                throw new NotSupportedException();
#else
                return HttpContext.Current.Session.SessionID;
#endif

NotSupportedException类是我添加的一个异常类,用来在遇到咱们想项目时调用了一些咱们临时去掉的功能,能够很明显告诉咱们代码的问题在哪里

SqlCommandBuilder

目前这个类只能利用条件编译先解决。

编译结果已经所有OK了,能够看到个人编译结果

image

总结: 第二步的工做是来消灭错误,目前已经所有完成,第三步是迁移单元测试和集成测试项目,以及最终的多个平台运行的测试。

相关文章
相关标签/搜索