@PutMapping

From NovaOrdis Knowledge Base
Jump to navigation Jump to search

Internal

Overview

The annotation may also contain a sub-path relative to the class-level base path, usually configured with @RequestMapping.

REST

@RestController
@RequestMapping(path = "/a", produces = "application/json")
public class AController {

  @PutMapping(path = "/{id}", consumes = "application/json")
  public ResponseEntity<A> put(@PathVariable("id") Integer id, @RequestBody A a) {

      // wholesale replacement, make sure there is such an ID and the A instance is valid

      A old = content.get(id);

      if (old == null) {

          return new ResponseEntity<>(null, HttpStatus.NOT_FOUND);
      }

      old.updateFrom(a);

      return new ResponseEntity<>(old, HttpStatus.OK);
  }
}

For possible problems related to @RequestBody and deserialization from JSON, see:

Request Body and Jackson Deserialization

HTTP POST Semantics for REST Applications

HTTP POST Semantics for REST Applications

HTTP PUT Semantics for REST Applications

HTTP PUT Semantics for REST Applications