第51条:谨慎设计方法签名

  • 谨慎地选择方法的名称。
    方法的名称应遵照标准命名习惯,应当是易于理解、风格一致的。
    这一点我目前的习惯是对于方法使用动宾短语,对于变量使用形容词+名词。当然选词时应该尽量贴近业务。
  • 不要过于追求提供便利的方法。
    方法太多会使类难以学习、使用、文档化、测试和维护。如果不能确定一个操作经常被用到,不要提供快捷方式。
    比如我最近遇到一个根据税号找客户的需求,因为并不常用,所以就没有提供快捷的访问方式。
  • 避免过长的参数列表。
    目标是4个或更少,相同类型的的长参数序列特别有害。减少参数可以通过以下三个方法:

1.分解方法。每个方法只需要参数的一个子集。
2.创建辅助类来存储参数。
3.运用builder模式。

这里我想到了之前创建接口消息记录时,初始化记录对象的方法,参数非常多,每次调用都非常谨慎,后来就是运用运用builder模式简化了。
另外就是当我们在使用IDE 自带的工具抽取方法时,一定要检查一下,参数能否再简化了,很多时候其实都是可以再进一步减少参数的。

  • 对于参数类型,优先使用接口不是类。
    这样可以使得入参接收更多的类型。

  • 对于boolean参数,优先使用两个元素的枚举类型。
    这样当我们需要从两态扩展到三态时,会更加轻松简单。

你可能感兴趣的:(第51条:谨慎设计方法签名)