Event Filtering

Apq.ChangeBubbling provides flexible event filtering mechanisms.

Filter Interface

public interface IChangeEventFilter
{
    bool ShouldProcess(BubblingChange change);
}

Built-in Filters

PropertyNameFilter

var filter = new PropertyNameFilter("Name", "Email");
ChangeMessenger.RegisterFilter("propertyFilter", filter);

NodeNameFilter

var filter = new NodeNameFilter("Users", "Settings");
ChangeMessenger.RegisterFilter("nodeFilter", filter);

ChangeKindFilter

var filter = new ChangeKindFilter(
    NodeChangeKind.CollectionAdd,
    NodeChangeKind.CollectionRemove
);
ChangeMessenger.RegisterFilter("kindFilter", filter);

ThrottleFilter

var filter = new ThrottleFilter(TimeSpan.FromMilliseconds(100));
ChangeMessenger.RegisterFilter("throttleFilter", filter);

Custom Filters

public class CustomFilter : IChangeEventFilter
{
    public bool ShouldProcess(BubblingChange change)
    {
        return change.NewValue != null;
    }
}

ChangeMessenger.RegisterFilter("customFilter", new CustomFilter());

Managing Filters

// Register
ChangeMessenger.RegisterFilter("myFilter", filter);

// Remove
ChangeMessenger.RemoveFilter("myFilter");