How Routing Works In ASP.NET WEB API

Explanation

Route Template acts as an entry point of the Routing in ASP.NET WEB API. Because, if the given or requested URI is matched with the Route Template then only the API looks for the controller and action method.

When Request has come to the API, first of all it tries to match the URI with one of the Route Templates. If the template has literals, then API checks for exact match of characters. For the placeholders it does not verify the exact value. In the above example Route Template has 'Demo' literal. So that API checks the same literal in the Route Template.

Note:

• API does not check URI's host name.
• API selects the first route which is matched with route template.
• If the placeholder's value is given in default of the Route, then the URI will not have the value for that placeholder.

Example: URI: http://localhost/API/Demo/1

This URI match with the above mentioned Route Template as Controller placeholder value has already given in the default of the Route.

Once the Requested URI is matched with Route Template, placeholder's values are stored as the KeyPair Values in Route Dictionary. Keys are the placeholders and these Values are taken from the URI.

Route Dictionary values based on the above Route Template are Controller:Stdent and id:1.

Note: Route Dictionary will have the values for placeholders only.

2. Finding the Controller

Finding the controller is simple. The API or Framework will get the Controller name from the Controller KeyValue of the Route Dictionary. From the above example Controller value is Student. This value is been taken as Controller key has Student value. Now, the framework appends Controller string to the KeyValue and Search for that controller. i.e StudentController. If there is no match for this controller then API returns error message.

3. Finding the Action Method

This is a little typical phase of Routing. For me it took much time to write this phase. To find the exact action method, framework gets the three values. They are:

• The Http Method of the Request.
• Action placeholder value from the route dictionary.
• Parameters of the actions.

Here Http Method plays an important role in selecting the exact action method. This is what we discussed in the beginning. (Action methods are selected based on the Web API 's Http method.)

Now, important aspect is that the Action methods are selected based on the Naming Convention of Http method or Attribute placed with Http Method above it.

Explanation:

• If the requested action method is of type HttpGet, either Action name would be Get or it should start with Get___.
  
  Example: GetStudent() or GetStudentDetails() actions will be selected.
  
  
• The Action method selection will be made on the attribute as well.
  
  1. [HttpGet]
  2. public HttpResponseMessage GiveMeStudent()
  3. {
  4. //To Do
  5. }

Note:

• The action methods which are of type public and are inherited by the APIController class are selected. If the method is private or not inherited by the APIController, framework returns an error.
  
  
• If the Action Method not satisfied with naming convention or Attribute is not placed above the method, by default the framework treats the action method as HttpPost method. (In case the Controller have specified action name which matches the exact action key value of Route Dictionary.).

The final one is Parameter Binding. If the parameter of simple type API gets the value from URI if it is of complex type such as entity, framework serializes the entity and bind it with parameter of the action method.

Summary

In this article we have discussed how the Web API's request takes right path to respective action method. Here we have discussed only theoretical part of the Routing. In my next article we will discuss routing with a real world example.