33

我们的 REST API 接收一些 JSON 对象输入,其中一些字段需要不为空。这些可以是字符串/整数,甚至可以是其他一些类实例作为参考。

我们正在尝试找到一种方法来强制这些字段不为空,而不是在 API 中进行空检查的正确方法。当前的:

if (myObject.getSomeOtherObject() == null)
    throw new SomeException();

我们想要的是这样的:

class MyObject{
    @Required
    OtherObject someOtherObject;
    // ...
}

我们尝试了 3 件事:

1) 升级到 jackson 2.0.6 并使用注释 com.fasterxml.jackson.annotation.JsonProperty 但是,这看起来不起作用。找到这些参考资料:http: //jira.codehaus.org/browse/JACKSON-767

2) 扩展 JsonDeserializer 以检查 null 但问题是它甚至没有在 null 输入上执行。

public class NotNullDeserializer<T> extends JsonDeserializer<T> {

    @Override
    public T deserialize(JsonParser jsonparser, DeserializationContext deserializationcontext) throws IOException, JsonProcessingException {

        ParameterizedType superClass = (ParameterizedType) getClass().getGenericSuperclass();
        Class<T> type = (Class<T>) superClass.getActualTypeArguments()[0];

        T t = jsonparser.readValueAs(type);

        if (t == null){
            String classNameField = type.getName();
            String field = jsonparser.getCurrentName();
            throw new WrongInputException("The field '"+field+"' of type '"+classNameField+"' should not be null.");
        }

        return t;
    }
}

public class NotNullAddressDeserializer extends NotNullDeserializer<Address> {

}

@JsonDeserialize(using=NotNullAddressDeserializer.class)
    Address to;

3)编写我们自己的@Required注释并尝试使用 ResourceFilter 进行检查,但似乎我无法从 ContainerRequest 中获取实际对象,即使我们可以,也不确定如何在object.otherObject.someObject.fieldNotNullable

private class Filter implements ResourceFilter, ContainerRequestFilter {
    private final ArrayList<String> requiredParameters;

    protected Filter() {
        requiredParameters = null;
    }

    protected Filter(ArrayList<String> requiredParameters) {
        this.requiredParameters = requiredParameters;
    }

    @Override
    public ContainerRequestFilter getRequestFilter() {
        return this;
    }

    @Override
    public ContainerResponseFilter getResponseFilter() {
        return null;
    }


    @Override
    public ContainerRequest filter(ContainerRequest request) {
        if (requiredParameters != null && requiredParameters.size() > 0) {
            MultivaluedMap<String, String> params = request.getQueryParameters();
            params.putAll(request.getFormParameters());
            StringBuffer missingParams = new StringBuffer();
            for (String reqParam : requiredParameters) {
                List<String> paramValues = params.get(reqParam);
                if (paramValues == null || paramValues != null && paramValues.size() == 0)
                    missingParams.append(reqParam + ",");
            }
            if (missingParams.length() > 0)
                throw new WrongInputException("Required parameters are missing: " + missingParams);
        }
        return request;
    }
}
4

4 回答 4

33

JAX-RS 很好地将反序列化与验证区分开来,即 JSON-B(或 Jackson)在设计上没有任何机制来强制将值设置为non-null等。相反,您可以使用 BeanValidation 来实现:

  1. javax.validation:validation-apiprovided范围内添加依赖项。
  2. javax.validation.constraints.NotNull注释添加到您的字段。

有关更多详细信息,请转到此处

于 2014-04-17T12:27:47.257 回答
2

@Required是注入 bean 的 Spring 框架注解,所以我想说不要将它用于此目的。

您可以改用这个:

http://robaustin.wikidot.com/annotations-and-notnull

@NotNull String myString;

对于运行时检查,请尝试http://code.google.com/p/notnullcheckweaver/

于 2012-10-10T06:44:08.097 回答
2

您可以使用 JSON-SCHEMA,因为您可以使用它来表达对 JSON 字段的许多约束:http: //json-schema.org/

然后,您可以使用 @NotNull JSR 303 注释从架构中生成您的 java 类,并在您的对象上使用 bean 验证。它与杰克逊本机合作,所以你不应该有任何问题。

例如,您可以使用 maven 插件来执行此操作:http ://wiki.jsonschema2pojo.googlecode.com/git/site/0.3.7/generate-mojo.html

于 2014-04-17T12:41:17.077 回答
1

not null您可以结合使用 Jackson JSON 库和javax.validationHibernate 验证器包来强制验证。

如果您使用的是 Maven,这些是您可以使用的依赖项:

<dependencies>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-core</artifactId>
        <version>${jackson-version}</version>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-annotations</artifactId>
        <version>${jackson-version}</version>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>${jackson-version}</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/javax.validation/validation-api -->
    <dependency>
        <groupId>javax.validation</groupId>
        <artifactId>validation-api</artifactId>
        <version>2.0.1.Final</version>
    </dependency>

    <dependency>
        <groupId>org.hibernate.validator</groupId>
        <artifactId>hibernate-validator</artifactId>
        <version>${hibernate-validator.version}</version>
    </dependency>
    <dependency>
        <groupId>org.hibernate.validator</groupId>
        <artifactId>hibernate-validator-annotation-processor</artifactId>
        <version>${hibernate-validator.version}</version>
    </dependency>

    <dependency>
        <groupId>javax.el</groupId>
        <artifactId>javax.el-api</artifactId>
        <version>3.0.0</version>
    </dependency>

    <dependency>
        <groupId>org.glassfish.web</groupId>
        <artifactId>javax.el</artifactId>
        <version>2.2.6</version>
    </dependency>

</dependencies>

然后,您的代码必须将一些 JSON 转换为带注释的对象,并且您需要使用javax.validation.Validator. 这是一些示例代码,演示了如何做到这一点(请参阅相关validate方法):

public class ShareLocationService {

    private ObjectMapper mapper = new ObjectMapper();

    private ValidatorFactory factory = Validation.buildDefaultValidatorFactory();

    // Materialize the Java object which contains the validation annotations
    public ShareLocation readFrom(String json) throws IOException {
        return mapper.readerFor(ShareLocation.class).readValue(json);
    }

    // validate and collect the set of validations
    public Set<String> validate(String json) throws IOException {
        ShareLocation shareMyLocation = readFrom(json);
        Validator validator = factory.getValidator();
        Set<ConstraintViolation<ShareLocation>> violations = validator.validate(shareMyLocation);
        return violations.stream().map(Object::toString).collect(Collectors.toSet());
    }
}

这是一个使用验证注释的示例类:

public class ShareLocation {
    
    @JsonProperty("Source")
    @NotNull
    private String source;
    
    @JsonProperty("CompanyCode")
    private String companyCode;
    
    @JsonProperty("FirstName")
    private String firstName;
    
    @JsonProperty("LastName")
    private String lastName;
    
    @JsonProperty("Email")
    private String email;
    
    @JsonProperty("MobileNumber")
    private String mobileNumber;
    
    @JsonProperty("Latitude")
    @NotNull
    private Double latitude;
    
    @JsonProperty("Longitude")
    @NotNull
    private Double longitude;
    
    @JsonProperty("LocationDateTime")
    @NotNull
    private String locationDateTime;
于 2018-08-22T14:23:23.267 回答