Natasha

Natasha 3.0+ 抽象了引擎结构，分离出了框架以及各个模块。

各模块的标准封装在 Natasha.Framework 中：

• DomainBase: 继承自 AssemblyLoadContext 类，完成了部分域功能及部分抽象标准。

  • AssemblyReferences ： 编译需要的引用库，该字段以程序集/引用字典的形式储存了程序集对应的引用。
  • GetInstance ： 该方法需要重载，以便于 DomainManagement 类的 Create 操作， 需要返回你当前类的实例，需要重载。
  • Default_Resolving ： 在系统域加载时触发的方法，需要重载。
  • Default_ResolvingUnmanagedDll ： 在系统域加载非安代码时触发的方法，需要重载。
  • CompileStreamHandler ： 当以流的方式成功编译时触发的方法，需要重载。
  • CompileFileHandler : 当以文件的方式成功编译时触发的方法，需要重载。

  • Remove ： 删除引用时触发的方法，需要重载。

  • AddDeps ： 该方法默认实现通过文件路径添加依赖，3.0+ 将解析deps.json, 2.0+ 将只添加单个文件。
  • AddReferencesFromFolder ： 从一个文件夹中添加引用库，可重载。
  • AddReferencesFromDepsJsonFile ： 从 deps.json 文件中解析引用库，可重载。
  • AddReferencesFromDllFile ： 从单个 dll 文件中获取引用库，可重载。
  • LoadPluginFromFile ： 默认实现，加载插件调用 AddDeps 方法加载引用依赖，调用 GetAssemblyFromFile 从文件加载程序集到域，可重载。
  • LoadPluginFromStream ： 默认实现，加载插件调用 AddDeps 方法加载引用依赖，调用 GetAssemblyFromStream 从流加载程序集到域，可重载。
  • GetAssemblyFromStream ： 默认实现，区分了系统域和自定义域，从流中加载程序集到域，可重载。
  • GetAssemblyFromFile ： 默认实现，区分了系统域和自定义域，从文件中加载程序集到域，可重载。
  • GetDefaultReferences ： 该方法返回一个系统域的所有引用，可重载。
  • GetCompileReferences ： 该方法返回了系统域及非系统域组合的引用， 可重载。
  • LoadPluginFromFile ： 当插件以文件方式加载时触发的方法，可重载。
  • LoadPluginFromStream ： 当插件以流方式加载时触发的方法，可重载。

• SyntaxBase: 作为语法转换的基础类，提供了代码及语法树缓存，规定了一些抽象方法，实现了自动添加缓存的方法。

  • TreeCache ： 存放字符串代码及语法树的缓存。
  • LoadTree / LoadTreeFromScript ： 每个语言都有自己的转换方法，但最终需要返回 SyntaxTree ,当您继承该类时，需要实现该方法，返回对应语言的语法树，需要重载。
  • AddTreeToCache ： 该方法会自动将对应语言的代码及语法树缓存起来，可重载。

• CompilerBase<TCompilation, TCompilationOptions> where TCompilation : Compilation where TCompilationOptions : CompilationOptions: 编译器抽象， TCompilation 被约束为 Compilation 类型，该类为编译的基础类，在构建编译信息时，每种语言都会对该类进行继承改造，因此它是编译基础。TCompilationOptions 被约束为 CompilationOptions 类型, 改类为构建编译信息的选项类，在构建编译信息时，

  • AssemblyName : 编译器会对当前代码进行整程序集编译，需要指定程序集名。
  • AssemblyResult : 编译结果。
  • AssemblyOutputKind ：Assembly 输出的方式，编译到文件 file / 编译到流 stream。
  • Domain : 该属性承载了 DomainBase 实例。
  • PreComplier ： 该方法在编译前执行，如果返回 false 将阻止编译， 可重写。
  • CompileToFile ： 该方法实现了将以上信息编译到文件的功能，可重写。
  • CompileToStream : 该方法实现了将以上信息编译到流的功能，可重写。
  • Compile ：该方法实现了根据输出方式（AssemblyOutputKind）进行自动编译，file 调用 CompileToFile 方法， stream 调用 CompileToStream 方法。

  • CompileTrees ： 需要被编译的语法树。

  • GetCompilationOptions ：返回编译选项，必须重写。
  • AddOption ：选项设置方法，在获取到 CompilationOptions 之后对其进行自定义操作。

  • GetCompilation ：根据拿到的 CompilationOptions 返回不同语言的编译信息集，必须重写。

  • CompileEmitToFile： 将 compilation 编译到文件，必须重新写。

  • CompileEmitToStream: 将 compilation 编译到内存流，必须重写。

  • FileCompileSucceedHandler ： 当文件形式编译成功之后引发的事件。

  • StreamCompileSucceedHandler ：当流形式编译成功之后引发的事件。

  • FileCompileFailedHandler ： 当文件形式编译失败之后引发的事件。
  • StreamCompileFailedHandler ： 当流形式编译失败之后引发的事件。

对以上类进行重写，即可完成一门语言的动态编译，详情请看 Engine 实现篇。

This site is open source. Improve this page.