Juxtapose 1.0.0-dev-014

Juxtapose

1. Intro

基于 SourceGenerator 的硬编码 .Net 多进程运行库。

2. Features

• 可以为接口和静态类生成代理，无需手动编写RPC相关代码，即可进行多进程开发；
• 编译时生成所有代码，运行时无显式的反射调用和动态构造；
• 支持委托和CancellationToken类型的方法参数（其余类型未特殊处理，将会进行序列化，目前回调委托不支持嵌套和CancellationToken）；
• 支持Linux、Windows（其它未测试）；

3. Requirement

• .Net5.0+(其它版本没有尝试过)

4. 使用方法

4.1 引用包

<ItemGroup>
  <PackageReference Include="Juxtapose" Version="1.0.*-*" />
  <PackageReference Include="Juxtapose.SourceGenerator" Version="1.0.*-*" />
</ItemGroup>

4.2 建立上下文

[IllusionClass(typeof(Greeter), typeof(IGreeter), "Juxtapose.Test.GreeterAsIGreeterIllusion")]
public partial class GreeterJuxtaposeContext : JuxtaposeContext
{
}

示例代码将为Greeter生成IGreeter接口的代理类型Juxtapose.Test.GreeterAsIGreeterIllusion；

Note!!!

• 必须继承JuxtaposeContext；
• 必须标记partial关键字；

4.3 添加入口点

在Main方法中添加入口点代码，并使用指定上下文

await JuxtaposeEntryPoint.TryAsEndpointAsync(args, GreeterJuxtaposeContext.SharedInstance);

到此已完成开发，创建类型Juxtapose.Test.GreeterAsIGreeterIllusion的对象，并调用其方法，其实际逻辑将在子进程中运行；

5. 工作逻辑

SourceGenerator在编译时生成代理类型，封装通信消息。默认使用命名管道进行进程间通信，使用System.Text.Json进行消息的序列化与反序列化。

参见示例，未完待续......