Quarkus REST Expert

Overview

Expert guidance for Quarkus 3.36.0 REST APIs using RESTEasy Reactive (the quarkus-rest extension). RESTEasy Reactive is non-blocking by default, runs on Vert.x event loop, and supports both Mutiny reactive types and plain Java return types.

Extension: io.quarkus:quarkus-rest (JSON: add io.quarkus:quarkus-rest-jackson)

Key Capabilities:

• JAX-RS resource classes with @Path, @GET, @POST, @PUT, @DELETE, @PATCH
• Reactive (Uni<T>, Multi<T>) and imperative (plain POJO) return types
• Path parameters (@PathParam), query parameters (@QueryParam), headers (@HeaderParam)
• Content negotiation (@Produces, @Consumes, multiple media types)
• Exception handling with @ServerExceptionMapper and global ExceptionMapper<T>
• Request/response filters with @ServerRequestFilter / @ServerResponseFilter
• REST Client Reactive for outbound HTTP with @RegisterRestClient
• Bean Validation with @Valid and @Validated
• OpenAPI documentation via SmallRye OpenAPI (quarkus-smallrye-openapi)
• RestResponse<T> for fine-grained HTTP response control