Prism Framework

This framework provides a generator to generate proxy class which can override non-final virtual methods of base classes in run-time.

The generator is implemented with dynamic IL weaving via System.Reflection.Emit library. It is designed in plugin model, which allows users to easily extend its function.

How It Works

The proxy generator use Emit to generate dynamic class which is inherited from the class to proxy, so virtual methods will be override thus their behaviors can be modified.

Concepts

Generator

A proxy generator is modular class generator based on static-IL-weaving with System.Reflection.Emit. You write your own plugins to customize the generated proxy class, such as adding codes to proxied methods and implementing more interfaces, etc.

ClassContext

A class context describe the class to proxy. It contains the dynamic class builder for the generator to use, and method contexts.

Class contexts are the basic unit for plugin to process. Plugins can do the most jobs with the dynamic class builder.

Initializer method is a special method which will be invoked by all constructors. Thus, you can write your initializing behavior in this method rather than every constructor.

MethodContext

Method contexts are used to shared method data among different plugins. Plugins can add code with delegates which will emit IL code with the ILGenerator. Those delegates will be invoked in sequence to generate the proxy method.

There are 3 stages of a method generation procedure:

1. Before Invoking.
2. Invoking the proxied method.
3. After Invoking.

The 2nd stage is the code which will invoke the proxied method directly. A code context has many properties or fields to control or describe this behavior, for example, the local variable which stores the return value of the proxied method.

CodeContext

Code contexts contains many fields or properties associated with the method code generation procedure. You can use Skipped filed in the before-invoking stage to skip the invocation of the proxied method, or to set the return value of the invocation of the generated method, or, passing values between delegates in different stages with dictionary.