java - 为 restful web 服务指定一个带有默认值的可选参数

Question

我正在尝试创建一个返回 int 的网络服务。它还应该有一个可选参数 - 这会失败。

这个有效:

package foo;

import java.util.Map;
import java.util.TreeMap;

import javax.ws.rs.DefaultValue;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.QueryParam;
import javax.ws.rs.core.MediaType;

@Path("/euler")
public class Euler1 {

    @GET
    @Path("/getmultiples")
    @Produces(MediaType.APPLICATION_JSON)
    public static Map<String, Integer> getMultiples() {
        int sum = 0;
        int limit = 1000;
        for (int i = 0; i < limit; i += 3) {
            sum += i;
        }
        for (int i = 0; i < limit; i += 5) {
            if (i % 3 != 0) {
                sum += i;
            }
        }
        final Map<String, Integer> result = new TreeMap<>();
        result.put("Sum", sum);
        return result;
    }
}

如果我像 curl http://localhost:8080/foo/rest/euler/getmultiples 这样调用它，我会得到 {"Sum":233168}。

---

但是限制应该是一个可选参数。所以我将方法签名更改为

public static Map<String, Integer> getMultiples(
   @DefaultValue("1000") @QueryParam(value = "limit") int limit)

但是之前的没有返回任何内容，服务器(Wildfly 8)记录

15:07:08,889 ERROR [io.undertow.request] (default task-3) UT005023: Exception handling request to /foo/rest/euler/getmultiples: java.lang.ArrayIndexOutOfBoundsException: 0
    at org.jboss.resteasy.plugins.validation.GeneralValidatorImpl.parametersResolveToSameTypes(GeneralValidatorImpl.java:515) [resteasy-validator-provider-11-3.0.10.Final.jar:]
    at org.jboss.resteasy.plugins.validation.GeneralValidatorImpl.overrides(GeneralValidatorImpl.java:486) [resteasy-validator-provider-11-3.0.10.Final.jar:]
    at org.jboss.resteasy.plugins.validation.GeneralValidatorImpl.getSuperMethod(GeneralValidatorImpl.java:444) [resteasy-validator-provider-11-3.0.10.Final.jar:]
    at org.jboss.resteasy.plugins.validation.GeneralValidatorImpl.getExecutableTypesOnMethodInHierarchy(GeneralValidatorImpl.java:335) [resteasy-validator-provider-11-3.0.10.Final.jar:]
    at org.jboss.resteasy.plugins.validation.GeneralValidatorImpl.isMethodValidatable(GeneralValidatorImpl.java:265) [resteasy-validator-provider-11-3.0.10.Final.jar:]

这是 web.xml:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
    version="3.1">
    <servlet-mapping>
        <servlet-name>javax.ws.rs.core.Application</servlet-name>
        <url-pattern>/rest/*</url-pattern>
    </servlet-mapping>
</web-app>

使用的原型(prototype)是 com.airhacks:javaee7-essentials-archetype 的最新版本。

这是 pom.xml:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>de.oneiros</groupId>
    <artifactId>webservice-ee7</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>
    <dependencies>
        <dependency>
            <groupId>javax</groupId>
            <artifactId>javaee-api</artifactId>
            <version>7.0</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>
    <build>
        <finalName>webservice-ee7</finalName>
    </build>
    <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <failOnMissingWebXml>false</failOnMissingWebXml>
    </properties>
</project>

如何将可选参数传递给我的方法？

Answer 1

问题似乎是资源方法是static(感谢@peeskillet 的测试和确认)。

堆栈跟踪表明这里出了点问题:它调用了一个名为 getSuperMethod 的方法，这对静态方法来说实际上没有意义。

查看 source code ，似乎 validator 插件正在尝试使用实例方法而不是类方法。这听起来像是插件中的错误。