@GetMapping
es una anotación específica de Spring que se usa para manejar solicitudes HTTP GET
. Normalmente, se emplea para definir endpoints que obtienen datos, como la consulta de información en bases de datos o la generación de respuestas en formato JSON o XML. Al igual que otras anotaciones de mapeo (@PostMapping
, @PutMapping
), permite establecer la ruta y los parámetros que el endpoint debe recibir.
La sintaxis es más legible y compacta que @RequestMapping
, ya que no es necesario especificar el método HTTP, lo que la hace ideal para definir controladores de lectura de datos.
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class MiControlador {
// Endpoint simple que devuelve un mensaje
@GetMapping("/saludo")
public String obtenerSaludo() {
return "¡Hola, bienvenido a mi API!";
}
// Endpoint que acepta un parámetro de consulta (query param)
@GetMapping("/saludoPersonalizado")
public String saludoPersonalizado(@RequestParam(name = "nombre", defaultValue = "Invitado") String nombre) {
return "¡Hola, " + nombre + "!";
}
// Endpoint que utiliza un parámetro en la URL
@GetMapping("/usuario/{id}")
public String obtenerUsuarioPorId(@PathVariable("id") int id) {
return "Usuario con ID: " + id;
}
}
En este ejemplo:
@GetMapping("/saludo")
define un endpoint que devuelve un saludo general.
@GetMapping("/saludoPersonalizado")
utiliza @RequestParam
para aceptar un parámetro de consulta opcional llamado nombre
.
@GetMapping("/usuario/{id}")
emplea @PathVariable
para capturar un valor de la URL ({id}
) y devolver un mensaje con el ID proporcionado.
Puedes obtener más información sobre @GetMapping
en la documentación oficial de Spring.
Jorge García
Fullstack developer