编辑“︁Spring通知类型”︁（章节）

== 详细说明与示例 ==

=== 1. 前置通知（Before Advice） ===
在目标方法执行前触发，适用于权限检查、参数验证等场景。

<syntaxhighlight lang="java">
@Aspect
@Component
public class LoggingAspect {

    @Before("execution(* com.example.service.*.*(..))")
    public void beforeAdvice(JoinPoint joinPoint) {
        System.out.println("前置通知：准备执行 " + joinPoint.getSignature().getName());
    }
}
</syntaxhighlight>

'''输出示例：'''
<pre>
前置通知：准备执行 getUserById
</pre>

=== 2. 后置通知（After Returning Advice） ===
仅在目标方法成功执行后触发，可访问返回值。

<syntaxhighlight lang="java">
@AfterReturning(
    pointcut = "execution(* com.example.service.*.*(..))",
    returning = "result"
)
public void afterReturningAdvice(JoinPoint joinPoint, Object result) {
    System.out.println("后置通知：方法 " + joinPoint.getSignature().getName() 
        + " 执行成功，返回值: " + result);
}
</syntaxhighlight>

'''输出示例：'''
<pre>
后置通知：方法 getUserById 执行成功，返回值: User{id=1, name='John'}
</pre>

=== 3. 异常通知（After Throwing Advice） ===
当目标方法抛出异常时触发，适合异常日志记录。

<syntaxhighlight lang="java">
@AfterThrowing(
    pointcut = "execution(* com.example.service.*.*(..))",
    throwing = "ex"
)
public void afterThrowingAdvice(JoinPoint joinPoint, Exception ex) {
    System.err.println("异常通知：方法 " + joinPoint.getSignature().getName() 
        + " 抛出异常: " + ex.getMessage());
}
</syntaxhighlight>

'''输出示例：'''
<pre>
异常通知：方法 updateUser 抛出异常: 用户不存在
</pre>

=== 4. 最终通知（After (Finally) Advice） ===
无论目标方法是否成功完成都会执行，类似于try-catch-finally中的finally块。

<syntaxhighlight lang="java">
@After("execution(* com.example.service.*.*(..))")
public void afterFinallyAdvice(JoinPoint joinPoint) {
    System.out.println("最终通知：方法 " + joinPoint.getSignature().getName() + " 执行结束");
}
</syntaxhighlight>

'''输出示例（成功时）：'''
<pre>
最终通知：方法 getUserById 执行结束
</pre>

'''输出示例（异常时）：'''
<pre>
最终通知：方法 updateUser 执行结束
</pre>

=== 5. 环绕通知（Around Advice） ===
功能最强大的通知类型，可以完全控制目标方法的执行。

<syntaxhighlight lang="java">
@Around("execution(* com.example.service.*.*(..))")
public Object aroundAdvice(ProceedingJoinPoint joinPoint) throws Throwable {
    System.out.println("环绕通知-前置：准备执行 " + joinPoint.getSignature().getName());
    
    try {
        Object result = joinPoint.proceed(); // 执行目标方法
        System.out.println("环绕通知-后置：方法执行成功，返回值: " + result);
        return result;
    } catch (Exception ex) {
        System.err.println("环绕通知-异常：捕获异常: " + ex.getMessage());
        throw ex;
    } finally {
        System.out.println("环绕通知-最终：方法执行结束");
    }
}
</syntaxhighlight>

'''输出示例：'''
<pre>
环绕通知-前置：准备执行 getUserById
环绕通知-后置：方法执行成功，返回值: User{id=1, name='John'}
环绕通知-最终：方法执行结束
</pre>