AroundMethodInterceptor class abstract interface

A comprehensive interceptor that wraps the entire method invocation process, allowing developers to control when and how the target method executes.

This is the most powerful interceptor type, capable of replacing, augmenting, or conditionally bypassing method execution entirely.

Common Use Cases

• Transaction boundaries
• Retry mechanisms
• Execution time measurement
• Security or context wrapping

Example

class TimingInterceptor implements AroundMethodInterceptor {
  @override
  bool canIntercept(Method method) => true;

  @override
  Future<T?> aroundInvoke<T>(MethodInvocation<T> invocation) async {
    final start = DateTime.now();
    final result = await invocation.proceed();
    final end = DateTime.now();
    print("Execution time: ${end.difference(start).inMilliseconds} ms");
    return result;
  }
}

Invocation Lifecycle

1. aroundInvocation is invoked before method execution.
2. Interceptor decides whether to call invocation.proceed().
3. Can optionally modify the return value or handle exceptions.

See Also

• MethodInvocation
• MethodBeforeInterceptor
• AfterReturningInterceptor
• AfterThrowingInterceptor
• AfterInvocationInterceptor