3.4方法命名原则

创建于 2026 年 8 月 17 日约 1 分钟读完

在设计 HttpRequestBuilder 对象的方法时,我们遵循了一套明确的命名规则,以确保方法的功能和行为直观易懂。具体来说,所有只能进行操作的方法均以 SetUse 开头,而所有支持重复调用、进行叠加操作的方法则以 WithAdd 开头。

  • SetUse 开头的方法:这类方法用于设置某个属性或参数,若重复调用,则后一次调用会覆盖前一次的设置。例如,SetTraceIdentifier(traceId) 方法,在多次调用时,只有最后一次调用的 traceId 会生效。
  • WithAdd 开头的方法:这类方法用于添加或修改某些内容,且支持重复调用。在重复调用时,它们不会覆盖之前的设置,而是采用叠加的方式。例如,WithHeader(key, value) 方法,在多次调用时,会保留之前的所有头部信息,并添加新的头部信息。

这样的命名原则使得 HttpRequestBuilder 对象的方法更加清晰易懂,便于开发者在使用时快速理解每个方法的功能和行为。