开源库满足于个人,而完善于大众。
Natasha 自稳定版发布之后,众多老铁参与增强改进,感谢如下老铁的反馈:
1. 异常搜集
在 wenjq0911 建议下,添加了异常捕获,现 Natasha 的编译器已支持 Exception 字段,它将在整个编译周期中搜集异常。
var fastBuilder = FastMethodOperator.New;
fastBuilder.Complier.Exception; //编译后异常会进入这里
var fakeBuilder = FakeMethodOpeartor.New;
fakeBuilder.Complier.Exception;
var oopBuilder = new OopOperator();
oopBuilder.Complier.Exception;
if(Builder.Complier.Exception.ErrorFlag == ComplieError.None)
{
//编译成功!
}
UT地址:https://github.com/dotnetcore/Natasha/blob/master/test/NatashaUT/ExceptionTest.cs
2. Web环境
另外 wenjq0911 提供了 web 环境的运行信息,根据排查和调研,Natasha 现采用 AspNetCore 的 refs 子文件夹方式提供 web 应用程序的引用,配置文件内容已在 ReadMe 中更改。
Exe
netcoreapp2.2
// 一定要加上这句话
true
// WEB发布加
false
3. 异步方法
在 Jello 的建议下,增加了异步方法的反解还原,并在 FastMethodOperator 中支持 UseAsync/AsyncFrom 等异步来源方法。
public static async void RunAsyncDelegate2()
{
var delegateAction = FastMethodOperator.New
.UseAsync()
.Param("str1")
.Param("str2")
.MethodBody(@"
await Task.Delay(1000);
string result = str1 +"" ""+ str2;
Console.WriteLine(result);
return result;"
.Return>()
.Complie();
string result = await ((Func>)delegateAction)?.Invoke("Hello", "World1!");
Assert.Equal("Hello World1!", result);
}
UT地址:https://github.com/dotnetcore/Natasha/blob/master/test/NatashaUT/AsyncMethoddTest.cs
4. 智能方法
Wayne 和 Dennis 在异步的基础上给出了体验优化的建议,Natasha 的Complier 函数目前支持方法参数及返回值的智能解析:
在不指定参数的情况下默认使用 TDelegate 的参数;
在不指定返回值的情况下,默认使用 TDelegate 的返回类型;
var delegateAction = FastMethodOperator.New
.UseAsync()
.MethodBody(@"
string result = arg1 +"" ""+ arg2;
Console.WriteLine(result);
return result;")
.Complie>>();
string result =await delegateAction?.Invoke("Hello", "World2!");
Assert.Equal("Hello World2!", result);
UT地址:https://github.com/dotnetcore/Natasha/blob/master/test/NatashaUT/AsyncMethoddTest.cs
5. 外部文件与运行时脚本混合编译
在 Teng 的建议下,增加了外部文件和运行时脚本混合编译的功能。使用 LoadFile方法将外部 Dll 文件引入运行时,并添加到编译列表中。LoadFile 方法是在IComplier 抽象编译器中实现的,所以,只要 Builder 类实现了编译器,都将拥有此方法。
using System;
namespace ClassLibrary1
{
public class Class1
{
public void Show1()
{
Console.WriteLine("RunShow1");
}
public static void Show2()
{
Console.WriteLine("RunShow2");
}
}
}
string text = @"
using System;
using System.Text;
using ClassLibrary1;
namespace HelloWorld
{
public class Test
{
public override string ToString()
{
Class1 a = new Class1();
a.Show1();
Class1.Show2();
return ""11"";
}
}
}";
//Class1 来自于 ClassLibrary1.dll
OopComplier oop = new OopComplier(); //OopComplier在2.0中移除
oop.LoadFile(@"D:\Project\IlTest\ClassLibrary1\bin\Debug\netstandard2.0\ClassLibrary1.dll");
Type type = oop.GetClassType(text);
//调用
var a = Activator.CreateInstance(type);
Console.WriteLine(a.ToString());
(2.0版本引擎升级后会将此方法包装进程序集域的操作类中)
6. 继承、重写与实现
allmyfantasy 建议下,完善了类、接口、抽象类、虚方法的实现。
ProxyOperator builder = new ProxyOperator();
builder.OopName("InterfaceClass");
builder["InterfaceMethod"] = "return 123456;"; // public method
builder.Compile();
var test = builder.Create("InterfaceClass");
ProxyOperator builder = new ProxyOperator();
builder.OopName("TestClass");
builder["NormalMethod"] = "return 123456;"; //new method
builder["VirtualMethod"] = "return 123456;"; //override method
builder.Compile();
dynamic test = Activator.CreateInstance(builder.TargetType);
ProxyOperator builder = new ProxyOperator();
builder.OopName("AbstractClass");
builder["AbstractMethod"] = "return 123456;"; //overrider method
builder.Compile();
var test = builder.Create("AbstractClass");
UT地址:https://github.com/dotnetcore/Natasha/blob/master/test/NatashaUT/ProxyTest.cs
7. 添加包装类
guodf、Teng、WeihanLi 的建议下,添加包装类提升使用体验。
var result = NewClass.Create(Action action);
var result = NewInterface.Create(Action action);
var result = NewStruct.Create(Action action);
var type = result.Type;
var error = result.Exception;
var result = NewMethod.Create(Action action);
var error = result.Exception;
var method = result.Method;
method();
8. 支持非安全方法
根据 FUTURE* 的需求,支持了非安全方法的编译,现可以使用 UseUnsafe 方法来实现。
9. 快速实现动态功能
增加了 NFunc/NAction 两种快速实现委托的操作类。
//NFunc 和 NAction 支持的方法:
// 普通方法:Delegate
// 异步方法:AsyncDelegate
// 非安全方法:UnsafeDelegate
// 非安全异步方法:UnsafeAsyncDelegate
var action = NFunc>.UnsafeAsyncDelegate(@"
string result = arg1 +"" ""+ arg2;
Console.WriteLine(result);
return result;");
string result = await action("Hello", "World1!");
//result = "Hello World1!"
10. 枚举类型构建与编译
var script = new OopOperator()
.HiddenNameSpace().ChangeToEnum()
.OopAccess(AccessTypes.Public).OopName("EnumUT1")
.EnumField("Apple")
.EnumField("Orange",2)
.EnumField("Banana")
.Builder().Script;
/* result:
public enum EnumUT1{
Apple,
Orange=2,
Banana}*/
(2.0版本将在此基础上增加封装类)
11. 日志加深一级
\netcoreapp2.2\log\2019\08月19日\17时39分
(2.0版本将进行优化和改动)
鸣谢贡献者:
感谢 WeihanLi 帮忙做了 CodeReview 的工作。
感谢 Teng 帮忙做了 WikiReview 的工作。
Natasha2.0 将兼容 Core3.0 版本,除升级优化引擎之外还将支持隔离编译与卸载功能。后续还会跟随合理需求进行升级维护, 感谢各位的支持和鼓励。
欢迎访问主页并扫码进入 Natasha 生态群:https://github.com/dotnetcore/Natasha
孵化组正在进行的项目:DeepClone/NMapper/NCaller