3.4方法命名原则
创建于 2026 年 8 月 17 日约 1 分钟读完
在设计 HttpRequestBuilder 对象的方法时,我们遵循了一套明确的命名规则,以确保方法的功能和行为直观易懂。具体来说,所有只能进行操作的方法均以 Set 或 Use 开头,而所有支持重复调用、进行叠加操作的方法则以 With 或 Add 开头。
Set或Use开头的方法:这类方法用于设置某个属性或参数,若重复调用,则后一次调用会覆盖前一次的设置。例如,SetTraceIdentifier(traceId)方法,在多次调用时,只有最后一次调用的traceId会生效。With或Add开头的方法:这类方法用于添加或修改某些内容,且支持重复调用。在重复调用时,它们不会覆盖之前的设置,而是采用叠加的方式。例如,WithHeader(key, value)方法,在多次调用时,会保留之前的所有头部信息,并添加新的头部信息。
这样的命名原则使得 HttpRequestBuilder 对象的方法更加清晰易懂,便于开发者在使用时快速理解每个方法的功能和行为。