To understand the difference between a join point and pointcut, think of pointcuts
as specifying the weaving rules and join points as situations satisfying those rules.
In below example,
@Pointcut("execution(* * getName()")
Pointcut defines rules saying, advice should be applied on getName() method present in any class in any package and joinpoints will be a list of all getName() method present in classes so that advice can be applied on these methods.
(In case of Spring, Rule will be applied on managed beans only and advice can be applied to public methods only).
I agree with mgroves.. A point cut can be considered as a collection of multiple joint points. Joint point specify the particular location where the advice could be implemented, where as pointcut reflects the list of all joint points.
JoinPoints: These are basically places in the actual business logic where you wish to insert some miscellaneous functionality that is necessary but not being part of the actual business logic. Some examples of JoinPints are: method call, method returning normally, method throwing an exception, instantiating an object, referring an object, etc...
Pointcuts: Pointcuts are something like regular expressions which are used to identify joinpoints. Pontcuts are expressed using "pointcut expression language". Pointcuts are points of execution flow where the cross-cutting concern needs to be applied. There is a difference between Joinpoint and Pointcut; Joinpoints are more general and represents any control flow where we 'may choose to' introduce a cross-cutting concern while pointcuts identifies such joinpoints where 'we want to' introduce a cross-cutting concern.
AOP in spring has {Advisor, Advice, Pointcut, Joinpoint}
As you know the main purpose of aop is decoupling the cross-cutting concern logic (Aspect) from the application code, to implement this in Spring we use (Advice/Advisor)
Pointcut is used to filter where we want to apply this advice exactly, like "all methods start with insert" so other methods will be excluded that's why we have in the Pointcut interface {ClassFilter and MethodMatcher}
So Advice is the cross-cutting logic implementation and Advisor is the advice plus the PointCut, if you use only advice spring will map it to advisor and make the pointcut TRUE which means don't block anything. That's why when you use only advice it is applied to all the methods of the target class because you didn't filter them.
But Joinpoint is a location in the program, you can think about it like reflection when you access the Class object and then you can get Method object, then you can invoke any method in this class, and that's how compiler works, if you think like this you can imagine the Joinpoint.
Joinpoint can be with field, constructor or method but in Spring we have joinpoint with methods only, that's why in Spring we have (Before, After, Throws, Around) types of Joinpoint, all of them refers to locations in the class.
As I mentioned you can have advice with no pointcut (no filter) then it will be applied to all the methods or you can have advisor which is [advice + pointcut] which will be applied to specific methods but you can't have advice without joinpoint like pointcut, you have to specify it, and that's why advice types in spring is exactly the same types as the joinpoint so when you choose an advice you implicitly choose which joinpoint.
To wrap up, advice is the implementation logic for your aspect to the target class, this advice should have a joinpoint like before invocation, after invocation, after throwing or around invocation, then you can filter where exactly you want to apply it using pointcut to filter the methods or no pointcut (no filter) so it will be applied to all the methods of the class.
Joinpoint: A joinpoint is a candidate point in the Program Execution of the application where an aspect can be plugged in. This point could be a method being called, an exception being thrown, or even a field being modified. These are the points where your aspect’s code can be inserted into the normal flow of your application to add new behavior.
Advice: This is an object which includes API invocations to the system wide concerns representing the action to perform at a joinpoint specified by a point.
Pointcut: A pointcut defines at what joinpoints, the associated Advice should be applied. Advice can be applied at any joinpoint supported by the AOP framework. Of course, you don’t want to apply all of your aspects at all of the possible joinpoints. Pointcuts allow you to specify where you want your advice to be applied. Often you specify these pointcuts using explicit class and method names or through regular expressions that define matching class and method name patterns. Some AOP frameworks allow you to create dynamic pointcuts that determine whether to apply advice based on runtime decisions, such as the value of method parameters.
The following image can help you understand Advice, PointCut, Joinpoints.
When you go out to a restaurant, you look at a menu and see several options to choose from. You can order one or more of any of the items on the menu. But until you actually order them, they are just "opportunities to dine". Once you place the order and the waiter brings it to your table, it's a meal.
Joinpoints are options on the menu and Pointcuts are items you select.
A Joinpoint is an opportunity within code for you to apply an aspect...just an opportunity. Once you take that opportunity and select one or more Joinpoints and apply an aspect to them, you've got a Pointcut.
A pointcut is defined on the Aspect - class implementation. The point cut basically refers to the pointcut expression within the advice.
For e.g,
@Before("execution(* app.purchase2.service.impl.*(..))")
public void includeAddOns(RolesAllowed roles) {
..
}
The above means, "includeAddOns" method is called before invoking(due to the @Before advice) any methods(in classes within package "app.purchase2.service.impl")
The whole annotation is called the pointcut
@Before("execution(* app.purchase2.service.impl.*(..))")
Joint point is the actual method invocation, which joined the method in package "app.purchase2.service.impl" to the method in aspect class "includeAddOns()".
You can access properties of the join point with the org.aspectj.lang.JoinPoint class.
Layman explanation for somebody who is new to the concepts AOP. This is not exhaustive, but should help in grasping the concepts. If you are already familiar with the basic jargon, you can stop reading now.
Assume you have a normal class Employee and you want to do something every time these methods are called.
class Employee{
public String getName(int id){....}
private int getID(String name){...}
}
these methods are called JoinPoints. We need a way to identify these methods so that the framework can find the methods, among all the classes.methods it has loaded.
So we will write a regular expression to match the signature of these methods. While there is more to it as you will see below, but loosely this regular expression is what defines Pointcut. e.g.
* * mypackage.Employee.get*(*)
First * is for modifier public/private/protected/default.
Second * is for return type of the method.
But then you also need to tell two more things:
When should an action be taken -
e.g Before/After the method execution OR on exception
What should it do when it matches (maybe just print a message)
The combination of these two is called Advice.
As you can imagine, you would have to write a function to be able to do #2. So this is how it might look like for the basics.
Note: For clarity, using word REGEX instead of the * * mypackage.Employee.get*(*). In reality the full expression goes into the definition.
@Before("execution(REGEX)")
public void doBeforeLogging() {....} <-- executed before the matching-method is called
@After("execution(REGEX)")
public void doAfterLogging() {....} <-- executed after the matching-method is called
Once you start using these quite a bit, you might end up specifying many @After/@Before/@Around advices. The repeated regular expressions will eventually end up making things confusing and difficult to maintain.
So what we do, we just give a name to the expression and use it everywhere else in the Aspect class.
@Pointcut("execution(REGEX)") <-- Note the introduction of Pointcut keyword
public void allGetterLogging(){} <-- This is usually empty
@Before("allGetterLogging")
public void doBeforeLogging() {....}
@After("allGetterLogging")
public void doAfterLogging() {....}
BTW, you would also want to wrap this whole logic in a class, that is called Aspect and you would write a class:
@Aspect
public class MyAwesomeAspect{....}
To get all these things to work, you would have to tell Spring to parse the classes to read, understand and take action on the @ AOP keywords. One way to do it is specifying the following in the spring config xml file:
Join point: a point during the execution of a program, such as the
execution of a method or the handling of an exception.
You can consider Joint Points as events in execution of a program. If you are using Spring AOP, this even is limited to invocation of methods. AspectJ provides more flexibility.
But you never handle all events as you don't eat all the food in the menu when you go to a restaurant (I don't know you, you might! But, I certainly don't). So you make a selection of events to handle and what to do with them. Here goes Pointcuts. As per the documentation,
Pointcut: a predicate that matches join points.
Then you associate what to do with the Pointcut, there goes Advice. As per the documentation,
Advice is associated with a pointcut expression and runs at any join point matched by the pointcut.
Code
package com.amanu.example;
import org.aspectj.lang.annotation.After;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.aspectj.lang.annotation.Pointcut;
/**
* @author Amanuel Nega on 10/25/16.
*/
class ExampleBussinessClass {
public Object doYourBusiness() {
return new Object();
}
}
@Aspect
class SomeAspect {
@Pointcut("execution(* com.amanu.example.ExampleBussinessClass.doYourBusiness())")
public void somePointCut() {
}//Empty body suffices
@After("somePointCut()")
public void afterSomePointCut() {
//Do what you want to do after the joint point is executed
}
@Before("execution(* *(*))")
public void beforeSomePointCut() {
//Do what you want to do before the joint point is executed
}
}
Explanation of Code
ExampleBusinessClass when proxy-ed, is our target!
doYourBusiness() is a possible joint point
SomeAspect is our aspect that crosses in to multiple concerns such ass ExampleBusinessClass
somePointCut() is a definition of a point cut that matches our joint point
afterSomePointCut() is an advice that will be executed after our somePointCutpoint cut that matches doYourBusiness()joint point
beforeSomePointCut() is also an advice that matches all public method executions. Unlike afterSomePointCut, this one uses an inline point cut declaration
You can look at the documentation if you don't believe me. I hope this helps
PointCut is an annotation, you can declare the scope inside the () where the advice will apply into.
instead, JoinPoint is an interface, it's a parameter used for all the five advice. Especially, for the @Around advice, ProceedingJoinPoint (a child interface of JoinPoint) is applied, and it provides.proceed()method. So you can control if let the program proceed or not. You can also change the args of it.
When you go out to a restaurant, you look at a menu and see several options to choose from. You can order one or more of any of the items on the menu. But until you actually order them, they are just "opportunities to dine". Once you place the order and the waiter brings it to your table, it's a meal.
Join points are the options on the menu and pointcuts are the items you select. A joinpoint is an opportunity within code for you to apply an aspect...just an opportunity. Once you take that opportunity and select one or more joinpoints and apply an aspect to them, you've got a pointcut.
e.g.
We have CoffeeService.buildDrink() and BreadService.buildFood().
In AfterSaleApsect.java, there are surveyAdvice() and couponAdvice(), which can be weaved into those services.
To descibe an advice, we need to at least point out 3 things.
When: joinPoint, the scenario that a given event happens.(Such as method execution, exception handling, changing object variable values, etc. In Spring AOP, a join point is always the execution of a method. Ref)
Who: pointcut, the preconditions(expression) for the targets must be matched, or advice will not be executed.
What to do.
@Aspect
public Class AfterSaleApsect{
//@When("Who")
//public void What(){
// ...
//}
//@AfterReturning("execution(* com.example.restaurant.service.*.build*())")
@AfterReturning("myPointcut()")
public void surveyAdvice(){
doSurvey();
}
//@AfterReturning("execution(* com.example.restaurant.service.*.build*())")
@AfterReturning("myPointcut()")
public void couponAdvice(){
doCoupon();
}
//Make it reusable
@Pointcut("execution(* com.example.restaurant.service.*.build*())")
public void myPointcut(){}
}
While aspects define types that crosscut, the AspectJ system does not allow completely arbitrary crosscutting. Rather, aspects define types that cut across principled points in a program's execution. These principled points are called join points.
This means that join points are a well defined sets of places in the execution flow of your application code on which aspect advices can be applied (I.e. a pointcut (or more) placed). You can't just go apply pointcuts willy nilly in your code using AspectJ. The formal definition of the places where pointcuts can be applied are the join points.