经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置:技术经验 » Java相关 » Spring Boot » 查看文章
Spring Boot 中使用 JSON Schema 来校验复杂JSON数据
来源:cnblogs  作者:程序猿DD  时间:2024/8/7 8:51:20  对本文有异议

JSON是我们编写API时候用于数据传递的常用格式,那么你是否知道JSON Schema呢?

在数据交换领域,JSON Schema 以其强大的标准化能力,为定义和规范 JSON 数据的结构与规则提供了有力支持。通过一系列精心设计的关键字,JSON Schema 能够详尽地描述数据的各项属性。然而,仅凭 JSON Schema 本身,尚不足以验证 JSON 实例是否严格遵循预设的模式。此时,JSON Schema 验证器的角色便显得尤为关键。这些验证器如同严格的检查官,确保每一个 JSON 文档都能忠实地反映出模式的定义。JSON Schema 验证器,作为实现 JSON Schema 规范的技术工具,其灵活的集成能力使得无论项目规模大小,都能轻松地将 JSON Schema 融入开发流程,从而提升数据处理的效率与准确性。

下面我们来看看如何在Spring Boot应用中使用JSON Schema校验JSON数据

动手试试

  1. 创建一个基本的Spring Boot应用,如果还不会可以点击查看快速入门

  2. pom.xml中添加json-schema-validator依赖

  1. <dependency>
  2. <groupId>com.networknt</groupId>
  3. <artifactId>json-schema-validator</artifactId>
  4. <version>1.4.0</version>
  5. </dependency>
  1. 创建JSON Schema

src/main/resources目录下创建一个validation.json文件,然后在里面制定一套详尽的验证规则,比如下面这样:

  1. {
  2. "$schema": "http://json-schema.org/draft-07/schema#",
  3. "title": "Order Event",
  4. "description": "Order event schema for example",
  5. "required": ["order_id", "total_price", "products" ],
  6. "properties": {
  7. "order_id": {
  8. "type": "string"
  9. },
  10. "event": {
  11. "enum": ["PLACED", "DELIVERED", "RETURNED"],
  12. "type": "string"
  13. },
  14. "total_price": {
  15. "type": "number",
  16. "minimum": 0
  17. },
  18. "products": {
  19. "type": "array",
  20. "items": {
  21. "additionalProperties": true,
  22. "required": ["product_id", "price"],
  23. "minItems": 1,
  24. "properties": {
  25. "product_id": {
  26. "type": "string"
  27. },
  28. "price": {
  29. "type": "number",
  30. "minimum": 0
  31. },
  32. "quantity": {
  33. "type": "integer"
  34. }
  35. }
  36. }
  37. }
  38. }
  39. }
  1. 创建 JsonSchema 的 Bean

当然,你也可以直接new来创建,但实战中还是推荐用Spring管理这些实例,比如 下面这样:

  1. @Configuration
  2. public class JsonSchemaConfiguration {
  3. private static final String SCHEMA_VALIDATION_FILE = "validation.json";
  4. @Bean
  5. public JsonSchema jsonSchema() {
  6. return JsonSchemaFactory
  7. .getInstance( SpecVersion.VersionFlag.V7 )
  8. .getSchema( getClass().getResourceAsStream( SCHEMA_VALIDATION_FILE ) );
  9. }
  10. }
  1. 使用 JsonSchema
  1. @Slf4j
  2. @Service
  3. public class JsonSchemaValidationService{
  4. @Autowired
  5. private JsonSchema jsonSchema;
  6. public String validateJson(JsonNode jsonNode){
  7. Set<ValidationMessage> errors = jsonSchema.validate(jsonNode);
  8. if(errors.isEmpty()){
  9. log.info("event is valid");
  10. }else{
  11. log.info("event is invalid");
  12. }
  13. return errors.toString();
  14. }
  15. }
  1. 在 Web 层的应用

创建一个Controller,当接收到来自客户端的JSON数据之后,就可以像下面这样对json数据进行校验:

  1. import com.fasterxml.jackson.databind.JsonNode;
  2. @RestController
  3. public class JsonSchemaController {
  4. @Autowired
  5. private JsonSchemaValidationService service;
  6. @PostMapping("/test")
  7. public String validateEvent( @RequestBody JsonNode jsonNode ){
  8. return service.validateJson(jsonNode);
  9. }
  10. }
  1. 测试一下

启动 Sprint Boot 应用,然后使用你喜欢的http客户端工具对/test接口发送测试请求:

比如,下面使用Curl来进行测试:

  • 符合规则的合法请求:
  1. $ curl --location 'localhost:8080/test' --header 'Content-Type: application/json' --data '{
  2. "order_id":"order134",
  3. "event": "PLACED",
  4. "products": [
  5. {
  6. "product_id": "product_1",
  7. "price":20.5,
  8. "quantity":2
  9. }
  10. ],
  11. "total_price": 41
  12. }'

校验通过,返回:[],没有错误信息

  • 不符合规则的非法请求(却少order id):
  1. $ curl --location 'localhost:8080/test' --header 'Content-Type: application/json' --data '{
  2. "event": "PLACED",
  3. "products": [
  4. {
  5. "product_id": "product_1",
  6. "price":20.5,
  7. "quantity":2
  8. }
  9. ],
  10. "total_price": 41
  11. }'

校验失败,将返回错误信息:[$.order_id: is missing but it is required]

好了,今天的分享就到这里,希望对您有用。如果您学习过程中如遇困难?可以加入我们超高质量的Spring技术交流群,参与交流与讨论,更好的学习与进步!更多Spring Boot教程可以点击直达!,欢迎收藏与转发支持!

相关资料

欢迎关注我的公众号:程序猿DD。第一时间了解前沿行业消息、分享深度技术干货、获取优质学习资源

原文链接:https://www.cnblogs.com/didispace/p/18344858

 友情链接:直通硅谷  点职佳  北美留学生论坛

本站QQ群:前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

W3xue 的所有内容仅供测试,对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接(目前9元/月)请联系QQ:27243702 沸活量
皖ICP备17017327号-2 皖公网安备34020702000426号