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

作者:Odboy (opens new window)

本站地址:https://blog.odboy.cn (opens new window)

# Mapper(持久层)

# 分页&列表(2合1)

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

# 示例
queryUserByArgs
queryHostByArgs
代码已复制
1
2
3
4
5
6

# 分页查询

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

# 示例
queryUserPageByArgs
queryUserPageByUserId
代码已复制
1
2
3
4
5
6

# 查询列表

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

# 示例
queryUserListByArgs
queryUserListByUserId
代码已复制
1
2
3
4
5
6

# 查询一个

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

# 示例
getUserByUserId
getUserByArgs
代码已复制
1
2
3
4
5
6

# 新增

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

# 示例
insertUser
代码已复制
1
2
3
4
5

# 批量新增

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

# 示例
insertBatchUser
insertBatchUserWithDeptId
代码已复制
1
2
3
4
5
6

# 更新

# 命名规则
update{ParamName}ById

# 示例
updateHostNameById
updateUserNameById
代码已复制
1
2
3
4
5
6

# 批量更新

# 命名规则
update{ParamName}ByIds

# 示例
updateHostNameByIds
updateHostIpByIds
代码已复制
1
2
3
4
5
6

# 删除

# 命名规则
delete{TableSimpleName}ById

# 示例
deleteHostById
deleteUserById
代码已复制
1
2
3
4
5
6

# 批量删除

# 命名规则
delete{TableSimpleName}ByIds

# 示例
deleteHostByIds
deleteUserByIds
代码已复制
1
2
3
4
5
6

# 统计数量

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

# 示例
getUserOnlineCount
getUserTotalCountBySex
代码已复制
1
2
3
4
5
6

# Service(业务层)

# 分页&列表(2合1)

# 命名规则
describe{TableSimpleName}

# 示例
describeUserArgs
describeHostArgs
代码已复制
1
2
3
4
5
6

# 分页查询

# 命名规则
describe{TableSimpleName}Page

# 示例
describeUserPage
describeHostPage
代码已复制
1
2
3
4
5
6

# 查询列表

# 命名规则
describe{TableSimpleName}List

# 示例
describeUserList
describeHostList
代码已复制
1
2
3
4
5
6

# 查询元数据

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

# 示例
describeHostIpMetadataOptions
describeUserSexMetadataOptions
代码已复制
1
2
3
4
5
6

# 保存

# 命名规则
save{TableSimpleName}

# 示例
saveHost
saveUser
代码已复制
1
2
3
4
5
6

# 修改

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

# 示例
modifyHost
modifyUser
modifyHostIp
modifyUserSex
代码已复制
1
2
3
4
5
6
7
8

# 删除

# 命名规则
remove{TableSimpleName}ById

# 示例
removeHostById
removeUserById
代码已复制
1
2
3
4
5
6

# 批量删除

# 命名规则
remove{TableSimpleName}ByIds

# 示例
removeHostByIds
removeUserByIds
代码已复制
1
2
3
4
5
6

# 执行业务

# 命名规则
{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 部署
代码已复制
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

# Controller(用户层)

# 命名规则
与Service层的命名规则对齐
代码已复制
1
2

# 参数模型

  • 内部静态类 (不推荐,swagger识别不了)
  • Controller请求参数,XXXXRequest,返回值XXXXRequest 或 XXXXResponse
  • 三方服务返回的数据,XXXXModel
  • Mapper接收的一定是entity,TableName标识的类
最近更新: 2025-04-21
2017 - 2025 武林秘籍   |   赣ICP备17011078号