将 Net 项目升级 Core项目经验：（二）修复迁移后Net Standard项目中的错误

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

接上一章，项目编译结果如下：
image

解决依赖dll引用

在Net Framework项目的引用如下：
image

各引用和作用：

  • 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项目上的，解决过程如下：

  • [解决] 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的其他的都不支持。

新项目的引用截图：
image

数据库相关的错误修订

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文件:
之前我们通过添加一下配置，将代码以快捷方式添加到新项目中

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

将我们不需要的功能排除掉，使用以下语法：

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

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

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

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

posted @ 2018-04-20 16:26  xakoy  阅读(1784)  评论(3)  编辑  收藏  举报