仔细选择方法名称:
- 名称必须遵循约定(第 68 条)。
- 优先考虑易于理解且与包和普遍共识一致的名称。
- 避免长名称。
不要用方便的方法夸大:
- 每种方法都必须“完成自己的部分工作”。
- 许多方法使得 API 的使用、维护和文档化变得困难。
- 仅在经常使用时提供缩写方法。
避免长参数列表:
- 限制为四个或更少的参数。
- 长列表很难记住并且容易出错。
- 相同类型的参数按顺序排列可能会造成混乱。
减少长参数列表的三种技巧:
- 将方法分成几个更小的方法。
- 为参数组创建辅助类。
- 对具有许多参数的方法使用构建器模式,尤其是可选参数。
在参数中优先选择接口而不是类:
- 使用 Map 等接口而不是 HashMap 等特定类以获得更大的灵活性。
在参数中更喜欢枚举而不是布尔值:
- 枚举使代码更具可读性,并有助于将来扩展选项,如带有温标的温度计的示例。
- 这些实践有助于创建更易于使用且不易出错的 API。
以上是项目设计方法签名仔细的详细内容。更多信息请关注PHP中文网其他相关文章!