using Solti.Utils.Proxy;
...
public class MyInterceptor: InterfaceInterceptor<IMyInterface>
{
public MyInterceptor(IMyInterface target) : base(target){} // Nothing to do here
public override object? Invoke(InvocationContext context) // Invoking the generated proxy instance will trigger this method
{
if (suppressOriginalMethod)
{
return something;
// ref|out parameters can be assigned by setting the corresponding "context.Args[]" item
}
context.Args[0] = someNewVal; // "someNewVal" will be forwarded to the original method
return base.Invoke(context); // Let the original method do its work
}
}
Generate the proxy type:
using Solti.Utils.Proxy.Generators;
...
// The returned type
// 1) is assembled only once
// 2) "inherits" all the public constructors from "MyInterceptor"
Type proxyType = ProxyGenerator<IMyInterface, MyInterceptor>.GetGeneratedType(); // or GetGeneratedTypeAsync()
Activate the proxy:
using System;
...
IMyInterface target = new MyClass();
...
IMyInterface proxy = (IMyInterface) Activator.CreateInstance(proxyType, new object[]{target});
Enjoy
Note that the target can access its most outer enclosing proxy. To achieve this, it just has to implement the IProxyAccess<IMyInterface> interface:
using Solti.Utils.Proxy;
public class MyClass : IMyInterface, IProxyAccess<IMyInterface>
{
...
public IMyInterface Proxy { get; set; }
}
Declare an interface that covers the desired members of the target class:
public class TargetClass // does not implement IDuck
{
public void Foo(){...}
}
...
public interface IDuck
{
void Foo();
}
Generate the duck type:
using Solti.Utils.Proxy.Generators;
...
// The returned type:
// 1) is assembled only once
// 2) has only one public constructor with the following layout: "Ctor(TargetClass target)"
Type duckType = DuckGenerator<IDuck, TargetClass>.GetGeneratedType(); // or GetGeneratedTypeAsync()
Quack:
using System;
...
TargetClass target = ...;
...
IDuck duck = (IDuck) Activator.CreateInstance(duckType, new object[]{target});
By setting the ProxyGen.AssemblyCacheDir property in YourApp.runtimeconfig.json you can make the system cache the generated assembly, so next time your app starts and requests the proxy there won't be time consuming emitting operation.
You can do it easily by creating a template file named runtimeconfig.template.json in your project folder:
This library can be used as a source generator so you can embed the generated proxy type into the assembly that uses it. This is simply done by the Solti.Utils.Proxy.Attributes.EmbedGeneratedTypeAttribute:
The xXxGenerator.GetGeneratedType() method returns the embedded type if it presents in the assembly in which the GetGeneratedType() was called. Since all the time consumig operations already happened in compile time, requesting embedded types can singificantly improve the performance.
Note that:
Open generics are not supported.
coveralls.io (and other coverage reporters) may crash if your project was augmented by a source generator. To work this issue around:
Ignore the generated sources in your coverage app (e.g.: in OpenCover use the -filter:-[*]Proxies.GeneratedClass_* switch)
Create an empty file for each generated class (e.g.: YourProject\Solti.Utils.Proxy\Solti.Utils.Proxy.Internals.ProxyEmbedder\Proxies.GeneratedClass_XxX.cs)
Delete all the cached assemblies (if the [Proxy|Duck]Generator.CacheDirectory is set somewhere)
InterfaceInterceptor.Invoke() returns the result of the original method (instead of CALL_TARGET) so in the override you may never need to invoke the method parameter directly.
3.X
[Proxy|Duck]Generator.GeneratedType[Async] property has been removed. To get the generated proxy type call the [Proxy|Duck]Generator.GetGeneratedType[Async]() method.
[Proxy|Duck]Generator.CacheDirectory property has been removed. To set the cache directory tweak the runtimeconfig.json file.
4.X
The layout of the InterfaceInterceptor<>.Invoke() has been changed. Invocation parameters can be grabbed from the InvocationContext passed to the Invoke() method.
The ConcurrentInterfaceInterceptor<> class has been dropped since the InterfaceInterceptor<> class was rewritten in a thread safe manner.
