让 Jersey 使用可选参数

Question

我正在尝试让 Jersey 使用可选参数。我有一个非常简单的网络服务：

    @Path("helloworld")
    public static class HelloWorldResource {
        public static final String CLICHED_MESSAGE = "Hello World!";

        @GET
        @Produces("text/plain")
        public String getHello(@QueryParam("maybe") Optional<String> maybe) {
            return CLICHED_MESSAGE;
        }
    }

还有一个简单的安全带：

    public static void main(String[] arg) throws IOException {
        ResourceConfig config = new ResourceConfig(HelloWorldResource.class);

        String baseUri = "http://localhost:8080/api/";
        HttpServer server = GrizzlyHttpServerFactory
                .createHttpServer(URI.create(baseUri), config, false);
        server.start();
    }

但是我收到以下错误：

Exception in thread "main" org.glassfish.jersey.server.model.ModelValidationException: Validation of the application resource model has failed during application initialization.
[[FATAL] No injection source found for a parameter of type public java.lang.String com.mercuria.odyssey.server.GrizllyOptional$HelloWorldResource.getHello(java.util.Optional) at index 0.; source='ResourceMethod{httpMethod=GET, consumedTypes=[], producedTypes=[text/plain], suspended=false, suspendTimeout=0, suspendTimeoutUnit=MILLISECONDS, invocable=Invocable{handler=ClassBasedMethodHandler{handlerClass=class com.mercuria.odyssey.server.GrizllyOptional$HelloWorldResource, handlerConstructors=[org.glassfish.jersey.server.model.HandlerConstructor@a3d9978]}, definitionMethod=public java.lang.String com.mercuria.odyssey.server.GrizllyOptional$HelloWorldResource.getHello(java.util.Optional), parameters=[Parameter [type=class java.util.Optional, source=maybe, defaultValue=null]], responseType=class java.lang.String}, nameBindings=[]}']
    at org.glassfish.jersey.server.ApplicationHandler.initialize(ApplicationHandler.java:555)
    at org.glassfish.jersey.server.ApplicationHandler.access0(ApplicationHandler.java:184)
    at org.glassfish.jersey.server.ApplicationHandler.call(ApplicationHandler.java:350)
    at org.glassfish.jersey.server.ApplicationHandler.call(ApplicationHandler.java:347)
    at org.glassfish.jersey.internal.Errors.process(Errors.java:315)
    at org.glassfish.jersey.internal.Errors.process(Errors.java:297)
    at org.glassfish.jersey.internal.Errors.processWithException(Errors.java:255)
    at org.glassfish.jersey.server.ApplicationHandler.<init>(ApplicationHandler.java:347)
    at org.glassfish.jersey.server.ApplicationHandler.<init>(ApplicationHandler.java:311)
    at org.glassfish.jersey.grizzly2.httpserver.GrizzlyHttpContainer.<init>(GrizzlyHttpContainer.java:337)
    at org.glassfish.jersey.grizzly2.httpserver.GrizzlyHttpServerFactory.createHttpServer(GrizzlyHttpServerFactory.java:140)
    at com.mercuria.odyssey.server.GrizllyOptional.main(GrizllyOptional.java:33)

我想我需要做点什么让 Jersey 知道如何处理 Optional 参数，但我不知道是什么！

Answer 1

这是一个部分解决方案，但 DropWizard 似乎有专门支持此功能的功能：

https://github.com/dropwizard/dropwizard/blob/master/dropwizard-jersey/src/main/java/io/dropwizard/jersey/optional/OptionalParamBinder.java

所以你可以简单地使用他们的代码：

    import io.dropwizard.jersey.optional.*;

    class DirtyBinder extends AbstractBinder {
        @Override
        protected void configure() {
            bind(OptionalParamConverterProvider.class).to(ParamConverterProvider.class).in(Singleton.class);
            bind(OptionalDoubleParamConverterProvider.class).to(ParamConverterProvider.class).in(Singleton.class);
            bind(OptionalIntParamConverterProvider.class).to(ParamConverterProvider.class).in(Singleton.class);
            bind(OptionalLongParamConverterProvider.class).to(ParamConverterProvider.class).in(Singleton.class);
        }
    }

然后只需添加：

config.register(new DirtyBinder());

Answer 2

因此允许作为 @xxxParam 的参数类型，您需要满足以下要求之一：

是原始类型
有一个接受单个字符串参数的构造函数
有一个名为 valueOf() 或 fromString() 的静态方法，它接受一个字符串参数（例如，参见 Integer.valueOf(String)）
有一个 ParamConverterProvider JAX-RS 扩展 SPI 的注册实现，returns 一个 ParamConverter 实例能够对类型进行“从字符串”转换。
为List<T>、Set<T>或SortedSet<T>，其中T满足上述2、3或4。生成的集合是只读的。

因此在 Optional 的情况下，顺着列表往下看；它不是原始的；它没有 String 构造函数；它没有静态 valueOf() 或 fromString()

所以基本上，剩下的唯一选择就是为它实现一个 ParamConverter/ParamConverterProvider 对。 Dropwizard（一个建立在 Jersey 之上的框架）有一个 good implementation for it。我会 post 它在这里以防 link 死掉

import org.glassfish.hk2.api.ServiceLocator;
import org.glassfish.jersey.internal.inject.Providers;
import org.glassfish.jersey.internal.util.ReflectionHelper;
import org.glassfish.jersey.internal.util.collection.ClassTypePair;

import javax.inject.Inject;
import javax.inject.Singleton;
import javax.ws.rs.ext.ParamConverter;
import javax.ws.rs.ext.ParamConverterProvider;
import java.lang.annotation.Annotation;
import java.lang.reflect.Type;
import java.util.List;
import java.util.Optional;
import java.util.Set;

@Singleton
public class OptionalParamConverterProvider implements ParamConverterProvider {
    private final ServiceLocator locator;

    @Inject
    public OptionalParamConverterProvider(final ServiceLocator locator) {
        this.locator = locator;
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public <T> ParamConverter<T> getConverter(final Class<T> rawType, final Type genericType, final Annotation[] annotations) {
        if (Optional.class.equals(rawType)) {
            final List<ClassTypePair> ctps = ReflectionHelper.getTypeArgumentAndClass(genericType);
            final ClassTypePair ctp = (ctps.size() == 1) ? ctps.get(0) : null;

            if (ctp == null || ctp.rawClass() == String.class) {
                return new ParamConverter<T>() {
                    @Override
                    public T fromString(final String value) {
                        return rawType.cast(Optional.ofNullable(value));
                    }

                    @Override
                    public String toString(final T value) {
                        return value.toString();
                    }
                };
            }

            final Set<ParamConverterProvider> converterProviders = Providers.getProviders(locator, ParamConverterProvider.class);
            for (ParamConverterProvider provider : converterProviders) {
                final ParamConverter<?> converter = provider.getConverter(ctp.rawClass(), ctp.type(), annotations);
                if (converter != null) {
                    return new ParamConverter<T>() {
                        @Override
                        public T fromString(final String value) {
                            return rawType.cast(Optional.ofNullable(value).map(s -> converter.fromString(value)));
                        }

                        @Override
                        public String toString(final T value) {
                            return value.toString();
                        }
                    };
                }
            }
        }

        return null;
    }
}

请注意，如果您使用的是 Jersey 2.26+ 版本，您将使用 InjectionManager 而不是注入 ServiceLocator。还有接受 locator 的参数，您需要更改管理器。

有了这个 class，您只需要在您的 Jersey 应用程序中注册它。

让 Jersey 使用可选参数

Get Jersey to work with Optional parameters

java

jersey

jax-rs