数据状态中的“待Xx”如何命名?
先看一组数据状态↓
红包发放状态:待领取
支付单状态: 待支付
订单状态:待发货
Bosskg订单核验状态:待核验
这些“待Xxx”的状态,我们在开发时如何命名呢?用TO_Xxx 还是用 UNXxx?
基本释义:
- To表示to do sth,等待做某事
- Un表示未做/不做。
例如:to pay表示“等待支付”, unpaid表示“未支付”
从构词难度上来阐述,
- To直接跟动词原形。
- 而un-就不那么容易了, 例如:unpay 属于“自造词”,有些不伦不类。实际上un应该跟动词过去分词,unpay→unpaid,对于英语水平普遍一般的程序员来说,这要求可就高了。
因此,我认为,表示“待Xx”我们就用to-来表示吧。简简单单的,多好。
红包发放状态:待领取 |
to_accept |
支付单状态: 待支付 |
to_pay |
订单状态:待发货 |
to_deliver |
Bosskg订单核验状态:待核验 |
to_verify / to_check |
不认可?
也许你觉得应该用unXxx。那么,让我来试图说服你。
我们在研发管理中,项目中的每一个工作任务都有3个关键的状态:TODO/DOING/DONE,意即待办/进行中/已完成。这是常见的任务状态标识,被广泛应用于各种项目管理工具和方法中,如看板式任务管理系统(如Kanban)或敏捷项目管理方法(如Scrum)。一些项目管理工具,例如worktile、zentao,都提供了TODOLIST(待办事项列表)看板,用于跟踪和管理个人或团队的待办任务事项。工作任务还有特殊情况,例如任务延期,任务因故未做。注意到了吗?这里的“未做”状态,就是UNDONE。 由此,你可以看出来 TODO 与 UNDONE 是不同的。
注意上面“项目管理”例子中的 UNDONE, 是不能换成 UNDO的。 "Undone" 和 "undo" 是两个不同的词汇。"Undone"是一个形容词,表示未完成、未完成的、未解决的状态。"Undo"是一个动词,强调的是对之前的行动或操作进行反向操作,以恢复到之前的状态。mysql数据库里的undolog就是这个意思。
提到TODO,作为java程序员,你一定使用过javadoc里的TODO标记。TODO是一种开发者常用的注释标记,用于提醒自己或其他开发人员在代码中有待完成的任务或功能。我们的开发工具(IDE)都提供了一个专门的TODO视窗或面板,用于显示代码中包含的"TODO"标记。
最后,BTW一下,我司商户API中,将微信红包发放状态的“待领取”状态命名为UNCLAIMED,不妥。claim-声称,unclaimed-无人认领的。 定义为 to_accept 更易懂。
当看到一些不好的代码时,会发现我还算优秀;当看到优秀的代码时,也才意识到持续学习的重要!--buguge
本文来自博客园,转载请注明原文链接:https://www.cnblogs.com/buguge/p/18086120