1. 从零开始理解一对一关联查询刚接触OA系统开发时我最头疼的就是各种表单之间的数据关联。比如立项申请需要关联具体项目信息每次都要来回切换页面查询效率特别低。后来发现Mybatis的一对一关联查询能完美解决这个问题今天就结合若依框架ruoyi-vue实战手把手教你实现这个功能。什么是一对一关联举个生活中的例子每个人有且只有一个身份证这就是典型的一对一关系。在OA系统中立项申请主表和项目信息子表也是这种关系——每个立项申请只对应一个具体项目。理解这个概念很重要因为后续所有代码都是围绕这个关系展开的。在技术实现层面我们需要三个关键要素数据库外键关联、Mybatis的association标签配置、以及前端Vue组件的数据绑定。这就像组装乐高积木每个部件都必须严丝合缝。下面我会用具体案例演示如何完成这个组装过程。2. 数据库设计与SQL语句编写2.1 表结构设计要点先来看我的实战项目中的表结构设计这是整个功能的基础。主表oa_establish立项申请中有一个关键字段project_id它就像一根绳子牢牢绑定了子表oa_project项目信息的主键。-- 主表立项申请 CREATE TABLE oa_establish ( establish_id bigint(20) NOT NULL COMMENT 主键ID, project_id bigint(20) NOT NULL COMMENT 项目ID, remark varchar(256) DEFAULT NULL COMMENT 备注, PRIMARY KEY (establish_id) ) COMMENT立项申请表; -- 子表项目信息 CREATE TABLE oa_project ( project_id bigint(20) NOT NULL COMMENT 主键ID, pro_title varchar(128) DEFAULT COMMENT 项目名称, pro_number varchar(64) DEFAULT COMMENT 项目编号, PRIMARY KEY (project_id) ) COMMENT项目信息表;这里有个设计细节容易踩坑主表的project_id字段类型必须和子表主键完全一致。我有次项目就因为一个用bigint一个用int导致关联查询失败排查了半天才发现问题。2.2 关联查询SQL优化实际开发中我推荐使用LEFT JOIN而不是INNER JOIN这样可以确保即使没有关联项目也能返回主表数据。下面是优化后的SQLSELECT e.establish_id, e.project_id, e.remark, p.pro_title, p.pro_number FROM oa_establish e LEFT JOIN oa_project p ON e.project_id p.project_id WHERE e.establish_id #{establishId}特别注意字段别名设置如e.、p.这在后续Mybatis映射时会非常有用。我习惯用表名首字母作为别名既简洁又能避免字段冲突。3. 若依代码生成器的妙用3.1 快速生成基础代码若依框架的代码生成器真是开发者的福音。我通常这样操作在ruoyi-admin模块的系统工具→代码生成页面导入表勾选生成关联对象选项这个很关键调整字段显示顺序和表单类型下载zip包并解压到对应模块生成器会自动创建Controller、Service、Mapper和Vue组件文件。不过要注意它生成的是一套基础CRUD代码关联查询还需要我们手动增强。3.2 生成代码后的结构调整生成的实体类需要手动添加关联属性。比如在OaEstablish.java中增加public class OaEstablish { // 其他字段... /** 关联项目对象 */ private OaProject project; public OaProject getProject() { return project; } public void setProject(OaProject project) { this.project project; } }这里有个小技巧属性名最好和关联表的实体类名保持一致这样在Mybatis配置时会更直观。我见过有人用projectInfo这样的命名虽然也能用但不够规范。4. Mybatis映射文件深度配置4.1 association标签详解这是实现关联查询的核心配置。在OaEstablishMapper.xml中resultMap idOaEstablishResult typeOaEstablish id propertyestablishId columnestablish_id/ result propertyprojectId columnproject_id/ !-- 其他字段映射 -- association propertyproject javaTypeOaProject id propertyprojectId columnproject_id/ result propertyproTitle columnpro_title/ result propertyproNumber columnpro_number/ /association /resultMap几个关键点property对应实体类中的关联属性名javaType指定关联对象的完整类路径子标签映射关联表的字段4.2 动态查询语句优化实际项目中我们往往需要带条件的关联查询。这是我常用的动态SQL写法select idselectEstablishWithProject resultMapOaEstablishResult SELECT e.*, p.pro_title, p.pro_number FROM oa_establish e LEFT JOIN oa_project p ON e.project_id p.project_id where if testestablishId ! null AND e.establish_id #{establishId} /if if testproject.proTitle ! null and project.proTitle ! AND p.pro_title LIKE CONCAT(%, #{project.proTitle}, %) /if /where /select这种写法支持根据项目名称模糊查询立项申请非常实用。注意条件判断中的project.proTitle写法这是访问嵌套对象属性的语法。5. 前端Vue组件数据展示5.1 表格列配置技巧在ruoyi-vue生成的list.vue文件中修改columns配置columns: [ // 其他列... { label: 项目名称, prop: project.proTitle, align: center }, { label: 项目编号, prop: project.proNumber, align: center } ]重点在于prop属性的对象.属性写法这表示要显示嵌套对象的属性值。若依框架会自动处理这种数据结构。5.2 表单联动实现在编辑表单时我通常会添加项目选择器el-form-item label关联项目 propprojectId el-select v-modelform.projectId filterable clearable changehandleProjectChange el-option v-foritem in projectOptions :keyitem.projectId :labelitem.proTitle :valueitem.projectId / /el-select /el-form-item配套的handleProjectChange方法可以同步显示项目详情handleProjectChange(projectId) { if (projectId) { getProject(projectId).then(response { this.form.project response.data; }); } else { this.form.project {}; } }6. 实战中的性能优化6.1 延迟加载策略当关联数据较大时建议启用延迟加载。在mybatis-config.xml中添加settings setting namelazyLoadingEnabled valuetrue/ setting nameaggressiveLazyLoading valuefalse/ /settings然后在association标签中添加fetchTypelazyassociation propertyproject javaTypeOaProject fetchTypelazy !-- 字段映射 -- /association这样只有实际访问project属性时才会执行关联查询大幅提升列表查询速度。6.2 缓存机制应用对于不常变动的项目信息可以添加二级缓存。在mapper接口上添加注解CacheNamespace(implementation MybatisRedisCache.class, eviction MybatisRedisCache.class) public interface OaEstablishMapper { // 方法定义 }记得在实体类上实现Serializable接口。我在一个2000立项的项目中使用这个方案查询性能提升了近10倍。7. 常见问题排查指南7.1 关联数据为null的排查经常有开发者反馈关联对象获取不到通常检查以下几点确认SQL语句的JOIN条件正确检查resultMap中的字段名是否与SQL查询的列名完全匹配包括大小写验证实体类的setter方法是否被正确调用查看Mybatis日志输出的实际执行SQL7.2 字段冲突解决方案当主表和子表有同名字段时必须在SQL中使用别名区分SELECT e.project_id AS establish_project_id, p.project_id AS project_project_id FROM oa_establish e JOIN oa_project p ON e.project_id p.project_id然后在resultMap中引用对应的别名result propertyprojectId columnestablish_project_id/ association propertyproject javaTypeOaProject id propertyprojectId columnproject_project_id/ /association这种问题在复杂关联查询中很常见建议养成使用表别名前缀的习惯。