I have a large WebApi project with a few dozen controllers. Each controller represents an endpoint prefix, just as a normal MVC project would. For example:
CarsController.cs
represents http://api.example.com/api/Cars
In the above example, the first role of that controller is to provide CRUD actions for the Car
entity. As the application has grown, we find that for a car with a given ID, we might want to operate on it's AccidentHistory
like such:
http://api.example.com/api/Cars/77/AccidentHistory
Now, this endpoint serves as CRUD actions for the accident history of car with ID 77. This can go on for any arbitrary number of levels. The hierarchy of REST endpoints is great, everyone loves it. But this poses a problem in the world of MVC-based routing. We like to have a [Entity]Controller.cs
for each top-level entity. Each descended entity must then reside within it's greatest ancestor's controller file. So far, we've been giving each descendant entity their own #Region
inside Visual Studio, but it doesn't feel like a good solution.
My first idea was to move each sub-entity's actions into a partial class. For example:
CarsController.AccidentHistory.cs
would contain the actions for the previous example's endpoint.
This seems like a good idea, but there are many people in the community who believe that using partial classes is a huge code smell, and are quick to point out that partials were implemented as a work-around for WinForms classes that were auto-generated, but needed to be edited by the developer.
Another nail in the partial class coffin, for me at least, is that we're using CodeDom to generate TypeScript methods for each top-level endpoint, so there's one class in TypeScript that can be used to access all actions for a given endpoint. With the partial class approach, there are major problems getting generation to do what we want. (Seeing as all partials appear as their full implementation, you get duplicate class definitions generated in multiple files.
So, is there a better way to organize controller code for RESTful API routes in WebApi? One where we can quickly know where the code for a given endpoint is based simply on URL and method? Without having one controller per entity? Thoughts?
http://api.example.com/api/Cars/77/AccidentHistory
into a call into aCarsAccidentHistoryController.Index(77)
call. You'd be far better off asking on Stack Overflow though, as there's plenty of folk there that can likely give you a proper answer on how to do this. – David Arno Sep 13 '16 at 8:14