从 Java 编码看接口参数合法性校验的重要性

以下来源于本人在 GitChat 平台上撰写的博文。

互联网行业高速发展，Java语言在企业级开发中扮演着重要角色，其中以微服务架构生产实践较多，前后端分离模式开发贯穿整个软件开发生命周期，前端开发多以 Vue、React、Angular 三剑客为主，后端多以 Spring Boot / Spring Cloud 进行微服务改造。对于前后端分离模式开发，连接前后端的枢纽就是接口，此时后端接口开发完，在进行接口联调时，是否存在只是前端在接口调用前对参数合法性进行了必要的检查，而后端接口直接认为这次请求参数有效，直接进行处理，还是后端在控制层写了无数个 if 语句进行判断，又或是每个接口都对请求在控制层一一校验，等等这些现象，有没有更好的优雅的处理方式呢？因此对于众多繁杂的入参的 API 接口开发，为了提高接口的健壮性和稳定性，参数合法性校验显得格外重要。优雅的接口少不了简单高效的参数规则校验。

本文将以 Spring Boot / Spring Cloud 为例，讲述初中高级程序员在编写接口时，如何对接口入参进行优雅高效的合法性校验。

在本场 Chat 中，会讲到如下内容：

1. 通过 Spring Boot / Spring Cloud 搭建后台接口服务；

2. 通过注解实现 REST 服务接口开发；

3. 看初级、中级、高级程序员如何进行接口参数合法性校验及异常的优雅处理方式；

4. JavaEE 中 JSR 303 技术规范常用参数校验注解汇总及使用说明；

5. 对于JSR 303 规范中没有的个性化校验，以自定义参数校验注解和同一个 JavaBean 的分组规则校验编码实现为例。

适合人群：从事后端接口服务开发的人员以及使用 Spring Boot / Spring Cloud 进行企业级微服务开发的人员

目  录

• Spring Boot/Spring Cloud 框架

  • REST 特性

  • Spring Boot 框架简介及特性

  • Spring Cloud 微服务框架简介

• Validator 是如何实现参数校验的

  • 以 Spring Boot Validate 为例

• 参数校验——常用注解

• 接口参数校验编码体验

  • 为 Web 控制层添加通知

  • 接口规范（以 JSON 格式为例）

  • 看初级程序员参数校验如何实现

  • 看中级程序员处理接口参数校验实现

  • 看高级程序员处理接口参数校验实现

  • 自定义注解校验

  • 参数分组校验

• 小结

欢迎扫码吐槽：

小结

本文先是通过 Spring Boot 框架快速搭建了一个简单 API 接口服务，然后介绍了 RESTful 风格接口的开发，最后通过接口参数校验代码演示，相信大家以后不会在为接口复杂繁多的参数校验而烦恼。本文总结了基本的参数校验方法、全局异常类、自定义校验类、分组校验等，也用代码演示了初、中、高级程序员对于接口参数校验的编码实现，这种不同水平的对比能使得我们更好地学习和了解如何实现高效简洁的参数校验，提高代码可读性，提高生产力。

加油

# 精彩推荐 #

• 从 Java 代码如何运行聊到 JVM 和对象的创建-分配-定位-布局-垃圾回收

• 事务看完这篇你只能算入门

• 微服务架构中你必须了解的 CAP 原理

• 记一次生产频繁出现 Full GC 的 GC日志图文详解

 我知道你在看