这才是后端API接口应该有的样子！666~

主要观点总结

文章主要讲述了Java开发中的Controller层设计，包括参数校验、自定义异常和统一拦截异常等，强调了参数校验的重要性和使用JSR303规范进行参数校验的方法，同时介绍了自定义异常和统一拦截异常的方法，以及如何使用Spring的ResponseBodyAdvice进行统一返回结构的处理，还提到了如何自定义校验规则，以及自动校验参数的必要性和意义。

关键观点总结

关键观点1: Controller层的定位和作用

Controller层作为数据接口，无论是传统的三层架构还是现在的COLA架构，都有一席之地，主要负责接收和响应请求，解析参数，调用Service执行业务逻辑，捕获异常并反馈。

关键观点2: 参数校验的重要性

参数校验可以防止无效数据进入业务逻辑，提高系统的健壮性，使用JSR303规范进行参数校验，可以实现参数和业务逻辑的解耦。

关键观点3: 自定义异常和统一拦截异常

自定义异常是为了在统一拦截异常时，对业务中的异常有更细颗粒度的区分，统一拦截异常的目的一个是为了可以与前面定义下来的统一包装返回结构对应上，另一个是我们希望无论系统发生什么异常，Http的状态码都要是200，尽可能由业务来区分系统的异常。

关键观点4: 统一返回结构

统一返回结构可以提高接口的友好性，方便对接的开发人员更加清晰地知道接口的调用情况，使用ResponseBodyAdvice进行统一返回结构的处理，可以减少对原有代码的改动。

关键观点5: 自定义校验规则

JSR303标准提供的校验规则可能不能满足复杂的业务需求，可以通过自定义注解类和注解校验器来定义自定义的校验规则，以满足特定的校验需求。