Skip to content

Java命名规范:先学习再超越

Mapper(持久层)

分页&列表(2合1)

shell
# 命名规则
query{TableSimpleName}By{ParamName}

# 示例
queryUserByArgs
queryHostByArgs

分页查询

shell
# 命名规则
query{TableSimpleName}PageBy{ParamName}

# 示例
queryUserPageByArgs
queryUserPageByUserId

查询列表

shell
# 命名规则
query{TableSimpleName}ListBy{ParamName}

# 示例
queryUserListByArgs
queryUserListByUserId

查询一个

shell
# 命名规则
get{TableSimpleName}By{ParamName}

# 示例
getUserByUserId
getUserByArgs

新增

shell
# 命名规则
insert{TableSimpleName}With{ParamName}

# 示例
insertUser

批量新增

shell
# 命名规则
insert{Batch}{TableSimpleName}With{ParamName}

# 示例
insertBatchUser
insertBatchUserWithDeptId

更新

shell
# 命名规则
update{ParamName}ById

# 示例
updateHostNameById
updateUserNameById

批量更新

shell
# 命名规则
update{ParamName}ByIds

# 示例
updateHostNameByIds
updateHostIpByIds

删除

shell
# 命名规则
delete{TableSimpleName}ById

# 示例
deleteHostById
deleteUserById

批量删除

shell
# 命名规则
delete{TableSimpleName}ByIds

# 示例
deleteHostByIds
deleteUserByIds

统计数量

shell
# 命名规则
get{具体语义}CountBy{ParamName}

# 示例
getUserOnlineCount
getUserTotalCountBySex

Service(业务层)

分页&列表(2合1)

shell
# 命名规则
describe{TableSimpleName}

# 示例
describeUserArgs
describeHostArgs

分页查询

shell
# 命名规则
describe{TableSimpleName}Page

# 示例
describeUserPage
describeHostPage

查询列表

shell
# 命名规则
describe{TableSimpleName}List

# 示例
describeUserList
describeHostList

查询元数据

shell
# 命名规则
describe{TableSimpleName}{AttributeName}MetadataOptions

# 示例
describeHostIpMetadataOptions
describeUserSexMetadataOptions

保存

shell
# 命名规则
save{TableSimpleName}

# 示例
saveHost
saveUser

修改

shell
# 命名规则
modify{TableSimpleName}{AttributeName}

# 示例
modifyHost
modifyUser
modifyHostIp
modifyUserSex

删除

shell
# 命名规则
remove{TableSimpleName}ById

# 示例
removeHostById
removeUserById

批量删除

shell
# 命名规则
remove{TableSimpleName}ByIds

# 示例
removeHostByIds
removeUserByIds

执行业务

shell
# 命名规则
{action}{TableSimpleName}{s}

# 示例
createInstance 创建实例
createInstances 批量创建实例
startInstance 启动实例
stopInstance 停止实例
rebootInstance 重启实例
renewInstance 续费实例
reActiveInstance 激活实例

# 业务动词(参考)
create 创建
delete 删除
modify 修改
scale 扩容
attach 追加
remove 移除
upgrade 升级
sync 同步
install 安装
unInstall 卸载
grant 授权
pause 暂停
cancel 取消
resume 重新开始
check 检查
deploy 部署

Controller(用户层)

shell
# 命名规则
与Service层的命名规则对齐

参数模型

  • 内部静态类 (不推荐,swagger识别不了)
  • Controller请求参数,XXXXRequest,返回值XXXXRequest 或 XXXXResponse
  • 三方服务返回的数据,XXXXModel
  • Mapper接收的一定是entity,TableName标识的类