美文网首页
编程5分钟,起名2小时——Java方法命名宝典

编程5分钟,起名2小时——Java方法命名宝典

作者: 小胖学编程 | 来源:发表于2022-01-05 18:25 被阅读0次

编程5分钟,起名2小时。

1. 场景实战

方法应该具有单一职责特效,通过一个比较好的命名来实现较高的可读性。即实现less is more。那么平时在开发中如何对一些常见的方法来进行命名?

方法命名采用小驼峰的形式,首字小写,往后的每个单词首字母都要大写。和类名不同的是,方法命名一般为动词或动词短语,与参数或参数名共同组成动宾短语,即动词 + 名词。一个好的函数名一般能通过名字直接获知该函数实现什么样的功能。

举几个常见的例子:

  1. 例如checkXxx或者validateXx方法,给人的职责便是校验业务,不推荐返回响应对象。
  2. find/getXxx返回值为应该为Collection<Xxx>,不推荐是boolean类型。
  3. 若方法响应值为boolean类型,方法的前缀推荐为exists/has/is等。
  4. find或者exists方法不推荐抛出异常,若未查询到推荐返回null。

1.1 方法的单一职责进行命名

下面可以看到一个“名不符实”的危害。

函数取名最忌讳的是"名不副实",举个例子,假如有个Cache类,里面有个函数判断key是否过期:

public boolean isExpired(String key) {
  // 当前时间戳
  long curTimestamp = DateUtils.nowUnixTime();
  // 获取key的存入时间戳
  long storeTimestamp = getStoreTimestamp(key);
        
  if (curTimestamp - storeTimestamp > MAX_EXPIRE_SECONDS) {
    // 注意这个地方的delete是个隐藏逻辑
    delete(key);
    return true;
  }
  return false;
 }

上面这个函数从函数字面意思看是判断key是否过期,但是!!它居然在函数里面隐藏了一段特殊逻辑:如果过期则删除掉key。这个就是典型的"名不副实",这个是最忌讳的,会给后续的开发人员留下"巨坑"。

有两种方式去优化这段代码:

方式一:将隐藏逻辑去掉

public boolean isExpired(String key) {
  // 当前时间戳
  long curTimestamp = DateUtils.nowUnixTime();
  // 获取key的存入时间戳
  long storeTimestamp = getStoreTimestamp(key);
        
  if (curTimestamp - storeTimestamp > MAX_EXPIRE_SECONDS) {
    return true;
  }
  return false;
 }

方式二:改变函数名字

public int deleteIfExpired(String key) {
  // 当前时间戳
  long curTimestamp = DateUtils.nowUnixTime();
  // 获取key的存入时间戳
  long storeTimestamp = getStoreTimestamp(key);
        
  if (curTimestamp - storeTimestamp > MAX_EXPIRE_SECONDS) {
    return delete(key);
  }
  return 0;
 }

1.2 取名面向目的(需求)而非过程

举例说明:

场景:小明可以将一份练习分享给小红,可以多次分享,但非首次分享的场景下直接返回分享成功。

方法命名:

  1. boolean findByUserIdAndSign(String sign,String targetUserId,List<Result> results);

find方法给人的感觉是查找数据,找到则返回,找不到则返回null,这里返回boolean很不友好。且有些面向过程的感觉,不知道这方法的目的是什么。

  1. boolean existsByUserIdAndSign(String sign,String targetUserId,List<Result> results);

exists方法是否存在,返回boolean值合适,但是命名偏面向过程的感觉,不知道这方法的目的是什么。

  1. boolean isShared(String sign,String targetUserId,List<Result> results);

is:是否存在,shared:是否被分享过。这就能准确的表述出该方法的目的(即产品需求)。但是缺点是:这个方法中有逻辑会填充result列表,但是命名中并未体现出。

(推荐)4. List<Result> getResultsIfShared(String sign,String targetUserId);

若照片被分享过,那么转化为Results对象输出,这个命名便可以体现出这个方法的目的和实际做的工作。

(思考)5. int addResultsIfShared(String sign,String targetUserId,List<Result> results)
前提:
[1] List<Result>作为入参,通过引用传递来修改内部值,以达到传递最终结果的目的;
[2] 需要boolean值的结果,来告诉main方法,该照片是否被分享过;

若照片被分享过,那么填充Results对象,填充成功返回1,填充失败返回0;

2. 使用

pre- prefix前缀,suf- suffix后缀,alo-alone 单独使用

2.1 返回真伪值的方法

若方法返回boolean类型,可以推荐使用如下的格式。

位置 单词 意义 例子
pre is 对象是否符合期待的状态 isValid
pre can 对象能否执行所期待的动作 canRemove
pre should 调用方执行某个命令 或方法是好还是不好应不应该,或者说推荐还是不推荐 shouldMigrate
pre has 对象/集合是否持有所期待的数据和属性 hasObservers
pre exists 对象/集合是否存在所期待的数据和属性 existsObservers
pre contains 判断集合是否保存某个元素 containsBeanDefinition
pre needs 调用方是否需要执行某个命令或方法 needsMigrate

2.2 检查的方法

位置 单词 意义 例子
pre ensure 检查是否为期待的状态 不是则抛出异常或返回error code ensureCapacity
pre validate/check 检查是否为正确的状态 不是则抛出异常或返回error code validateInputs

2.3 按需求才执行的方法

位置 单词 意义 例子
suf YyyIfXxx 如果发生了Xxx,则执行Yyy
suf IfNeed 需要的时候执行,不需要则什么都不做 drawIfNeed
pre might 同上 mightCreate
pre try 尝试执行 失败时抛出异常 或是返回errorcode tryCreate
suf OrDefault 尝试执行 失败时返回默认值 getOrDefault
suf OrElse 尝试执行 失败时返回 实际参数中指定的值 getOrElse
pre force 强制尝试执行 error抛出异常或是返回值 forceCreate, forceStop

2.4 与数据相关的方法

位置 单词 意义 例子 使用程度
pre make 借助多个对象来创建对象 makeAccountWithUserAndDept
pre create/new 新创建 newAccount
pre from 从既有的某物新建 或是从其他的数据新建 fromConfig
pre to 转换 toString
pre transformed 转换 transformedBeanName
pre save/store 保存 saveAccount
pre delete/remove 删除 deleteAccount
pre clear/reset 清除或恢复到初始状态 clearAll
pre update 更新 updateAccount

2.5 【重点】查询操作命名

位置 单词 意义 例子 使用程度
pre get 得到 getAccount
pre find/lookup 找到
pre resolve 解析得到(偏复杂逻辑)
pre compute 计算得到(耗CPU)
pre load 本地磁盘读取
pre fetch 网络读取
suf IfAbsent 存在时缓存读取缓存,否则去“获取” fetchAccountIfAbsenet
suf FromCache 只读取缓存读取

2.6 常用的成对动词

单词 意义
resolve 解析/compute 计算 get、find找到
find 查找 lookup 搜索
split分割 merge合并/combine 使...结合
inject注入 extract提取
increase 增加 decrease 减少
encode 编码 decode 解码
encrypt 加密 decrypt 解密
encode 编码 decode 解码
parse 解析 emit 生成
bind 绑定 separate 分离
backup 备份 restore 恢复
reorderXxxToEnd 将Xxx重排序填充到最后

2.7 介词

单词 意义 举例 说明
from 从...创建 Xxx fromConfig() 从Config对象中创建Xxx对象
to 转化 toString(Xxx x) 将入参Xxx转化为String对象
of 从...中获取 pathOf(Xxx xxx) 从Xxx中获取path路径
with writeWithMessageConverters 使用MessageConverters进行写操作
by 通过 getStudentById 通过id获取Student对象
in 在...in isBeanNameInUse 确定给定的bean名称是否(已在此工厂中)使用
for 为了 getMappingForMethod 对于Method对象,来获取Mapping对象
within 在...内 getPathWithinApplication 在应用内获取路径
as 作为 getValuesAsList 将...转成List

3. 实战篇—介词用法

将Spring源码中找到一些使用介词的方法。

  • for语法

getMappingForMethod:在Method中获取Mapping对象;

getObjectForBeanInstance:在BeanInstance中获取Object对象;

getCachedObjectForFactoryBean:在FactoryBean中获取CachedObject;

isBeanEligibleForMetadataCaching:BeanEligible是否在MetadataCaching中;

getTypeForFactoryBean:在FactoryBean获取Type;

getLookupPathForRequest:对于Request对象,获取LookupPath属性;

  • from 语法

getObjectFromFactoryBean:从给定的FactoryBean获取要公开的对象。

setContentDispositionFormData:从Data对象来设置ContentDisposition对象。

  • in语法

isBeanNameInUse:确定给定的bean名称是否(已在此工厂中)使用,

isPrototypeCurrentlyInCreation:返回指定的原型bean当前是否正在创建中

  • with语法

writeWithMessageConverters:使用MessageConverters进行写操作

requestedType.isCompatibleWith(producibleType):【参数作为定语】requestedType是否和producibleType是可共用的。

  • to语法

HttpRange.toResourceRegions(httpRanges, resource); 静态方法:HttpRange转化为ResourceRegions对象。

reorderXmlConvertersToEnd(converters):将Xml格式转化器重排序放到最后;

  • within语法

getPathWithinServletMapping:在ServletMapping内,获取path路径;

个人总结:方法模板

  • getXxForYy:对于Yy对象来说,获取Xx对象;
  • getXxFromYy:从Yy对象中获取Xx对象,和getXxForYy等效。
  • getXxInUse:获取在“使用”中的Xx对象;
  • getXxWithinYy:在Yy内获取Xx对象;
  • writeWithXx:和(使用)Xx对象来进行write操作;

一个好的思路是:可以写一些英文注释,然后在这些英文注释中提取方法名。

推荐阅读

Java开发都需要参考的一份命名规范

工程实践:给函数取一个"好"的名字

编写可读代码的艺术-完整版(带书签)

相关文章

  • 编程时如何命名?

    编程中离不开命名。命名是指给变量、方法或函数、类、文件起名字。命名的最基本要求是,要遵守特定编程语言对命名的要求。...

  • 编程5分钟,起名2小时——Java方法命名宝典

    编程5分钟,起名2小时。 1. 概述 方法应该具有单一职责特效,通过一个比较好的命名来实现较高的可读性。即实现le...

  • J2SE的基础语法

    Java标示符 Java中对各种变量、方法、和类等要素命名是使用的字符序列为标示符,凡是自己可以起名的地方都叫标示...

  • Python_0基础:3.标识符和关键字

    3.1 命名规范 计算机编程语言中,标识符是用户编程时使用的名字,用于给变量、常量、函数、语句块等命名,以建立起名...

  • 一个深圳品牌策划人的自白 ---- 关于品牌商标起名

    深圳专业商标起名/品牌起名/品牌命名 Hi!我是来自深圳的品牌策划人/品牌商标起名师王垚。 关于品牌商标起名/命名...

  • 起名宝典

    安迪造福开运姓名学【你名字中有双姓吗?】名中有双姓氏,就是一种诅咒,很玄,但这是统计归纳出的一种规律。不仅不利婚姻...

  • 2020超全Java面试手册,总计167页,大厂技术真题整理

    金九银十已在当下,这边整理了一份2020最新的Java面试宝典,从Java基础部分、算法与编程、Java web部...

  • Java后台开发规范

    Java后台开发规范 1.Java编程规范 1.1.命名风格 代码中的命名均不能以下划线或美元符号开始,也不能以下...

  • 西安周易起名:女孩起名有哪些方法可借鉴

    西安周易起名:女孩起名有哪些方法可借鉴 1、以美的自然形容花草、色彩和气味的字命名。如美舒、秀荣、秋香、芳艳、彩虹...

  • 纸质计算机书

    1 Java Web编程实战宝典 2王道考研系列操作系统计算机组成原理数据结构计算机网络 3Java编程思想 4设...

网友评论

      本文标题:编程5分钟,起名2小时——Java方法命名宝典

      本文链接:https://www.haomeiwen.com/subject/zrohcrtx.html