CODEWITHSUNDEEP
c#asp.net-mvcaction-filter
Luke
Luke

Reputation: 23680

What is the Filter Scope for and why the weird names?

According to this documentation for ASP.NET Filters filters run in the following order:

  1. Authorization filters
  2. Action filters
  3. Response filters
  4. Exception filters

The within each filter type there is a filter Order which specifies the run order.

Makes sense so far... but then it gets bizarre.

There is a further method of ordering within each filter type and order which is represented as an enumeration of the following values:

public enum FilterScope
{
    First = 0,
    Global = 10,
    Controller = 20,
    Action = 30,
    Last = 100,
}

What bearing does Global, Controller and Action have within the run order for an action filter?

For example:

If I have two Action Filters, both with a run order of 1 and FilterScope of Controller and Action respectively.

Other than ordering one in front of the other, what bearing does Controller and Action have on anything?

Further Bizarreness

According to this the FilterScope provides third level ordering for filters. How is Controller, Global, or Action an order for a filter that is in no way restricted for use on just a Controller, Action and not necessarily applied globally? It isn't descriptive of an order.

Also, if it does provide third level filtering, why is it restricted to just the 5 options?

Upvotes: 8

Views: 2638

Answers (3)

KamalDeep
KamalDeep

Reputation: 834

As per my understanding,

There is filter order which means, order in which filter runs. So filter runs in the following order:

  1. Authorisation Filter
  2. Action Filter
  3. Response Filter
  4. Exception Filter

Within each filter type, the Order Value specify the run order. And within each filter type and order, the SCOPE enumeration value specifies the order for filter.

For eg: An OnActionExecuting() filter that has the Order property set to zero and filter scope set to first runs before an action filter that has the order property set to zero and filter scope set to Action.

Order and scope are used for prioritising internally between each filter type.

Upvotes: 0

VMAtm
VMAtm

Reputation: 28355

Well, I can't really understand what exactly do you find as a bizarreness here.

Authorization, Action, Response and Exception filters are 4 interfaces you can implement to run the filter logic, IAuthorizationFilter, IActionFilter, IResultFilter and IExceptionFilter interfaces respectively.

After that, the business rules comes out to the lights. For example, you have to check the access rights for some user action. You have not only implement the authorization filter, but create a logic for checking rules like:

  • If user didn't finish registration, you have to remind him about this. This rule should be run at First, no matter what user does on your site.
  • If user hasn't been approved, he can't view site contents, and should gain a validation message. So it is a Global scoped rule, and it should be run before any other checks for user rights.
  • If user has no access for some department, he can't view some content on site regarding that department, but not all - so we let the Controller choose, what should be displayed to user.
  • If user isn't a manager, he can't edit or delete some content. So, this is a concrete Action which is being filtered.
  • We can fire up some logger after task is being processed, so we have to wait until the work is done, and run filter at Last.

I see here a very simple model for the filter ordering, and I can provide a sample for each pair or filter type/filter scope.

Update:

some sample code for a Filter's ordering:

public class ControllerInstanceFilterProvider : IFilterProvider {
    public IEnumerable<Filter> GetFilters(ControllerContext controllerContext, ActionDescriptor actionDescriptor) {
        if (controllerContext.Controller != null) {
            // Use FilterScope.First and Order of Int32.MinValue to ensure controller instance methods always run first
            yield return new Filter(controllerContext.Controller, FilterScope.First, Int32.MinValue);
        }
    }
}

Upvotes: 2

Damien_The_Unbeliever
Damien_The_Unbeliever

Reputation: 239674

Filter objects, the objects that actually have a Scope property, are constructed based on usage - when you add a filter to the global application filters, a Filter object is constructed with a Scope of Global. Similarly, when filter attributes are collected from the controller and the action, Filter objects are constructed using scopes of Controller and Action, respectively.

I'm not entirely sure how a Filter with a Scope of First or Last actually gets created.

These rules are specified to say how tie-breaking will be applied should you have a filter declared at, say, the global level and at the action level using the same Order value - which is more of a concern than filters declared at the same level where you're expected to manually ensure that each filter uses a unique Order (if you care about ordering).

Upvotes: 3

Related Questions