使用Roslyn脚本化C#代码,C#动态脚本实现方案

摘要:
【前言】Roslyn是一个开源软件。NET编译器。该编译器支持C#和Visual Basic代码编译,并提供丰富的代码分析API。Roslyn不仅可以直接编译和输出,而且上面描述的开放编译API使编写代码脚本成为可能。至于Roslyn,本文不会过多介绍,因为它没有官方文件那样丰富和详细。请转到官方地址:https://github.com/dot

【前言】

  Roslyn 是微软公司开源的 .NET 编译器。

  编译器支持 C# 和 Visual Basic 代码编译,并提供丰富的代码分析 API。

  Roslyn不仅仅可以直接编译输出,难能可贵的就是上述描述中的开放了编译的API,使得代码脚本化成为了可能。

  关于Roslyn,本文不做过多介绍,因为再介绍的丰满终究不及官方文档介绍的细腻,各位请移步官方说明地址:https://github.com/dotnet/roslyn/wiki

  使用Roslyn脚本化C#代码,C#动态脚本实现方案第1张

  众所周知,我们实现的Filter往往是写死的代码在项目里面的,一经发布,便不能随时改动,有过Paas平台开发经验的同僚更能体会到租户灵活配置个性化需求是一个难点。

  那么,我们怎么能针对不同的业务逻辑灵活地在已经部署好地站点上制定不同地业务逻辑呢,让我们一起走进这个世界。

  本文将通过一个小Demo的实现讲述如何使用Roslyn脚本化代码,以及如何采用脚本化的代码对一个网站接口实现脚本控制Before和After过滤器的功效。

  Demo 源码地址:https://github.com/sevenTiny/Demo.CSharpScript

一、熟悉Roslyn API

  • 首先项目中引入微软脚本API相关的Nuget包

  按顺序引入下面三个Nuget包

  Microsoft.CodeAnalysis.CSharp   

  Microsoft.CodeAnalysis.Scripting 

  Microsoft.CodeAnalysis.CSharp.Scripting

  • 了解API

  1.我们写一个Run脚本的Demo:

[Fact]
[Trait("desc", "调用动态创建的脚本方法")]
public void CallScriptFromText()
{
    string code1 = @"
    public class ScriptedClass
    {
        public string HelloWorld { get; set; }
        public ScriptedClass()
        {
            HelloWorld = ""Hello Roslyn!"";
        }
    }";

    var script = CSharpScript.RunAsync(code1).Result;

    var result = script.ContinueWithAsync<string>("new ScriptedClass().HelloWorld").Result;

    Assert.Equal("Hello Roslyn!", result.ReturnValue);
}

  Demo中,我们用字符串定义了一个类,并在其中写了小段逻辑,通过Run方法和ContinueWityAsync方法分别执行了两段脚本,最终的结果输出了:

 "Hello Roslyn!"

  2.我们再写一个脚本调用已存在的类的Demo:

  首先我们定义一个类型:

public class TestClass
{
    public string arg1 { get; set; }

    public string GetString()
    {
        return "hello world!";
    }

    public string DealString(string a)
    {
        return a;
    }
}

  然后写脚本执行该类型里面的DealString方法(带参数和返回值的)

[Trait("desc", "使用类的实例调用类的带参数的方法,并获取返回值")]
[Theory]
[InlineData("123")]
public void CallScriptFromAssemblyWithArgument(string x)
{
    var script = CSharpScript.Create<string>("return new TestClass().DealString(arg1);",
        ScriptOptions.Default
        .WithReferences(typeof(TestClass).Assembly)
        .WithImports("Test.Standard.DynamicScript"), globalsType: typeof(TestClass));

    script.Compile();

    var result = script.RunAsync(new TestClass { arg1 = x }).Result.ReturnValue;

    Assert.Equal(x, result.ToString());
}

  RunAsync 方法传递参数,参数名必须要和参数类型的字段名称一直才可以识别

  ScriptOptions.Default.WithReferences 明确程序集要引用的类型,类似于引用一个dll

  ScriptOptions.Default.WithImports 明确代码中引用的类型,类似于using

  globalsType: typeof(TestClass) 指定了传递参数需要用到的类型(API不支持隐式的参数,只能定义一个明确类型传递参数)

  script.Compile(); 方法将脚本编译并保存到内存中,待调用

  script.RunAsync(new TestClass { arg1 = x }).Result.ReturnValue 调用脚本并传递参数获取返回值,x=“123”,单元测试传递的参数

  然后我们便得到了“123”的返回值

  • 更多API

  更多的API我们可以从官方介绍文档中轻松得到

  官方WIKI:https://github.com/dotnet/roslyn/wiki/Scripting-API-Samples

  使用Roslyn脚本化C#代码,C#动态脚本实现方案第2张

二、一个MVC Action Before/After Filter(Action执行前后过滤器)的Demo

  首先说明项目背景及功能

  1. 运行.netcore mvc站点,点击菜单栏的进入Demo便得到下面界面
  2. 我们定义了一个Action,按序号创建了100条记录用于数据演示
  3. before 脚本的name参数是从url获取到的name参数,返回结果将作为100条Demo数据的“Name”字段Contains方法的参数 相当于Linq .Where(t=>t.Name.Contains(name));
  4. after 脚本是将 Where 语句过滤后的结果集作为参数,然后执行完脚本中的代码后,返回结果展示在了下面的页面上
  5. 可以简单理解为before是校验url参数的,after是二次处理结果数据的
  6. 为了方便测试,我们的脚本都是从本地文件读写的

  Demo的管道形式的数据流如下:

  使用Roslyn脚本化C#代码,C#动态脚本实现方案第3张

  Demo界面:

  使用Roslyn脚本化C#代码,C#动态脚本实现方案第4张

   我们从代码中可以看到上述描述的数据流程:

  使用Roslyn脚本化C#代码,C#动态脚本实现方案第5张

  ss是执行文件保存的Before脚本后的结果

  然后我们把他当作校验Name的参数

  result是data数据执行After脚本之后的结果,然后我们将最终的结果返回到界面

  测试Demo的提供:

using System.Collections.Generic;

namespace Demo.CSharpScript.Models
{
    /// <summary>
    /// 测试实体
    /// </summary>
    public class DemoModel
    {
        public int ID { get; set; }
        public int Age { get; set; }
        public string Name { get; set; }
        public string Desc { get; set; }

        /// <summary>
        /// 测试数据
        /// </summary>
        /// <returns></returns>
        public static List<DemoModel> GetDemoDatas()
        {
            var list = new List<DemoModel>();
            for (int i = 0; i < 100; i++)
            {
                list.Add(new DemoModel { ID = i, Age = i, Name = $"7tiny_{i}", Desc = $"第{i}条测试数据" });
            }
            return list;
        }
    }
}

  下面我们来看看两处执行脚本的地方

  首先是Before处理逻辑:

  使用Roslyn脚本化C#代码,C#动态脚本实现方案第6张

  拼接了一个脚本(中间部分从文件读取),使用Roslyn API进行动态编译执行,然后将执行的结果返回

  然后是After处理逻辑:

  使用Roslyn脚本化C#代码,C#动态脚本实现方案第7张

  同样是拼接了一个脚本(中间部分从文件读取),使用Roslyn API进行动态编译执行,然后将执行的结果返回

  在上述过程中还将多个命名空间引入,以便在After脚本中写Linq语法,否则会执行失败,出现异常

  语法我们在上述章节都已经演示过了

  实际我们的脚本:

  使用Roslyn脚本化C#代码,C#动态脚本实现方案第8张

  before中直接忽略了参数返回了字符串“1”,然后我们Action代码首先过滤的数据就剩下Name字段包含“1”的

  after中再次使用Where语法,过滤剩下数据中Name字段包含“3”的

  那么,我们的结果中只剩下两条符合条件:

  使用Roslyn脚本化C#代码,C#动态脚本实现方案第9张

  拓展一下

  使用Roslyn脚本化C#代码,C#动态脚本实现方案第10张

  我们的测试到此本也结束了,但是为了我们测试脚本更加方便,我这里提供了一个微软刚出的工具,try.dot.net

  不了解的同学可以参考之前博文熟悉一下 try.dot.net :https://www.cnblogs.com/7tiny/p/10277600.html

  我们可以在测试站点上点“点我帮助你写脚本”的菜单:

  使用Roslyn脚本化C#代码,C#动态脚本实现方案第11张

  然后进入try.dot.net的界面:

  使用Roslyn脚本化C#代码,C#动态脚本实现方案第12张

  在这里我们可以使用智能提示编写脚本,写完后粘贴回测试的页面,避免文本框写代码出现错误

三、开拓视野

  我们今天用的是 Roslyn,事实上,微软有很多类库可以帮助我们执行动态脚本代码,例如:

  CodeDom(动态生成或编译代码)

  ClearScript(执行javascript脚本和CSharp代码)  https://microsoft.github.io/ClearScript/Examples/Examples.html

  PhpNet(执行Php代码)

  JavaDynamicCompiler(执行Java代码)

  IronPython

  ...

  有兴趣可以去搜索拓展一下!谢谢~

  最后,本文Demo 源码地址:https://github.com/sevenTiny/Demo.CSharpScript

免责声明:文章转载自《使用Roslyn脚本化C#代码,C#动态脚本实现方案》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇Python绘制正余弦函数图像的方法js object 常用方法总结下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

GIT使用log命令显示中文乱码

背静: 公司项目使用GIT进行代码同步。 问题: 之前代码提交后,有中文备注,但是在使用git log查看代码历史记录的时候发现显示乱码,如下: 后查询相关资料,现将解决办法总结如下: 1、运行Git Bash窗口,在该窗口导航条(即最上面)右键,选择Options−>Text,找到下面两处  Locale:选择 zh_CN   Charector...

LINUX 上 实现SNTP (时间同步)

Network Time Protocol (NTP) 也是RHCE新增的考试要求. 学习的时候也顺便复习了一下如何设置Linux的时间,现在拿出来和大家分享 设置NTP服务器不难但是NTP本身是一个很复杂的协议. 这里只是简要地介绍一下实践方法和上次一样,下面的实验都在RHEL5上运行  https://bbs.csdn.net/topics/33019...

SpringMVC拦截器详解

拦截器是每个Web框架必备的功能,也是个老生常谈的主题了。 本文将分析SpringMVC的拦截器功能是如何设计的,让读者了解该功能设计的原理。 重要接口及类介绍1. HandlerExecutionChain类   由HandlerMethod和Interceptor集合组成的类,会被HandlerMapping接口的getHandler方法获取。 2....

IDEA中设置注释模板的方法

  IDEA中设置注释模板主要分为两个部分,分别是创建java文件时类的注释和方法的注释。   这里为大家详细介绍一下方法,按MyEclipse的风格设置(MyEclipse的请看:MyEclipse中设置注释模板的方法),大家可以根据自己的习惯生成自己喜欢的注释模板。效果如下:   一、设置类的注释模板 1、选择File→Settings→Editor→...

Android中的数据存储

Android中的数据存储主要分为三种基本方法:   1.利用shared preferences存储一些轻量级的键值对数据。   2.传统文件系统。   3.利用SQLite的数据库管理系统。   对SharedPreferences对象和SQLite数据库,它们的数据仅对创建它们的应用是可访问的。   (比如,MODE_WORLD_READABLE 和...

漂亮的无序列表样式

时间如流水,只能流去不流回! 点赞再看,养成习惯,这是您给我创作的动力! 本文 Dotnet9 https://dotnet9.com 已收录,站长乐于分享dotnet相关技术,比如Winform、WPF、ASP.NET Core等,亦有C++桌面相关的Qt Quick和Qt Widgets等,只分享自己熟悉的、自己会的。 阅读导航: 一、先看效果...