Java命名规范疑问:方法参数应当使用clinicId还是clinic_id?
Java方法参数命名规范解答
你的判断是正确的,常规Java开发场景下,方法参数应当使用clinicId而非clinic_id,使用clinic_id主要存在以下问题:
- 不符合Java官方命名约定:Java语言针对方法参数、局部变量、成员变量统一规定使用小驼峰(lowerCamelCase) 命名格式,即首个单词全小写,后续每个单词首字母大写。下划线分隔的蛇形命名法仅用于常量(全大写+下划线)、数据库字段名等特定场景,在业务代码的参数中使用蛇形命名属于违反通用规范的写法。
- 破坏项目代码一致性:Java生态下几乎所有主流开源项目、官方类库都遵循小驼峰命名规则,项目中混用蛇形命名的参数会和其他符合规范的代码风格割裂,增加后续维护人员的阅读理解成本。
- 可能引发序列化/反序列化异常:Jackson、Gson等常用JSON序列化框架默认按照小驼峰做字段映射,如果参数使用下划线命名且没有添加
@JsonProperty等注解做显式映射,很容易出现参数接收失败、序列化输出字段不符合预期的问题。
符合规范的代码修改后如下:
public ArrayList<User> getClinicDoctorList(int clinicId) throws SQLException{
特殊说明:如果你的项目有明确的全员约定的特殊规范,要求所有参数统一使用蛇形命名,可以遵循项目内部规范走,但绝大多数Java项目都不会设置这类违背通用生态的约定,默认优先遵循官方小驼峰规范即可。
内容的提问来源于stack exchange,提问作者abc
相关产品推荐
相关产品推荐

