InterceptAttribute

InterceptAttribute Class¶

Applies an interceptor to a class or method. When discovered by Needlr's source generator, a proxy class is generated that routes method calls through the specified interceptor(s).

public sealed class InterceptAttribute : System.Attribute

Inheritance System.Object 🡒 System.Attribute 🡒 InterceptAttribute

Example¶

// Class-level interception (all methods)
[Intercept(typeof(LoggingInterceptor))]
[Scoped]
public class OrderService : IOrderService
{
    public Task<Order> GetOrderAsync(int id) => ...;
    public Task CreateOrderAsync(Order order) => ...;
}

// Method-level interception
[Scoped]
public class ProductService : IProductService
{
    [Intercept(typeof(CachingInterceptor))]
    public Task<Product> GetProductAsync(int id) => ...;

    // This method is NOT intercepted
    public Task UpdateProductAsync(Product product) => ...;
}

// Multiple interceptors with ordering
[Intercept(typeof(LoggingInterceptor), Order = 1)]
[Intercept(typeof(TimingInterceptor), Order = 2)]
[Scoped]
public class ReportService : IReportService { }

Remarks¶

This attribute can be applied at the class level (intercepts all methods) or at the method level (intercepts only that method).

The interceptor type must implement IMethodInterceptor and will be resolved from the DI container, allowing it to have dependencies.

When multiple interceptors are applied, use the Order property to control execution order. Lower values execute first (outermost in the chain).

Note: Interceptors are only supported with source generation. They are not available when using reflection-based registration.

Constructors¶