Metalama 1.0 / / Metalama Documentation / Conceptual Documentation / Migrating from Post­Sharp / Architectural Differences from Post­Sharp

Differences Between Metalama and PostSharp

This article covers the major architectural differences between Metalama and PostSharp in a rather theoretical style. You can probably skip it on first reading.

Metalama is a compiler add-in

A major difference between Metalama and PostSharp is that while PostSharp is a post-compiler, i.e. a process that runs after the compiler and post-processes the output of the compiler, Metalama is a compiler add-in, and gets executed both at design- and at compile-time.

So how does Metalama execute aspects? Metalama creates a sub-project from your main project, and this sub-project contains only compile-time code, e.g. aspects, fabrics, and their dependencies. Only this sub-project is compiled and executed at design- or compile-time.

While PostSharp loads the whole project (compiled as an assembly) in the .NET runtime, Metalama only loads the sub-project that contains compile-time code.


PostSharp Architecture

flowchart LR IDE --> Compiler --> input_dll>binary] --> PostSharp --> output_dll>Binary With Aspects] --> Execute subgraph design-time IDE end subgraph compile-time Compiler PostSharp input_dll end subgraph run-time Execute end

Metalama Architecture

flowchart LR Compiler <--> Metalama IDE <--> Metalama2 IDE --> Compiler --> output_dll>Binary With Aspects] --> Execute Metalama <--> compiledAspects>Compiled Aspects] <--> Metalama2 subgraph compile-time Compiler Metalama[Compile-Time\nMetalama] end subgraph design-time IDE Metalama2[Design-Time\nMetalama] end subgraph run-time Execute end

Metalama aspects are compile-time-only

In PostSharp, aspect classes are instantiated at compile time, serialized and stored as a managed resource in the assembly being built, then deserialized at run time, and executed. Therefore, in PostSharp, some aspect code is executed at compile time, and some is executed at run time.

In Metalama, aspects are never executed at run time. Aspects provide code templates, and templates are expanded at compile time. Templates generate C# code, and only this generated code is executed at run time.


Aspect lifetime in PostSharp

flowchart LR instantiated[aspect instantiated] --> executed[aspect executed] --> serialized[aspect serialized] --> deserialized[aspect deserialized] --> runTimeExecuted[aspect executed] executed -->|generates| code>code advised\nwith aspect bindings] code --> deserialized subgraph compile-time instantiated executed[executed] serialized end subgraph run-time code deserialized runTimeExecuted end

Aspect lifetime in Metalama

flowchart LR instantiated --> executed -->|generates| code>code advised\nwith inlined templates] subgraph compile-time instantiated executed end subgraph run-time code end


The difference in aspect lifetime has major implications for the way aspects are designed.

  • Metalama templates should generate succinct code. In PostSharp, advice methods could be long and complex because they were actually independent C# methods, compiled and JIT-compiled just one, and executed at run time. However, in Metalama, advice methods are templates. They can be long, but it is important that the code they are generating is short. This code will need to be compiled and JIT-compiled as many times as the advice is applied, so potentially thousands of times. Any logic that may repeat itself should be moved into run-time helper classes.

  • Aspects can no longer "hold" run-time state. In PostSharp, aspect fields could hold any run-time state required by the aspect. In Metalama, if an aspect needs a run-time state, it has to introduce a field into the target class (see Introducing Members for details).

Aspect instances in Metalama can be shared by several declarations

Some aspects are applied to a declaration in a project but affect other projects that reference the main project (as a project or as a package). For instance, an aspect may be applied to a base class in a project. If this aspect is inheritable, it will also be automatically applied to all classes that derive from this base class. For details, see Aspect Inheritance.

The way how inheritance is implemented differs between Metalama and PostSharp.

In PostSharp, each inherited aspect instance is instantiated again from the custom attribute from which it stems (i.e. to be exact, it is deserialized from the custom attribute). This mechanism for intra-project inheritance as well as for cross-project inheritance.

In Metalama, the mechanism is different inside a project than across projects.

Inside a project, the same aspect instance is shared among all declarations that inherit this aspect. This is why aspect classes should be written in an immutable style.

For cross-project inheritance or validators, inheritable aspect instances are serialized and stored as a managed resource using the Metalama.Framework.Serialization namespace into the assembly being built. In child projects, one new aspect instance is created by deserializing the serialized aspect of the base declaration, and this deserialized instance is then shared by all derived declarations inheriting the aspect.


Cross-project aspects in PostSharp

flowchart LR subgraph BaseAssembly subgraph BaseClass BaseAspect CustomAttribute[Aspect Custom Attribute] BaseAspect -->|instantiated from| CustomAttribute end subgraph DerivedClass1 DerivedAspect1 end DerivedClass1 -->|inherited from| BaseClass DerivedAspect1 -->|instantiated from| CustomAttribute end subgraph DependentAssembly subgraph DerivedClass2 DerivedAspect2 end subgraph DerivedClass3 DerivedAspect3 end DerivedAspect2 --> |instantiated from| CustomAttribute DerivedAspect3 --> |instantiated from| CustomAttribute end DependentAssembly --> BaseAssembly

Cross-project aspects in Metalama

flowchart LR subgraph BaseAssembly subgraph BaseClass BaseAspect CustomAttribute[Custom Attribute] BaseAspect -->|instantiated from| CustomAttribute end subgraph DerivedClass1 DerivedAspect1 end subgraph ManagedResource BaseAspect -->|serialized into| SerializedAspect(Serialized\nAspect) end DerivedAspect1 -->|reuses| BaseAspect end subgraph DependentAssembly subgraph Shared DeserializedAspect[Deserialized\nAspect] -->|deserialized from| SerializedAspect end subgraph DerivedClass2 DerivedAspect2 --> |reuses| DeserializedAspect end subgraph DerivedClass3 DerivedAspect3 --> |reuses| DeserializedAspect end end DependentAssembly --> BaseAssembly


  • In Metalama, aspect classes must be written in an immutable style. Since aspect instances are may be reused among several declarations, they cannot store state that is specific to a target declaration. For details, see Sharing State with Advice.