Spring REST Concepts: Difference between revisions
Line 17: | Line 17: | ||
=Receive Data from Client= | =Receive Data from Client= | ||
= | =Send a Response to Client= | ||
The [[@RestController]] annotation implies [[@ResponseBody]], which maps the result produced by the handler method onto the body of the HTTP response. By default, if all goes well, the HTTP status code is 200, even if the method returns null. | The [[@RestController]] annotation implies [[@ResponseBody]], which maps the result produced by the handler method onto the body of the HTTP response. By default, if all goes well, the HTTP status code is 200, even if the method returns null. |
Revision as of 20:01, 12 March 2019
Internal
Overview
The. Spring REST concepts page is an extension of the Spring MVC Concepts page. Spring MVC concepts are used and extended to provide REST support.
Annotations
Receive Data from Client
Send a Response to Client
The @RestController annotation implies @ResponseBody, which maps the result produced by the handler method onto the body of the HTTP response. By default, if all goes well, the HTTP status code is 200, even if the method returns null.
If the method handler wants to control the HTTP status code, it has the option of wrapping the response in a ResponseEntity<>, which, along the body, allows specifying the response code:
import org.springframework.http.ResponseEntity;
...
public ResponseEntity<A> get(...) {
// if found ...
return new ResponseEntity<>(a, HttpStatus.OK);
// ... else
return new ResponseEntity<>(null, HttpStatus.NOT_FOUND);
}
REST Clients
RestTemplate
TO PROCESS: https://docs.spring.io/spring/docs/current/spring-framework-reference/web.html#webmvc-resttemplate
POSTing Resource. Data
This overloaded version allows you to receive the newly created resource as a domain model object:
RestTemplate restTemplate = new RestTemplate();
MyResource model = new MyResource(...);
MyResource created = restTemplate.postForObject("http://localhost:8080/myresource", model, MyResource.class);