De acordo com a documentação do Jersey, para uma classe ser suportada como um @QueryParam
, ela precisa satisfazer os seguintes requisitos:
- Ser um tipo primitivo;
- Tem um construtor que aceita apenas uma
String
como argumento;
- Ter um método estático cujo nome seja
fromString
ou valueOf
e aceite apenas uma String
como argumento;
- Ter uma implementação da interface
javax.ws.rs.ext.ParamConverterProvider
que retorne uma instância da interfacejavax.ws.rs.ext.ParamConverter
, ou;
- Ser uma
List<T>
, Set<T>
ou SortedSet<T>
, onde T
satisfaça as opções 2 ou 3.
O único critério que a classe Date
satisfazia era a 2, porém, como o construtor Date(String)
foi marcado como @Deprecated
(obsoleto), os desenvolvedores do Jersey optaram por parar de suportá-lo a partir do Jersey 2.x.
Sendo assim, a única opção que resta é implementar um javax.ws.rs.ext.ParamConverterProvider
e registrá-lo. Exemplo:
public class DateParamProvider implements ParamConverterProvider {
@SuppressWarnings("unchecked")
@Override
public <T> ParamConverter<T> getConverter(final Class<T> rawType, final Type genericType,
final Annotation[] annotations) {
if (rawType != Date.class) {
return null;
}
//TODO teste se esse é realmente o formato utilizado pelas suas datas
final DateFormat format = new SimpleDateFormat("EEE MMM dd yyyy HH:mm:ss 'GMT'Z");
return (ParamConverter<T>) new ParamConverter<Date>() {
@Override
public Date fromString(final String value) {
try {
return format.parse(value);
} catch (final ParseException e) {
throw new IllegalArgumentException(e);
}
}
@Override
public String toString(final Date value) {
return format.format(value);
}
};
}
}
E registrá-lo (isso vai depender de como você configurou o seu projeto. Ex: via javax.ws.rs.core.Application
, web.xml
ou org.glassfish.jersey.server.ResourceConfig
):
javax.ws.rs.core.Application
//TODO ajuste para o caminho da sua aplicação
@ApplicationPath("/")
public class InitApp extends Application {
@Override
public Set<Class<?>> getClasses() {
Set<Class<?>> classes = new HashSet<>();
classes.add(SuaClasseAnotadoComPath.class); //Sua classe anotado com @Path
classes.add(DateParamProvider.class);
return classes;
}
}
org.glassfish.jersey.server.ResourceConfig
//TODO ajuste para o caminho da sua aplicação
@ApplicationPath("/")
public class InitApp extends ResourceConfig {
public InitApp() {
register(SuaClasseAnotadoComPath.class); //Sua classe anotado com @Path
register(DateParamProvider.class);
}
}
Uma outra solução mais simples seria receber o parâmetro como uma String
e, dentro do próprio método, fazer a conversão para Date
.
Observação: se não houver nenhuma obrigação em utilizar a classe Date
, dê uma olhada novas classes inseridas no Java 8 do pacote java.time
, nesse caso em especial, na classe ZonedDateTime
(mesmo com essa classe, o uso de uma implementação de um javax.ws.rs.ext.ParamConverterProvider
ainda é necessário).