JSON开发笔记（四）—— JSON Schema实战（下）

1. JSON Schema第三方辅助工具

JSON Schema已经有众多基于不同语言实现的第三方辅助工具可以使用，具体情况可以查看官网上的说明：http://json-schema.org/implementations。在这些第三方工具里面，我们本次着重分析Java语言可以使用的第三方工具。目前，Java主要有以下第三方工具可以选择：

• json-schema-validator - supports version 4 (LGPLv3) —— fge
• json-schema (implementation based on the org.json API) - supports version 4 (Apache License 2.0) —— everit
• json-schema-validator - supports version 4 (Apache License 2.0) —— networknt

其实，fge、everit、networknt这三个第三方工具差别大同小异，网上有人做过三者的性能测试，具体地址如下：https://github.com/networknt/json-schema-validator-perftest。个人感觉该性能测试，并不能作为选择工具的唯一参考标准。毕竟，我们选择一个第三方工具的时候，性能只是考虑因素之一，并不是左右我们选择的唯一标准。而且，我认为最好结合应用场景，使用比较有针对性的测试数据源进行有针对性的比较和分析，这样也比较稳妥。而且，我们还要考虑当JSON Schema校验不通过时，第三方工具给出的错误提示是否准确和足够清楚易懂。

2. fge工具简介

我现在使用的第三方工具是fge，下面简要介绍一下相关用法。

2.1 pom.xml文件配置

<!-- fge -->
<dependency>  
    <groupId>com.github.fge</groupId>  
    <artifactId>json-schema-validator</artifactId>  
    <version>2.2.6</version>    
</dependency>
<!-- fasterxml -->
<dependency>  
    <groupId>com.fasterxml.jackson.core</groupId>  
    <artifactId>jackson-core</artifactId>  
    <version>2.3.0</version>    
</dependency>  
<dependency>  
    <groupId>com.fasterxml.jackson.core</groupId>  
    <artifactId>jackson-databind</artifactId>  
    <version>2.3.0</version>    
</dependency>  

注意，其中fge最新稳定版本是2.2.6，fasterxml的版本按需选择就好。

2.2 代码示例

JSON Schema校验，核心方法如下：

public static void validateJsonByFgeByJsonNode(JsonNode jsonNode, JsonNode schemaNode){
    ProcessingReport report = null;
    report = JsonSchemaFactory.byDefault().getValidator().validateUnchecked(schemaNode, jsonNode);
    if (report.isSuccess()) {
        // 校验成功
        System.out.println("校验成功！");
    }else {
        System.out.println("校验失败！");
        Iterator<ProcessingMessage> it = report.iterator();
        while(it.hasNext()){
            System.out.println(it.next());
        }
    }
}

从String获取JsonNode：

String json = "{\"foo\":1234}";
JsonNode jsonNode = JsonLoader.fromString(json);

从文件地址获取JsonNode：

String filePath = "src/test/resources/Test.json";
JsonNode jsonNode = null;
try {
    jsonNode = new JsonNodeReader().fromReader(new FileReader(filePath));
} catch (FileNotFoundException e) {
    e.printStackTrace();
} catch (IOException e) {
    e.printStackTrace();
}

注意：可以根据自己的项目情况以及具体应用背景进行相应的修改。