当前位置: 首页 > news >正文

关于select所有情况,阿里巴巴的命名是咋样的

阿里巴巴 Select 查询命名规范大全

1. 基础命名模式

核心公式:动词 + 名词 + 限定条件 + 返回类型

部分阿里巴巴常用词示例
动词select,find,get,queryselect(最正式)
名词表名或实体名User,Order,Product
限定ByXxx,ByXxxAndYyy,ForXxxById,ByNameAndStatus
返回可省略,或加List,Page,CountList,Page,One,Count

2. 各种场景的具体命名

场景1:单条记录查询

// 根据ID查询UserDOselectById(@Param("id")Longid);UserDOfindById(@Param("id")Longid);UserDOgetById(@Param("id")Longid);// 根据唯一键查询UserDOselectByUsername(@Param("username")Stringusername);UserDOselectByEmail(@Param("email")Stringemail);UserDOselectByMobile(@Param("mobile")Stringmobile);// 查询单个字段值StringselectNameById(@Param("id")Longid);IntegerselectStatusById(@Param("id")Longid);

场景2:列表查询

// 查询所有List<UserDO>selectAll();List<UserDO>findAll();List<UserDO>listAll();// 条件查询列表List<UserDO>selectByStatus(@Param("status")Integerstatus);List<UserDO>selectByDeptId(@Param("deptId")LongdeptId);List<UserDO>selectByNameLike(@Param("name")Stringname);// 多条件查询List<UserDO>selectByStatusAndDeptId(@Param("status")Integerstatus,@Param("deptId")LongdeptId);List<UserDO>selectByCreateTimeBetween(@Param("startTime")DatestartTime,@Param("endTime")DateendTime);

场景3:分页查询

// 分页查询所有Page<UserDO>selectPage(Page<UserDO>page);// 条件分页查询Page<UserDO>selectPageByStatus(Page<UserDO>page,@Param("status")Integerstatus);Page<UserDO>selectPageByCondition(Page<UserDO>page,@Param("condition")UserQueryConditioncondition);

场景4:统计查询

// 计数LongselectCount();Integercount();LongcountAll();// 条件计数LongselectCountByStatus(@Param("status")Integerstatus);LongcountByDeptId(@Param("deptId")LongdeptId);// 存在性检查BooleanexistsByUsername(@Param("username")Stringusername);BooleanexistsByEmail(@Param("email")Stringemail);

场景5:Map格式查询

// 单条MapMap<String,Object>selectAsMapById(@Param("id")Longid);Map<String,Object>selectUserMap(@Param("id")Longid);// 列表MapList<Map<String,Object>>selectListAsMaps();List<Map<String,Object>>selectMapsByStatus(@Param("status")Integerstatus);List<Map<String,Object>>selectAllAsMaps();// 指定字段MapList<Map<String,Object>>selectIdAndNameAsMaps();List<Map<String,Object>>selectSimpleInfoAsMaps();

3. 你的业务场景专用命名

飞行数据相关查询

// 基础查询List<FlightDataDO>selectByFlightRecordId(@Param("flightRecordId")LongflightRecordId);List<FlightDataDO>selectByRecordIdAndType(@Param("recordId")LongrecordId,@Param("dataType")StringdataType);// Map格式List<Map<String,Object>>selectFlightDataAsMaps(@Param("flightRecordId")LongflightRecordId);List<Map<String,Object>>selectHeightDataAsMaps(@Param("flightRecordId")LongflightRecordId);List<Map<String,Object>>selectSpeedDataAsMaps(@Param("flightRecordId")LongflightRecordId);// 统计LongcountByFlightRecordId(@Param("flightRecordId")LongflightRecordId);Map<String,Object>selectStatsByFlightRecordId(@Param("flightRecordId")LongflightRecordId);

告警规则相关查询

// 规则查询List<AlarmRuleDO>selectByConfigId(@Param("configId")LongconfigId);List<AlarmRuleDO>selectEnabledByConfigId(@Param("configId")LongconfigId);List<AlarmRuleDO>selectByConfigIdAndType(@Param("configId")LongconfigId,@Param("ruleType")StringruleType);// Map格式List<Map<String,Object>>selectRulesAsMaps(@Param("configId")LongconfigId);Map<String,List<Map<String,Object>>>selectRulesGroupByType(@Param("configId")LongconfigId);

告警分析业务查询

// 分析相关List<Map<String,Object>>selectForAlarmAnalysis(@Param("configId")LongconfigId,@Param("flightRecordId")LongflightRecordId);List<Map<String,Object>>selectAnalysisResult(@Param("analysisId")StringanalysisId);Page<Map<String,Object>>selectAnalysisHistory(Page<?>page,@Param("query")AnalysisQueryquery);

4. 阿里巴巴内部特殊命名

复杂查询命名

// 联表查询List<UserWithDeptDO>selectUserWithDeptByUserId(@Param("userId")LonguserId);List<Map<String,Object>>selectUserJoinDept(@Param("deptId")LongdeptId);// 嵌套查询List<UserDO>selectWithSubQuery(@Param("minOrderCount")IntegerminOrderCount);// 聚合查询Map<String,Object>selectUserStats(@Param("deptId")LongdeptId);List<Map<String,Object>>selectGroupByDept();// 窗口函数List<Map<String,Object>>selectWithRank(@Param("deptId")LongdeptId);

批量查询命名

// IN查询List<UserDO>selectByIds(@Param("ids")List<Long>ids);List<UserDO>selectByUsernames(@Param("usernames")List<String>usernames);// 批量Map查询List<Map<String,Object>>selectMapsByIds(@Param("ids")List<Long>ids);Map<Long,UserDO>selectMapByIds(@Param("ids")List<Long>ids);// 返回Map结构

5. 阿里巴巴的命名约定俗成

前缀约定

// select 系列(最规范)UserDOselectById(Longid);List<UserDO>selectListByStatus(Integerstatus);// find 系列(查询语义)UserDOfindById(Longid);List<UserDO>findAll();// get 系列(获取语义)UserDOgetById(Longid);List<UserDO>getAll();// query 系列(复杂查询)Page<UserDO>queryPage(UserQueryquery);List<UserDO>queryByCondition(UserConditioncondition);

后缀约定

// List - 返回列表List<UserDO>selectListByDeptId(LongdeptId);// Page - 返回分页Page<UserDO>selectPageByStatus(Page<?>page,Integerstatus);// Count - 返回数量LongselectCountByStatus(Integerstatus);// One - 返回单个UserDOselectOneByUsername(Stringusername);// Map - 返回Map格式Map<String,Object>selectMapById(Longid);List<Map<String,Object>>selectMapListByStatus(Integerstatus);

6. 实战中的最佳实践

原则1:保持一致性

// ✅ 好:统一风格UserDOselectById(Longid);List<UserDO>selectByStatus(Integerstatus);Page<UserDO>selectPage(Page<UserDO>page);// ❌ 不好:风格混乱UserDOgetById(Longid);List<UserDO>findListByStatus(Integerstatus);Page<UserDO>queryPage(Page<UserDO>page);

原则2:方法名自解释

// ✅ 好:清晰明了List<UserDO>selectByDeptIdAndStatus(LongdeptId,Integerstatus);UserDOselectByUsernameAndPassword(Stringusername,Stringpassword);// ❌ 不好:模糊不清List<UserDO>selectUsers(LongdeptId,Integerstatus);// 参数意义不明UserDOselectUser(Stringparam1,Stringparam2);// 参数名无意义

原则3:避免过长

// ✅ 好:适中长度List<UserDO>selectByDeptId(LongdeptId);UserDOselectByUsername(Stringusername);// ❌ 不好:过长List<UserDO>selectAllUserRecordsByDepartmentIdentifier(LongdeptId);// 太长了!

7. 你的业务完整示例

@MapperpublicinterfaceFlightDataMapperextendsBaseMapper<FlightDataDO>{// === 基础查询 ===FlightDataDOselectById(Longid);List<FlightDataDO>selectByFlightRecordId(LongflightRecordId);List<FlightDataDO>selectByRecordIdAndType(LongrecordId,StringdataType);// === Map格式查询 ===Map<String,Object>selectMapById(Longid);List<Map<String,Object>>selectMapsByFlightRecordId(LongflightRecordId);List<Map<String,Object>>selectSimpleMapsByRecordId(LongrecordId);// === 统计查询 ===LongcountByFlightRecordId(LongflightRecordId);IntegercountByRecordIdAndType(LongrecordId,StringdataType);Map<String,Object>selectStatsByFlightRecordId(LongflightRecordId);// === 存在性检查 ===BooleanexistsBySeqIdAndRecordId(IntegerseqId,LongflightRecordId);// === 分页查询 ===Page<FlightDataDO>selectPageByRecordId(Page<FlightDataDO>page,LongflightRecordId);Page<Map<String,Object>>selectMapPageByRecordId(Page<?>page,LongflightRecordId);// === 批量查询 ===List<FlightDataDO>selectBySeqIds(@Param("recordId")LongrecordId,@Param("seqIds")List<Integer>seqIds);Map<Integer,FlightDataDO>selectMapBySeqIds(@Param("recordId")LongrecordId,@Param("seqIds")List<Integer>seqIds);// === 业务专用查询 ===List<Map<String,Object>>selectForAlarmAnalysis(LongflightRecordId);List<Map<String,Object>>selectHeightDataForAnalysis(LongflightRecordId);List<Map<String,Object>>selectSpeedDataForAnalysis(LongflightRecordId);// === 扩展查询 ===List<Map<String,Object>>selectWithFlightRecord(LongflightRecordId);List<Map<String,Object>>selectDetailByRecordId(LongflightRecordId);}

8. 阿里巴巴的黄金法则

记住这几点:

  1. select开头- 最规范
  2. 名词用实体名-User,Order,Product
  3. 条件用ByXxx-ById,ByStatus
  4. 返回类型可暗示-List,Page,Count
  5. Map格式加AsMapsMap- 可选

快速决策树:

要查什么? ├── 单条记录 → selectById / selectByXxx ├── 多条记录 → selectListByXxx / selectByXxx (返回List) ├── 分页 → selectPageByXxx ├── 统计 → selectCountByXxx / countByXxx ├── 存在 → existsByXxx ├── Map格式 → selectAsMapsByXxx / selectMapByXxx └── 复杂业务 → selectFor[业务场景]ByXxx

对于你的selectFlightDataListByRecordId

  • ✅ 是阿里巴巴标准命名
  • 如果要加关联表,建议:selectFlightDataWithFlightRecordByRecordId
http://www.cnnetsun.cn/news/111427.html

相关文章:

  • 打造极速构建体验:BuildKit配置文件深度调优实战
  • 从线上事故看 Java 系统的真实韧性:为什么它总能撑到最后一刻
  • AI Agent框架终极部署指南:从零到生产环境的完整路径
  • 前端性能优化终极指南:让文件转换体验如丝般顺滑
  • 3步彻底解决Dokploy中.traefik.me证书失效问题
  • MCP AI-102模型评估指标全曝光:为什么你的F1-score总是偏低?
  • 量子模拟器环境搭建陷阱与解决方案(90%新手都会犯的3个错误)
  • 【仅限专业人士】量子机器学习调试内幕(VSCode高级功能首次公开)
  • Monet色彩系统如何让Seal视频下载器实现完美的主题一致性
  • 超强Visio形状库:告别绘图瓶颈的终极解决方案
  • ITPUB 专访|李志宇:在 AGI 的未来版图中,记忆是最有温度的力量
  • 音频分离黑科技:3步实现智能多说话人识别
  • 如何快速掌握pose-search:人体姿态搜索的完整指南
  • Agent性能提升迫在眉睫?,立即掌握这3种Docker级性能加速黑科技
  • Note-Gen图片上传实战:从本地预览到云端同步的完整指南
  • VSCode调试Azure QDK API时总出错?这7个坑你必须避开
  • MCP续证Agent开发考核标准全曝光(权威解读+内部评分细则)
  • Android应用沙盒革命:VirtualApp如何重塑移动多开体验
  • 精通SynthDoG:实战构建百万级多语言文档数据集的完整指南
  • Docker MCP网关错误处理避坑指南:3年生产环境踩过的坑一次性说清
  • Golin网络安全扫描工具:从零开始的完整实战指南
  • 告别传统免疫:多肽文库筛选如何让CAR-T研发“快人一步”?
  • 终极gsplat.js指南:快速掌握3D高斯点渲染技术
  • PiKVM OS深度定制指南:从零打造专属远程管理平台
  • 学习笔记096——Windows postgreSQL-18.1[压缩包版本]
  • 终极思维助手:Sequential Thinking MCP Server打造结构化思考解决方案
  • 【高并发场景下的Agent服务稳定性保障】:基于Docker的百万级压测实录
  • 认知科学视角下的游戏化编程学习平台教学效果实证研究
  • 5步构建AI永久记忆系统:告别重复对话的智能助手
  • 终极文件预览神器:Peek如何让Windows文件查看体验焕然一新