Binding from Multiple Bindable values

Instead of binding just Query values, it is also possible to bind any Bindable value to POJO (e.g. when you want to bind HttpRequest, @PathVariable, @QueryValue and @Header to single POJO). This can be achieved with @RequestBean annotation and custom Bean class that has fields with Bindable annotations or fields that can be bound by type (e.g. HttpRequest, BasicAuth, Authentication etc.). For example:

Binding Bindable values to POJO

@Controller("/api")
public class MovieTicketController {
    // You can also omit query parameters like:
    // @Get("/movie/ticket/{movieId}
    @Get("/movie/ticket/{movieId}{?minPrice,maxPrice}")
    public HttpStatus list(@Valid @RequestBean MovieTicketBean bean) {
        return HttpStatus.OK;
    }
}

Binding Bindable values to POJO

@Controller("/api")
class MovieTicketController {
    // You can also omit query parameters like:
    // @Get("/movie/ticket/{movieId}
    @Get("/movie/ticket/{movieId}{?minPrice,maxPrice}")
    HttpStatus list(@Valid @RequestBean MovieTicketBean bean) {
        return HttpStatus.OK
    }
}

Binding Bindable values to POJO

@Controller("/api")
open class MovieTicketController {
    // You can also omit query parameters like:
    // @Get("/movie/ticket/{movieId}
    @Get("/movie/ticket/{movieId}{?minPrice,maxPrice}")
    open fun list(@Valid @RequestBean bean: MovieTicketBean): HttpStatus {
        return HttpStatus.OK
    }
}

Bean definition

@Introspected
public class MovieTicketBean {
    private HttpRequest<?> httpRequest;
    @PathVariable
    private String movieId;
    @Nullable
    @QueryValue
    @PositiveOrZero
    private Double minPrice;
    @Nullable
    @QueryValue
    @PositiveOrZero
    private Double maxPrice;
    public MovieTicketBean(HttpRequest<?> httpRequest, String movieId, Double minPrice, Double maxPrice) {
        this.httpRequest = httpRequest;
        this.movieId = movieId;
        this.minPrice = minPrice;
        this.maxPrice = maxPrice;
    }
    public HttpRequest<?> getHttpRequest() {
        return httpRequest;
    }
    public String getMovieId() {
        return movieId;
    }
    @Nullable
    public Double getMaxPrice() {
        return maxPrice;
    }
    @Nullable
    public Double getMinPrice() {
        return minPrice;
    }
}

Bean definition

@Introspected
class MovieTicketBean {
    private HttpRequest<?> httpRequest
    @PathVariable
    String movieId
    @Nullable
    @QueryValue
    @PositiveOrZero
    Double minPrice
    @Nullable
    @QueryValue
    @PositiveOrZero
    Double maxPrice
}

Bean definition

@Introspected
data class MovieTicketBean(val httpRequest: HttpRequest<Any>,
                           @field:PathVariable val movieId: String,
                           @field:QueryValue @field:PositiveOrZero @field:Nullable val minPrice: Double,
                           @field:QueryValue @field:PositiveOrZero @field:Nullable val maxPrice: Double)

Bean class has to be introspected with @Introspected. It can be one of:

1. Mutable Bean class with setters and getters

2. Immutable Bean class with getters and all argument constructor (or @Creator annotation on a constructor or static method). Arguments of constructor have to match field names so object can be constructed without reflection.