Controllers with Parameters

Controllers with Parameters

Now that you know the basics of a controller method, we can start to add some more variables into the mix. Some controller methods can take in parameters in the form of query strings or sections of the URL path. Passing this URL data to the controller is one step closer to more flexible web applications.

A route is the mechanism by which a request path gets assigned to a controller within our application. We’ll explore routes and how data is transferred from a webpage with a given route to a specific controller.

Query Strings are URL Data

A brief refresher: query strings are additional bits of information tacked onto the ends of URLs. They contain data in key-value pairs.

www.galaxyglossary.net?aKey=aValue&anotherKey=anotherValue&thirdKey=thirdValue

Controllers and Query Parameters - Video

@RequestParam

We can pass @RequestParam as an argument of a controller method. This annotation as an argument lets the handler method know about a given query string based on its own argument.

// Responds to get requests at /hello?coder=LaunchCoder
@GetMapping("hello")
@ResponseBody
public String hello(@RequestParam String coder) {        
   return "Hello, " + coder + "!";
}

The controller method looks for the query string in the URL that matches its parameter, coder, and puts the paired value of that coder key into the response text.

Controllers and Path Parameters - Video

@PathVariable

Another way to handle data with a controller is by accessing the data via a segment of the URL. This is done with @PathVariable. @PathVariable takes an argument that, if matching a portion of the URL, will deliver this data into the handler.

// Responds to get requests at /hello/LaunchCode
@GetMapping("hello/{name}")
@ResponseBody
public String helloAgain(@PathVariable String name) {
   return "Hello, " + name + "!";
}

Above, name is a placeholder, indicating where in the URL segment to look for the @PathVariable. From the comment, we know that the actual value is LaunchCode, but this can easily be changed. If we changed the value of this URL segment to /hello/Ada, then this controller would respond with Hello, Ada when a GET request is made.

Check Your Understanding

@GetMapping("venus")
@ResponseBody
public String venusSurface(@RequestParam String terrestrial) {
   if (terrestrial == true) {
      return "Venus is rocky."        
   } else {
      return "Venus is gaseous."
   }
}

@GetMapping("venus/{orbiter}")
@ResponseBody
public String venusOrbiter(@PathVariable String orbiter) {
   return orbiter + " currently orbits Venus."
}