6.x
Intro
Advanced Topics
Extending WireBox
Aspect Binding
Since we have now mapped our aspect in WireBox, we now need to tell it the most important things:
- 1.To what classes or CFCs should we apply this aspect to?
- 2.To what methods or join points should we apply this aspect to?
We do this with another binder DSL method:
bindAspect(classes,methods,aspects)
1
bindAspect(classes=match().mappings('UserService'),methods=match().methods('save'),aspects="MethodLogger");
Copied!
What is up with that funky
match().... stuff? Well, the classes and methods arguments of the bindAspect() call uses our AOP funky matcher methods that exist in an object called: wirebox.system.aop.Matcher. This matcher object is used to match classes and methods to whatever criteria you like. The binder has a convenience method called match() that creates a new matcher object for you and returns it so you can configure it for classes and method matching. Here are the most common matching methods below:Method
Class Matching
Method Matching
Description
any()
true
true
Matches against any class path or method name
returns(type)
false
true
Matches against the return type of methods
annotatedWith(annotation,[value])
true
true
Matches against the finding of an annotation in a cfcomponent or cffuntion or matches against the finding AND value of the annotation.
mappings(mappings)
true
false
Matches to ONLY the named mapping(s) you pass to this method as a list or array.
instanceOf(classPath)
true
false
Matches if the target object is an instance of the classPath. This internally uses the ColdFusion isInstanceOf() method
regex(regex)
true
true
Matches against a CFC instantiation path or function name using regular expressions
methods(methods)
false
true
Matches against a list of explicit method names as a list or array
andMatch(matcher)
true
true
Does an AND evaluation with the current matcher and the one you pass in the method.
orMatch(matcher)
true
true
Does an OR evaluation with the current matcher and the one you pass in the method.
WOW! We can really pin point anything in our system! So now that we have binded our aspect to our UserService I can rewrite it to this:
1
component name="UserService"{
2
​
3
function save(){
4
​
5
transaction {
6
// do some work here
7
}
8
​
9
}
10
}
Copied!
Now isn't that pretty? Much nicer and compact hugh! Plus I can reuse the method logger for ANY method in ANY class I desire (Muaaaahaaaa), that's an evil laugh by the way! But we are not done, let's keep going and do the Transactional aspect.
Copy link
Edit on GitHub