aop 0.9.0

aop framework for dart - aka, the final transformer

TRIVIAL AOP framework for Dart

A very simple AOP framework for Dart.

Premise

Dart has transformers. They're used for several different purposes but one of the most common is to inject code. AOP should be a better framework for doing this kind of things.

Usage

Declare your aspect anywhere in your code, for example:

import "package:aop/aop.dart";

@aspect    
class MySampleAspect {

 @Pointcut(const AnnotationMatches("pippo"))
 executeAround(InvokationContext context, Function proceed) {
  print("BEFORE (myAspect)");
  var res = proceed();
  print("AFTER (myAspect)");
  return res;
 }
}

This defines an aspect that will print a message before and after execution of any method in your code that is annotated with @pippo.

An aspect is just a class annotated with @aspect.

Pointcut are defined using the annotation @Pointcut. The annotation constructor argument is a const expression that defines the pointcut.

At the moment the expression is limited to:

• NameMatches to match the method name (using a regexp)
• AnnotationMatches to match an annotation of the method
• And, Or, Not try to guess ?

Also you can only write around pointcut for method.

the transformer

To inject pointcut executions a trasformer need to be added to your pubspec configuration. The trasformer needs a list of entry_points to be configured. It uses initialize so if used with polymer there's nothing else to do, otherwise you have to add initialize trasformer too.

For example:

transformers:
 - aop:
    entry_points: web/index.dart
 - polymer:
    entry_points: web/index.html

entry point

The main entry point needs to call initialize run method to get the aop framework properly initialized, for example:

main() async {
  await run();

  await initPolymer();
}

next step

More expressions (for example class selector, annotation on classes). Aspect lifecycle and scope. Support for property. Support for mixin injection.