读《代码整洁之道》- 函数名称应该表达其行为
2023-04-18 15:53:54 时间
一、背景
前一段时间听到周围有人认为:“函数名起的困惑无所谓,反正别人使用接口的时候也会看下源码的”,让我非常吃惊。
我一直也是认为,好的代码应该是看到函数名就应该知道含义,看到参数和返回值就应该可以放心使用,而不是非要去读源码才不会误用。
今天重读《代码整洁之道》,看到书中提到:函数名称应该表达其行为。
如果你必须查看函数的实现(或文档)才知道它是做什么的,就应该换个更好的函数名或者重新设计功能代码或者起个更贴切的名称。(原文翻译有些生硬,这里自己改了一下)
二、示例
比如只想查询用户的姓名、年龄、手机号,但是函数定义如下:
UserDO getUserSimpleById(Long id)
对应的SQL 语句如下:
<select id="getUserSimpleById" parameterType="java.lang.Long" resultMapping="baseResultMapping">
SELECT name,age,phone FROM user WHERE id = #{id}
</select>
由于返回值 UserDO
包含很多字段,调用该函数拿到 UserDO 之后不看对应的 SQL 语句很难确定哪些属性被赋值。
但是将函数名改为 getUserNameAgePhoneById
又显得很啰嗦,如果再查几个属性怎么办?
UserDO getUserNameAgePhoneById(Long id)
可以定义返回值只包含查询的字段,这样不容易用错:
UserSimpleDO getSimpleById(Long id)
三、总结
函数名和做的事情不一致,很容易对使用者造成误解。 我们定义函数签名时,包括函数名,参数以及返回值都要仔细斟酌,不可马虎大意。
相关文章
- 【技术种草】cdn+轻量服务器+hugo=让博客“云原生”一下
- CLB运维&运营最佳实践 ---访问日志大洞察
- vnc方式登陆服务器
- 轻松学排序算法:眼睛直观感受几种常用排序算法
- 十二个经典的大数据项目
- 为什么使用 CDN 内容分发网络?
- 大数据——大数据默认端口号列表
- Weld 1.1.5.Final,JSR-299 的框架
- JavaFX 2012:彻底开源
- 提升as3程序性能的十大要点
- 通过凸面几何学进行独立于边际的在线多类学习
- 利用行动影响的规律性和部分已知的模型进行离线强化学习
- ModelLight:基于模型的交通信号控制的元强化学习
- 浅谈Visual Source Safe项目分支
- 基于先验知识的递归卡尔曼滤波的代理人联合状态和输入估计
- 结合网络结构和非线性恢复来提高声誉评估的性能
- 最佳实践丨云开发CloudBase多环境管理实践
- TimeVAE:用于生成多变量时间序列的变异自动编码器
- 具有线性阈值激活的神经网络:结构和算法
- 内网渗透之横向移动 -- 从域外向域内进行密码喷洒攻击