Home » Java » Enterprise Java » Converting JAX-RS parameters with ParamConverters

About Sebastian Daschner

Sebastian Daschner
Sebastian Daschner is a self-employed Java consultant and trainer. He is the author of the book 'Architecting Modern Java EE Applications'. Sebastian is a Java Champion, Oracle Developer Champion and JavaOne Rockstar.

Converting JAX-RS parameters with ParamConverters

If you want JAX-RS to automatically convert parameters such as query params, path params, or others, you need to create a ParamConverter. Primitive types, strings, and types who define certain conversion methods, such as a valueOf(String) method, are automatically converted. Here’s how to define a converter for LocalDates.

One gotcha I ran into a few times — besides the fact that I helped specifying the standard in the expert group :-) — is that you need to register a LocalDateParamConverterProvider as JAX-RS @Provider which then forwards the parameter to the actual converter. This behavior differs from the MessageBodyWriter or ExceptionMapper types, for example.

The following two classes are required to automatically convert LocalDate types:

import javax.ws.rs.ext.ParamConverter;
import java.time.LocalDate;

public class LocalDateConverter implements ParamConverter<LocalDate> {

    public LocalDate fromString(String value) {
        if (value == null)
            return null;
        return LocalDate.parse(value);

    public String toString(LocalDate value) {
        if (value == null)
            return null;
        return value.toString();


package com.sebastian_daschner.coffee_shop;

import javax.ws.rs.ext.ParamConverter;
import javax.ws.rs.ext.ParamConverterProvider;
import javax.ws.rs.ext.Provider;
import java.lang.annotation.Annotation;
import java.lang.reflect.Type;
import java.time.LocalDate;

public class LocalDateParamConverterProvider implements ParamConverterProvider {

    public <T> ParamConverter<T> getConverter(Class<T> rawType, Type genericType,
            Annotation[] annotations) {
        if (rawType.equals(LocalDate.class))
            return (ParamConverter<T>) new LocalDateConverter();
        return null;


Once the converter and provider are registered, we can use the LocalDate type as parameter for our resource methods:

public class TestResource {

    public String testIndex(@QueryParam("date") LocalDate date) {
        return "hello, " + date;

    public String test(@PathParam("date") LocalDate date) {
        return "hello, " + date;


However, we’re already having conversations in the ongoing JAX-RS specification process to enable both automatic conversion for Java time types, as well as registering converters without the provider, so this solution might be simplified in the future.

Check out the GitHub repository for Jakarta RESTful Web Services and the linked resources to join the discussion.

Published on Java Code Geeks with permission by Sebastian Daschner, partner at our JCG program. See the original article here: Converting JAX-RS parameters with ParamConverters

Opinions expressed by Java Code Geeks contributors are their own.

(0 rating, 0 votes)
You need to be a registered member to rate this.
Start the discussion Views Tweet it!
Do you want to know how to develop your skillset to become a Java Rockstar?
Subscribe to our newsletter to start Rocking right now!
To get you started we give you our best selling eBooks for FREE!
1. JPA Mini Book
2. JVM Troubleshooting Guide
3. JUnit Tutorial for Unit Testing
4. Java Annotations Tutorial
5. Java Interview Questions
6. Spring Interview Questions
7. Android UI Design
and many more ....
I agree to the Terms and Privacy Policy
Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Inline Feedbacks
View all comments