buguge - Keep it simple,stupid

知识就是力量,但更重要的,是运用知识的能力why buguge?

导航

数据状态中的“待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 更易懂。

posted on 2024-03-20 21:17  buguge  阅读(52)  评论(0编辑  收藏  举报