3. 为何还有人坚持这么做
在我的理解来看，有三种可能：
- 项目负责人追求快速的完成工作，而不追求质量，特别是外包性质的工作，乙方只管完成合同把代码给你，至于维护性什么的，谁理呢？
- 开发项目的同事在初学时，遇到了第一种情况的导师，认为这种情况是理所当然的，长年累积，不愿意改，也不想改，于是又变成了第一种人
- ”老油子“，你们怎么用，我就怎么用，改变什么的，不存在的，团队的风格就是我的风格
看完了反面教材，我们来看看现在大部分人怎么做：
@PostMapping("/students") public Response insert(@RequestBody @Validated Student student) { return success(studentService.save(student)); }
现在的一个业务接口，可能就是这么简单明了，让我们来看看这里都包含了什么信息：
- 遵从 RestFul 风格的 API，使用 Post 来进行保存操作
- 封装了同一的返回对象 Response，返回的格式是统一的，让前端可以封装统一的接收格式
- 使用了 @RequsetBody + 实体类对象来接收 Json 格式的参数，传了什么一目了然
再来说说这样做的好处：
- 参数校验：接口入参中，添加了 @Validated 注解，只要在 Student 类中添加对应的参数校验注解，就可以对入参进行自动校验，不合规的参数直接返回错误信息
- 一目了然：什么进来了，什么出去了，维护者一目了然
- 目的清晰：熟悉 RestFul 的人一看，基本就能知道你这个接口要做什么
- 接口文档：同样的，这种接口可以引入 Swagger 等自动化接口文档工具，可以在开发的时候花一点点时间就把接口文档写好，同时更新的时候也只需要该少量的代码
随着技术、项目的迭代，也许这种现象会越来越少直至消失，但是我想要表达的思想是：
- 当我们遇到技术时，不能盲目的使用，而是要横向对比，你得明白，他能干什么，不能干什么，给未来的自己留一条退路
- 也许你不得已在做错的事情，但是你要明白你做的事情是错的，并且努力修正这个错误，比如做好注释
- 努力用技术武装自己，哪怕你只是在这个行业呆一段时间，也请你有基本的职业道德，尽量不给后人埋坑
相关阅读 >>
苹果 iphone 14 系列 5g 网速提升 38%：信号更好了
赶紧查！你的手机app或许正在“自动续费”，这种方法可以取消「新闻三剑客」
王者荣耀：觉醒之战t0确认，阿轲典韦强势崛起，貂蝉上限已拉满！
5299元！尼康发布新款cfexpress存储卡：660gb 读写破1500mb/s
更多相关阅读请进入《新闻资讯》频道 >>
