welcome to XRM blog

Keep in touch with latest CRM/ERP articles

To remain competitive your organisation must be efficient across the business process spectrum. To do so you need to take sound decisions based on a balance between the cost and risk. To do so you will be heavily dependent on your content management in itself needs...

image
Blog

Web API Attribute Routing

By Sudeep on 1/26/2016

 

In my previous post here I had discussed about convention based routing which is the default way in Web API. Check it out here.Starting with Web API 2 Microsoft introduced attribute based routing. Which is way more simpler. The reason for introducing this new feature was two folds, one it is easier to understand and maintain, second is the kind of REST calls required.

Let me elucidate it with an example

GET /profile/20011/ContactNumber

GET /profile/2011/EmailAddress

Not to say that this cannot be achieved by traditional methods but it is much harder to understand.

So Microsoft came up with Attribute Routing.

Let us take an example

So for our first example let us assume that you want the route to read some thing like this

www.mysidye.com/Employee

In this case we use a prefix called [Route(“Employee”)] before the action needed.

Parameter’s in End Point

 

Pretty simple isn’t it? Now let’s say you want the endpoint to be something like this, where 1 is the Id of the Employee, for whom you need the profile.

www.mysidye.com/Profile/56

Using Route Prefix this becomes pretty simple

Now let it take a step further and this time we need all the orders for a particular employee with id 501

www.mysidye.com/Profile/56/Orders

As you can see each parameter is written with curly braces and the function names the parameter exactly the same.

So does that mean we can use only a single parameter? No!

Let’s take another example, I want the order no 345 for the Employee profile with id of 56

www.mysidye.com/Profile/56/Order/345

Parameter Type
 

If we want to pass some parameter which has a type different from number, can we do it? Yes sure, let me modify the earlier example and get the profile based on name instead of id(not a good idea). Assumption is that name will always be unique and never repeated

www.mysidye.com/Profile/SudeepMukherjee/Order/345

As you can see I have decorated the parameter with the type. It looks fine but there is slight issue with this type, it only accepts alphabets and will fail if you pass a blank space. Please find the table below as a guide for your reference.

It is pretty much impossible to discuss all the options in one article but you can find it out by yourself how to use all of them.

RoutePrefix

Till now we have concentrated on defining the Rest end point based on the action. In our simple scenario it is pretty easy but in real world this is seldom the case. Your project will have multiple controllers and most probably some of them will have over lapping action names, even after you changing the route string.

In such a case we can put the RoutePrefix on top of our class/controller. Continuing from the earlier example let us assume we need the controller name to be part of the Rest endpoint. (Master is the name given to our class)

www.mysidye.com/Master/Profile/SudeepMukherjee/Order/345

HTTP Methods

All the examples shown till now have been simple Get request but WebAPI2 is not restricted to only one verb. Following verbs are available to  you for your usage.

·        [HttpDelete]

·        [HttpGet]

·        [HttpHead]

·        [HttpOptions]

·        [HttpPatch]

·        [HttpPost]

·        [HttpPut]

Let’s assume that you are not following the conventions and the action name does not contain the Http verb, so how do you make Web API understand the verb you are using. Simple!

As you can see I have adorned the top of the action with the verb [HttpPost], this will make the Web API understand this is not a get request but a post request.

I hope I have made a few points clear to you and made the confusing routing a little easy, in my next article I will post a simple JavaScript code to call these webapi’s .

 

.Net
DotNetNuke
DNNModules
DNNPlatform
Web API
WebDevelopment
WebsiteManagement
Author
Blog Calendar
Blog Calendar List
2025 Aug  12  4
2025 Jul  16  9
2025 Jun  21  6
2025 May  51  9
2025 Apr  35  6
2025 Mar  55  7
2025 Feb  41  6
2024 Nov  11  1
2024 Aug  8  1
2024 Apr  59  4
2024 Mar  166  4
2024 Feb  494  3
2024 Jan  33  7
2023 Dec  42  6
2023 Nov  633  5
2023 Oct  858  12
2023 Sep  1984  9
2023 Aug  607  6
2023 Jul  47  6
2023 Jun  26  4
2023 May  44  5
2023 Apr  88  5
2023 Mar  228  6
2023 Feb  178  5
2023 Jan  86  4
2022 Dec  96  7
2022 Nov  298  2
2022 Sep  13  1
2022 Aug  32  2
2022 Jun  11  2
2022 May  6  2
2022 Apr  12  2
2022 Mar  2  1
2022 Feb  2  1
2022 Jan  1  1
2021 Dec  4  1
2021 Nov  2  1
2021 Oct  2  1
2021 Sep  14  1
2021 Aug  49  5
2021 Jul  52  4
2021 Jun  1906  5
2021 May  43  3
2021 Apr  2266  3
2021 Mar  217  5
2021 Feb  2815  7
2021 Jan  4256  9
2020 Dec  598  7
2020 Sep  83  3
2020 Aug  792  3
2020 Jul  139  1
2020 Jun  103  3
2020 Apr  104  3
2020 Mar  19  2
2020 Feb  34  5
2020 Jan  48  7
2019 Dec  18  4
2019 Nov  42  1
2019 Jan  23  2
2018 Dec  146  4
2018 Nov  68  3
2018 Oct  18  3
2018 Sep  1293  11
2018 Aug  7  2
2018 Jun  21  1
2018 Jan  74  2
2017 Sep  590  5
2017 Aug  17  1
2017 Jul  17  2
2017 Jun  65  2
2017 May  21  1
2017 Apr  40  2
2017 Mar  144  4
2017 Feb  861  4
2016 Dec  212  3
2016 Nov  1098  8
2016 Oct  352  10
2016 Sep  821  6
2016 Aug  40  1
2016 Jun  1896  6
2016 May  116  3
2016 Jan  73  2
2015 Dec  764  6
2015 Nov  4  1
2015 Oct  13  1
2015 Sep  1473  6
2015 Aug  14  1
2015 Jul  129  2
2015 Jun  11  1
2015 May  20  1
2015 Apr  30  3
2015 Mar  80  3
2015 Jan  5350  4
2014 Dec  18  1
2014 Nov  2260  4
2014 Oct  69  1
2014 Sep  107  2
2014 Aug  5344  1
2014 Jul  49  2
2014 Apr  2602  12
2014 Mar  308  17
2014 Feb  223  6
2014 Jan  1510  16
2013 Dec  21  2
2013 Nov  695  2
2013 Oct  256  3
2013 Sep  13  1
2013 Aug  40  3
2013 Jul  214  1
2013 Apr  62  6
2013 Mar  2403  10
2013 Feb  131  3
2013 Jan  353  2
2012 Nov  63  2
2012 Oct  519  10
Tag Cloud
Interested in our services? Still not sure about project details? get a quote