10.4. Cleaning Up Your Controllers¶

10.4.2.1. Class-Level Attributes¶

In addition to adding attributes above action methods, we can also add attributes for routing above the class. When we do so, we are designating class-wide behavior. In HelloController, we want every action method to respond to requests at paths that start with localhost:5001/helloworld. We can use [Route("path")] once above the class to designate that every path for each action method needs to start with /helloworld.

1
2
3
4
5

[Route("/helloworld")]
 public class HelloController : Controller
 {
     // action methods here
 }

Now that we have added that [Route("/helloworld")] above the class, we can start to modify the attributes we placed above the Index() method.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

[HttpGet]
public IActionResult Index()
{
   string html = "<form method='post' action='/helloworld/welcome'>" +
         "<input type='text' name='name' />" +
         "<input type='submit' value='Greet Me!' />" +
         "</form>";

   return Content(html, "text/html");
}

Since we want to map Index() to the path localhost:5001/helloworld, we removed the [Route("/helloworld")] attribute above the method. If we hadn’t, we would have inadvertently mapped the Index() method to the path, localhost:5001/helloworld/helloworld. We want to leave the [HttpGet] attribute above the Index() method so we can still specify that Index() responds to GET requests.

Now that just leaves us the Welcome() method!

10.4.2.2. One Method, Two Request Types¶

When we modified the Welcome() method to respond to a POST request, we commented out the attributes that we added when we were working with route parameters. With attributes, we can DRY our code and create one method that can respond to two different request types at two different routes. Before we begin, we should note that we can add route info directly to [HttpGet] and [HttpPost].

1
2
3
4
5

[HttpPost("welcome")]
public IActionResult Welcome(string name = "World")
{
   return Content("<h1>Welcome to my app, " + name + "!</h1>", "text/html");
}

On line 1, we modified the [HttpPost] attribute to include the end of our path. Now Welcome() still responds to POST requests at localhost:5001/helloworld/welcome. However, this is just the beginning of us DRYing our code.

We also want Welcome() to respond to GET requests. We can modify an [HttpGet] attribute to do so.

1
2
3
4
5
6

[HttpGet("welcome/{name?}")]
[HttpPost("welcome")]
public IActionResult Welcome(string name = "World")
{
   return Content("<h1>Welcome to my app, " + name + "!</h1>", "text/html");
}

We added a different path to the [HttpGet] attribute on line 1. Now Welcome() can respond to GET requests at localhost:5001/helloworld/welcome, localhost:5001/helloworld/welcome?name=Tillie, and localhost:5001/helloworld/welcome/Tille. Welcome() can also still respond to the POST request at localhost:5001/helloworld/welcome upon submission of the form.

Now when we run our code, our app will still have the same functionalities, but now we have a more refined and organized code base!