使用Swagger和JBoss进行javax验证

Question

我正在尝试使用Swagger来记录我的REST API，并且已经取得了一些成功，但是当涉及到受限资源参数时，我遇到了一些困难。我正在使用带有Hibernate Validator提供程序和Jackson 2.x注释的POJO的JBoss RESTEasy。我遇到的问题是当遇到@DecimalMin/@DecimalMax注释时，我会收到一个

错误信息。

java.lang.NoSuchMethodError: javax.validation.constraints.DecimalMin.inclusive()Z 

似乎swagger正在尝试使用较新版本的javax.validation.constraints.*（v1.1.0.Final）库，而jboss正在使用旧版本（v1.0.0.GA）。我已经尝试了所有我能想到的方法来包含正确的库，但都没有成功。

环境是JBoss EAP 6.4.0.GA。

我的swagger入口（pom.xml）：

<dependency>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-jaxrs</artifactId>
    <version>1.5.8</version>
</dependency>

示例POJO片段：

...
import javax.validation.constraints.DecimalMax;
import javax.validation.constraints.DecimalMin;
...
@JsonInclude(JsonInclude.Include.NON_NULL)
@Generated("org.jsonschema2pojo")
@JsonPropertyOrder({
    "altM",
    "altDatum"
 })
public class Altitude {
@JsonProperty("altM")
@DecimalMin("-2000")
@DecimalMax("10000")
@NotNull
private Double altM;
...

我尝试了很多方法，但是随着学习的深入，我相信以下两个尝试是我最相关的依赖关系整理：

尝试1：从hibernate验证器中排除javax.validation，并让swagger包含它：

<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-hibernatevalidator-provider</artifactId>
    <version>3.0.16.Final</version>
    <exclusions>
        <exclusion>
            <groupId>javax.validation</groupId>
            <artifactId>validation-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

尝试2：明确包含javax.validation v1.1.0.Final：

<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>1.1.0.Final</version>
</dependency>

Maven依赖树（尝试1）：

[INFO] --- maven-dependency-plugin:2.8:tree (default-cli) @     MissionPlanningService ---
[INFO] mil.army.cerdec.cpi.mcas:MissionPlanningService:war:0.0.2-SNAPSHOT
[INFO] +- org.jboss.resteasy:resteasy-jaxrs:jar:3.0.16.Final:compile
[INFO] |  +- org.jboss.spec.javax.ws.rs:jboss-jaxrs-api_2.0_spec:jar:1.0.0.Final:compile
[INFO] |  +- org.jboss.spec.javax.annotation:jboss-annotations-api_1.2_spec:jar:1.0.0.Final:compile
[INFO] |  +- javax.activation:activation:jar:1.1.1:compile
[INFO] |  +- org.apache.httpcomponents:httpclient:jar:4.3.6:compile
[INFO] |  |  +- org.apache.httpcomponents:httpcore:jar:4.3.3:compile
[INFO] |  |  +- commons-logging:commons-logging:jar:1.1.3:compile
[INFO] |  |  \- commons-codec:commons-codec:jar:1.6:compile
[INFO] |  +- commons-io:commons-io:jar:2.1:compile
[INFO] |  +- net.jcip:jcip-annotations:jar:1.0:compile
[INFO] |  \- org.jboss.logging:jboss-logging:jar:3.1.4.GA:compile
[INFO] +- org.jboss.resteasy:resteasy-hibernatevalidator-provider:jar:3.0.16.Final:compile
[INFO] |  +- org.hibernate:hibernate-validator:jar:4.3.1.Final:compile
[INFO] |  \- org.jboss.weld.se:weld-se:jar:2.1.0.Final:compile
[INFO] +- commons-lang:commons-lang:jar:2.6:compile
[INFO] +- org.jboss.resteasy:resteasy-jackson2-provider:jar:3.0.16.Final:compile
[INFO] |  +- com.fasterxml.jackson.core:jackson-core:jar:2.6.3:compile
[INFO] |  +- com.fasterxml.jackson.core:jackson-databind:jar:2.6.3:compile
[INFO] |  +- com.fasterxml.jackson.core:jackson-annotations:jar:2.6.3:compile
[INFO] |  \- com.fasterxml.jackson.jaxrs:jackson-jaxrs-json-provider:jar:2.6.3:compile
[INFO] |     +- com.fasterxml.jackson.jaxrs:jackson-jaxrs-base:jar:2.6.3:compile
[INFO] |     \- com.fasterxml.jackson.module:jackson-module-jaxb-annotations:jar:2.6.3:compile
[INFO] \- io.swagger:swagger-jaxrs:jar:1.5.8:compile
[INFO]    +- com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:jar:2.4.5:compile
[INFO]    |  \- org.yaml:snakeyaml:jar:1.12:compile
[INFO]    +- com.fasterxml.jackson.dataformat:jackson-dataformat-xml:jar:2.4.5:compile
[INFO]    |  \- org.codehaus.woodstox:stax2-api:jar:3.1.4:compile
[INFO]    +- io.swagger:swagger-core:jar:1.5.8:compile
[INFO]    |  +- org.apache.commons:commons-lang3:jar:3.2.1:compile
[INFO]    |  +- org.slf4j:slf4j-api:jar:1.6.3:compile
[INFO]    |  +- com.fasterxml.jackson.datatype:jackson-datatype-joda:jar:2.4.5:compile
[INFO]    |  |  \- joda-time:joda-time:jar:2.2:compile
[INFO]    |  +- io.swagger:swagger-models:jar:1.5.8:compile
[INFO]    |  |  \- io.swagger:swagger-annotations:jar:1.5.8:compile
[INFO]    |  \- javax.validation:validation-api:jar:1.1.0.Final:compile
[INFO]    +- javax.ws.rs:jsr311-api:jar:1.1.1:compile
[INFO]    +- org.reflections:reflections:jar:0.9.10:compile
[INFO]    |  +- org.javassist:javassist:jar:3.19.0-GA:compile
[INFO]    |  \- com.google.code.findbugs:annotations:jar:2.0.1:compile
[INFO]    \- com.google.guava:guava:jar:18.0:compile

我的问题是：我该如何在JBoss RESTEasy和Hibernate Validator中使用Swagger？

注：我是Swagger/JBoss/JavaEE的新手，请原谅我可能会问一些愚蠢的问题，如果需要更多信息，请不要犹豫地询问。我不太确定应该提供哪些信息。

- Jeremy

---

这是什么样的环境？是像JBoss EAP或WildFly这样的Java EE容器吗？还是像Tomcat等Java SE风格的容器？您能发布依赖图（mvn dependency:tree）吗？ - Gunnar

添加到问题中。环境是JBoss EAP 6.4.0.GA。尝试#1的依赖树如下。 - Jeremy

据我所知，尝试#1正在按照我的预期进行，并且Swagger正在包含具有正确版本的javax.validation库。因此，我对为什么会出现NoSuchMethodError感到困惑... - Jeremy

Answer 1

原来JBoss EAP提供了自己的验证库（一个旧版本）。

我成功地复制了正确的验证.jar文件，并在以下位置编辑了module.xml文件：

$JBOSS_HOME/modules/system/layers/base/javax/validation/api/main

然后将 JBoss 指向正确的验证库：

...

<module xmlns="urn:jboss:module:1.1" name="javax.validation.api">
    <resources>
        <!-- OLD ONE: <resource-root path="validation-api-1.0.0.GA-redhat-3.jar"/> -->
        <!-- NEW ONE BELOW: -->
        <resource-root path="validation-api-1.1.0.Final.jar"/>
        <!-- Insert resources here -->
    </resources>
    <dependencies>
        <module name="org.jboss.logging"/>
    </dependencies>
</module>

- Jeremy