Lo primero es tener bien clara la diferencia de lo que es un parámetro de lo que es el cuerpo de la petición.
En HTTP, una petición es un envío de un mensaje de una máquina a otra. Ese mensaje se compone de
- Cabeceras: Metadatos del mensaje
- Cuerpo: Contenido del mensaje
Ese mensaje se envía a una URL utilizando un método (GET, POST, etc.)
Por lo que tenemos 3 sitios donde se puede incluir información (Cabeceras, Cuerpo y la propia URL de destino del mensaje)
¿Qué es un parámetro?: Un parámetro es cada uno de los pares clave valor que se especifican en la URL. Si tu URL donde mandas el mensaje es http://www.miweb.com/index.php?name=john&surname=doe estás mandando dos parámetros, uno con clave name y valor john y otro con clave surname y valor doe.
¿Qué es el cuerpo?: El cuerpo es el resto de los datos que van dentro del mensaje, es decir, no van en la URL como el parámetro. Existen varias formas de codificar estos valores. Para especificar la codificación, lo puedes hacer añadiendo una cabecera con clave "Content-Type" y después el tipo de codificación que vas a utilizar.
Por ejemplo, si utilizas: Content-Type: application/x-www-form-urlencoded
el cuerpo contendría algo así:
name=john&surname=doe
Pero si utilizases Content-Type: application/json
el cuerpo contendría algo así:
{"name":"john","surname":"doe"}
Como ves la información es la misma, pero codificada de diferente forma.
Ya volviendo a Spring, ¿para qué nos valen estas anotaciones?
- La anotación
@RequestParam
nos sirve para acceder a uno de los parámetros. Por ejemplo si tienemos este metodo:
public String getData(@RequestParam name, @RequestParam surname) { ... }
En este caso Spring automáticamente inyectaría en la variable name el valor del parámetro name (recordemos que los parámetros vienen de la URL) y en la variable surname el valor parámetro surname. Es decir que si
- La anotación
@RequestBody
nos sirve para deserializar un objeto completo a partir del cuerpo de la petición. Es decir si tenemos esta clase:
public class Person {
private String name;
private String surname;
// Getters+setters, etc.
}
y tenemos este método:
public String getData(@RequestBody Person person) { ... }
En este caso Spring nos inyectaría en la variable person
un objeto de la clase Person
con los atributos name
y surname
informados con lo que nos venga en el cuerpo de esa petición.
Aquí Spring hace muchas cosas, porque primero mira el Content-type para determinar el tipo de codificación, después decodifica esos datos, crea una instancia nueva de la clase Person y llama a los setters correspondientes para informar sus atributos.
En general, al mandar un mensaje con GET no se manda cuerpo, por lo que los datos se suelen pasar en la URL, por lo que para obtenerlos se usaría @RequestParam
.
Para otro tipo de métodos, los datos se suelen mandar en el cuerpo y/o como parámetros. Según lo que queramos obtener, deberemos usar @RequestParam
o @RequestBody
.
Si inspeccionas una petición con las herramientas de desarrollo de tu navegador vas a ver algo así:
En los recuadros rojos vas a ver, que se aprecian:
- Los parámetros de la URL:
- El método usado
- El content-type
- En Query String Parameters tienes los valores que se pueden extraer con @RequestParam
- En Form Data tienes los valores que se pueden extraer con @RequestBody
Más info: