Creating a dynamic proxy generator – Part 1 – Creating
the Assembly builder, Module builder and caching mechanism
For
the latest code go to http://rapidioc.codeplex.com/
Before getting too involved in generating
the proxy, I thought it would be worth while going through
the intended design, this is important as
the next step is to start creating
the constructors for
the proxy.
Each proxy derives from a specified type
The proxy has a corresponding constructor for each of
the base type constructors
The proxy has overrides for all methods and properties marked as Virtual on
the base type
For each overridden method, there is also a private method whose sole job is to call
the base method.
For each overridden method, a delegate is created whose sole job is to call
the private method that calls
the base method.
The following class diagram shows
the main classes and interfaces involved in
the interception process.
I’ll go through each of them to explain their place in
the overall proxy.
IProxy Interface
The proxy implements
the IProxy interface for
the sole purpose of adding custom interceptors.
This allows
the created proxy interface to be cast as an IProxy and then simply add Interceptors by calling it’s AddInterceptor method.
This is done internally within
the proxy building process so
the consumer of
the API doesn’t need knowledge of this.
IInterceptor Interface
The IInterceptor interface has one method: Handle.
The handle method accepts a IMethodInvocation parameter which contains methods and data for handling method interception.
Multiple classes that implement this interface can be added to
the proxy.
Each method override in
the proxy calls
the handle method rather than simply calling
the base method.
How
the proxy fully works will be explained in
the next section MethodInvocation.
IMethodInvocation Interface & MethodInvocation class
The MethodInvocation will contain one main method and multiple helper properties.
Continue Method
The method Continue() has two functions hidden away from
the consumer.
When Continue is called, if there are multiple Interceptors,
the next Interceptors Handle method is called.
If all Interceptors Handle methods have been called,
the Continue method then calls
the base class method.
Properties
The MethodInvocation will contain multiple helper properties including at least
the following:
Method Name (Read Only)
Method Arguments (Read and Write)
Method Argument Types (Read Only)
Method Result (Read and Write) – this property remains null if
the method return type is void
Target Object (Read Only)
Return Type (Read Only)
DefaultInterceptor class
The DefaultInterceptor class is a simple class that implements
the IInterceptor interface.
Here is
the code:
DefaultInterceptor
namespace Rapid.DynamicProxy.Interception
{
/// <summary>
/// Default interceptor for
the proxy.
/// </summary>
/// <typeparam name="TBase">The base type.</typeparam>
public class DefaultInterceptor<TBase> : IInterceptor<TBase> where TBase : class
{
/// <summary>
/// Handles
the specified method invocation.
/// </summary>
/// <param name="methodInvocation">The method invocation.</param>
public void Handle(IMethodInvocation<TBase> methodInvocation)
{
methodInvocation.Continue();
}
}
}
This is automatically created in
the proxy and is
the first interceptor that each method override calls.
It’s sole function is to ensure that if no interceptors have been added,
the base method is still called.
Custom Interceptor Example
A
consumer of
the Rapid.DynamicProxy API could create an interceptor for logging when
the FirstName property of
the User class is set.
Just for illustration, I have also wrapped a transaction around
the methodInvocation.Coninue() method.
This means that any overriden methods within
the user class will run within a transaction scope.
MyInterceptor
public class MyInterceptor : IInterceptor<User<int, IRepository>>
{
public void Handle(IMethodInvocation<User<int, IRepository>> methodInvocation)
{
if (methodInvocation.Name == "set_FirstName")
{
Logger.Log("First name seting to: " + methodInvocation.Arguments[0]);
}
using (TransactionScope scope = new TransactionScope())
{
methodInvocation.Continue();
}
if (methodInvocation.Name == "set_FirstName")
{
Logger.Log("First name has been set to: " + methodInvocation.Arguments[0]);
}
}
}
Overridden Method Example
To show a taster of what
the overridden methods on
the proxy would look like,
the setter method for
the property FirstName used in
the above example would look something similar to
the following (this is not real code but will look similar):
set_FirstName
public override void set_FirstName(string value)
{
set_FirstNameBaseMethodDelegate callBase =
new set_FirstNameBaseMethodDelegate(this.set_FirstNameProxyGetBaseMethod);
object[] arguments = new object[] { value };
IMethodInvocation<User<IRepository>> methodInvocation =
new MethodInvocation<User<IRepository>>(this, callBase, "set_FirstName", arguments, interceptors);
this.Interceptors[0].Handle(methodInvocation);
}
As you can see, a delegate instance is created which calls to a private method on
the class,
the private method calls
the base method and would look like
the following:
calls base setter
private void set_FirstNameProxyGetBaseMethod(string value)
{
base.set_FirstName(value);
}
The delegate is invoked when methodInvocation.Continue() is called within an interceptor.
The set_FirstName parameters are loaded into an object array.
The current instance, delegate, method name and method arguments are passed into
the methodInvocation constructor (there will be more data not illustrated here passed in when created including method info, return types, argument types etc.)
The DefaultInterceptor’s Handle method is called with
the methodInvocation instance as it’s parameter.
Obviously methods can have return values, ref and out parameters etc. in these cases
the generated method override body will be slightly different from above. I’ll go into more detail on these aspects as we build them.
Conclusion
I hope this has been useful, I can’t guarantee that
the proxy will look exactly like
the above, but at
the moment, this is pretty much what I intend to do.
Always worth downloading
the code at http://rapidioc.codeplex.com/ to see
the latest.
There will also be some tests that you can debug through to help see what’s going on.
Cheers,
Sean.
