Micronaut HTTP Server

En este artículo estudiaremos los distintos llamados http que podemos trabajar con micronaut, crearemos un servidor con distintos llamados y pruebas.

Micronaut HTTP Server
oscar Escrito por oscar 23 March 2023 945 0
Micronaut

En este artículo estudiaremos los distintos llamados http que podemos trabajar con micronaut, crearemos un servidor con distintos llamados y pruebas.

🛠️ Prerrequisitos

Crear un controlador (controller)

Podemos encontrar toda la documentación en Micronaut (HTTP Server).

Micronaut incluye API de servidor HTTP y cliente sin bloqueo basadas en Netty.

Veamos un ejemplo:

import io.micronaut.http.MediaType;
import io.micronaut.http.annotation.Controller;
import io.micronaut.http.annotation.Get;

@Controller("/hello")
public class HelloController {

    @Get(produces = MediaType.TEXT_PLAIN)
    public String index() {
        return "Hello World";
    }
}

Metodos HTTP

Código Documentación 
@Get("/")
public HttpResponse<String> metodoGet() {
    return HttpResponse.ok("Método GET");
}

GET

Se usa para obtener datos del servidor.

 
@Post("/")
public HttpResponse<String> metodoPost() {
    return HttpResponse.ok("Método POST");
}

POST

Se usa para enviar datos al servidor y crear un nuevo recurso.

 
@Put("/")
public HttpResponse<String> metodoPut() {
    return HttpResponse.ok("Método PUT");
}

PUT

Se usa para reemplazar completamente un recurso existente con nuevos datos.

 
@Patch("/")
public HttpResponse<String> metodoPatch() {
    return HttpResponse.ok("Método PATCH");
}

PATCH

Se usa para modificar parcialmente un recurso.

 
@Delete("/")
public HttpResponse<String> metodoDelete() {
    return HttpResponse.ok("Método DELETE");
}

DELETE

Se usa para eliminar un recurso del servidor.

 
@Options("/")
public HttpResponse<String> metodoOptions() {
    return HttpResponse.ok("Método OPTIONS");
}

OPTIONS

Se usa para consultar qué métodos HTTP están permitidos en un recurso.

Llamados GET

Código Documentación 
@Get("/simpleGet")
public String simpleGet() {
    return "simpleGet";
}

simpleGet

Esta es la petición y respuesta básicas, observamos que realizamos el llamado GET, con la URL "/simpleGet", esta petición tiene las siguientes caracteristicas:

 
@Get(value = "/peticionGetRetornaTextoPlano", produces = MediaType.TEXT_PLAIN)
public String peticionGetRetornaTextoPlano() {
    return "peticionGetRetornaTextoPlano";
}

peticionGetRetornaTextoPlano

Tiene las mismas caracteristicas que simpleGet, en este caso, alteramos lo siguiente:

  • Cambiamos la respuesta con "produces", para que sea una respuesta de tipo MediaType.TEXT_PLAIN.
 
@Get(value = "/getPathVariable/{numero}")
public String getPathVariable(@PathVariable Integer numero) {
    return "getPathVariable:" + numero;
}

getPathVariable

Podemos usar variables de ruta de acceso por medio de la URI Micronauta (Enrutamiento).

  • En la anotación GET podemos incrustar la variable con el formato {VARIABLE}.
  • Con la anotación PathVariable podemos podemos pasar el argumento a una variable.
 
@Get(uris = {"/persona/{nombre}", "p/{nombre}"})
public String getPathVariableUris(@PathVariable String nombre) {
    return "getPathVariableUris:" + nombre;
}

getPathVariableUris

Podemos usar varias URIs para recibir diferentes llamados GET a una misma función, las caracteristicas de este llamado son:

  • Se añaden las uris con la siguiente sintaxis uri = {"/var1", "/var2"}
  • Se pueden añadir variables como se observa en getPathVariable
 
@Get("/getHttpResponse")
public HttpResponse<Respuesta> getHttpResponse() {
    Error error = new Error();
    error.setCodigo("campo");
    error.setMensaje("Error en este campo");
    List<Error> errores = new ArrayList<>();
    errores.add(error);
    Respuesta respuesta = new Respuesta();
    respuesta.setMensaje("Se presentaron los siguientes errores");
    respuesta.setErrores(errores);
    return HttpResponse.ok(respuesta);
}

getHttpResponse

Podemos dar una respuesta de un objeto y este por defecto se muestra en JSON, Para ello usamos a HttpResponse<T> quien crea una respuesta http.

  • HttpResponse.ok genera la respuesta 200 de http.

Llamados POST

Código Documentación 
@Post("/simplePost")
public String simplePost() {
    return "simplePost";
}

simplePost

Esta petición es el básico de POST, tiene las siguientes caracteristicas:

 
@Post("/postBody")
public String postBody(@Body Contacto contacto) {
    return contacto.getNombre();
}

postBody

Se puede hacer una petición tanto GET como POST enviando por el body un objeto json

 
@Post("/postBodyHttpResponse")
public HttpResponse postBodyHttpResponse(@Body Contacto contacto) {
    return HttpResponse.ok();
}

postBodyHttpResponse

La respuesta de esta solicitud, por defecto es de tipo "application/json". Micronauta (Tipo de contenido de respuesta)

 
@Post("/postHttpRequestResponse")
public HttpResponse postHttpRequestResponse(@Body Contacto contacto) {
    Respuesta respuesta = new Respuesta();
    respuesta.setMensaje(contacto.getNombre());
    return HttpResponse.ok(respuesta);
}

postHttpRequestResponse

 

 
@Post(value = "/postHttpConsumesProduces", 
    consumes = MediaType.APPLICATION_FORM_URLENCODED, 
    produces = MediaType.APPLICATION_JSON)
public HttpResponse<Contacto> postHttpConsumesProduces(
    @Body Contacto contacto) {
    return HttpResponse.created(contacto);
}

postHttpConsumesProduces

En esta petición post, estamos recibiendo la información de un formulario con el MediaType.APPLICATION_FORM_URLENCODED Micronaut (Accepted Request Content-Type)

 

Comentario

Debe aceptar antes de enviar