一、基本介绍

结构化编程,简单来理解,就是通过定义结构体传递和返回参数。

我们建议在必要的场景下使用结构化定义来管理输出/输出,尤其是在controllerservice两层的代码设计中。

1、controller非结构化痛点

结构化编程设计 - 图1

  • 难以确定接口输入/输出数据结构,大多数的场景是在代码中硬编码参数接收名称,易把名称写错造成不可预料的问题
  • 接口参数往往只定义一个HttpRequest/HttpContext对象指针,执行结果直接写入到对象,难以确定接口是否成功/失败
  • 参数接收、校验、转换处理工作繁琐
  • 接口文档生成以及维护极为困难

2、service非结构化痛点

结构化编程设计 - 图2

  • 当方法参数较多的时,定义丑陋,使用别扭
  • 当方法参数数量、类型不太确定时,任意的参数变化都是非兼容的,会引起较高的修改成本
  • 方法参数注释不简便,以至于绝大部分业务项目都不会有方法参数注释

二、结构化编程

1、controller结构化改进

结构化优点:

  • 通过结构化管理接口输入/输出参数,参数接收不再需要硬编码参数名称,降低维护成本,避免参数名称硬编码错误问题
  • 可以做到自动化的参数接收、转换、校验,提高生产力
  • 使得接口管理能够像普通的函数管理那么方便,通过返回error来判断接口处理结果,并可以规范化统一错误机制
  • 使得自动化的接口文档生成变为了可能,并保障了接口结构定义和接口文档同步维护

结构化示例:

结构定义:

结构化编程设计 - 图3

方法使用:

结构化编程设计 - 图4

2、service结构化改进

结构化优点:

  • 当方法参数较多的时,通过结构体优雅管理参数
  • 当方法参数数量、类型不太确定时,参数的增加对方法调用来说都是兼容性的
  • 对结构体属性的注释描述更加便捷,提高代码维护质量

结构化示例:

结构化编程设计 - 图5

三、注意事项

  • service层的方法在使用结构化管理输入/输出参数时,结构体中任意参数都将会被看做非必需参数。因此需要根据业务场景合理评估可行性。