6.3 Spring与MyBatis框架整合实现

欢迎进入Spring与MyBatis整合实战环节。本节基于任务二准备工作，通过七大核心步骤完成从配置到测试的全流程整合，严格遵循教材《JavaEE企业级应用项目开发》规范，包含完整配置文件、代码实现和测试验证，最终实现具备用户查询功能的整合案例。学习目标与技术路线掌握整合四要素：数据源配置、SqlSessionFactory构建、Mapper扫描、事务管理。实现全流程编码：实体类→Mapper→Service→测试类。排查常见问题：培养工程严谨性。技术路线图：环境检查→核心配置→代码开发→事务配置→测试验证。步骤1——数据源深度配置（Druid）数据源是整合基石，采用Druid连接池实现监控与性能优化。配置文件：spring-dao.xml核心参数：driverClassName,url,username,password连接池参数：initialSize=5,minIdle=5,maxActive=20关键参数：validationQuery（连接校验SQL）、testWhileIdle（空闲校验）Druid监控：http://localhost:8080/druid步骤2——SqlSessionFactory高级配置SqlSessionFactory是MyBatis核心，需配置映射文件与别名。配置文件spring-dao.xml核心配置dataSource,typeAliasesPackage（实体类包扫描）,mapperLocations（映射文件路径）插件集成PageInterceptor（helperDialect=mysql），无需手动编写LIMIT常见错误MapperLocations路径错误导致BindingException步骤3——Mapper接口与XML映射数据访问层实现接口与SQL分离。UserMapper接口：包含findById,findAll等数据操作方法。XML映射文件：namespace需与接口全路径一致，resultType推荐使用别名。文件路径：接口(src/main/java/com/cqcvc/dao/UserMapper.java)、XML(src/main/resources/com/cqcvc/mapper/UserMapper.xml)。步骤4——Mapper扫描与依赖注入Spring通过MapperScannerConfigurer自动生成代理对象，将MyBatis的Mapper接口与SpringIoC容器无缝集成。配置文件：spring-dao.xml核心配置：basePackage（接口包路径）,sqlSessionFactoryBeanNameService层注入：@Autowired注入UserMapper代理对象常见错误：Noqualifyingbean时检查接口扫描范围及方法与XML映射匹配步骤5——事务管理器配置Spring声明式事务确保数据一致性。配置文件：spring-tx.xml核心配置：定义transactionManager和tx:annotation-drivenService层注解：@Transactional(propagation=REQUIRED,rollbackFor=Exception.class)测试验证：故意抛出异常后数据库数据应回滚步骤6——实体类与数据库表映射实体类需与数据库表字段严格对应，以确保数据的正确持久化与读取。User实体类使用Lombok的@Data注解，自动生成getter、setter等方法。包含id,username,password属性。数据库表结构创建users表，包含字段：id(INT,主键),username(VARCHAR(50)),password(VARCHAR(50))。Lombok依赖需在pom.xml中添加Lombok依赖，并在IDE中安装Lombok插件以支持注解处理。步骤7——测试类编写与验证JUnit测试验证整合结果。测试类：MyBatisSpringTest核心注解：@RunWith,@ContextConfiguration注入测试：注入UserService测试findById方法验证要点：连接成功、方法执行、事务回滚文件路径：src/test/java/com/cqcvc/test/MyBatisSpringTest.java整合案例——用户查询功能实现完整案例实现根据ID查询用户功能，包含四层架构。核心架构实体层：User.javaDAO层：UserMapper接口+XMLService层：UserService接口及实现类测试层：MyBatisSpringTest.java运行流程测试类ServiceMapperSQL执行返回User对象常见错误与解决方案（上）ClassNotFoundException错误原因：驱动类名错误或未引入数据库驱动包。解决方案：确认驱动类名为com.mysql.cj.jdbc.Driver(MySQL8+版本)，并检查项目依赖中是否包含正确的JDBC驱动。Invalidboundstatement(notfound)错误原因：Mapper接口与XML文件中的SQL语句映射不匹配。解决方案：检查Mapper接口的namespace是否正确，方法名是否与XML中的<select>等标签的id一致，以及XML文件的存放路径是否符合MyBatis的扫描规则。Noqualifyingbeanoftype[...]found错误原因：Spring容器未扫描到Mapper接口，导致无法创建对应的Bean。解决方案：在Spring配置类或启动类上，通过@MapperScan注解确认basePackage属性的值包含了所有DAO/Mapper接口所在的包路径。常见错误与解决方案（下）事务不回滚：检查是否抛RuntimeException、@Transactional是否在public方法、是否开启<tx:annotation-driven/>Druid连接超时：增加validationQuery和testWhileIdle参数依赖冲突：使用mvndependency:tree排查，排除低版本依赖推荐：MyBatis-PlusGenerator自动生成代码。整合效果验证与优化功能验证：测试所有CRUD方法，验证事务回滚性能优化：开启MyBatis二级缓存(<cache/>)，优化SQL(避免SELECT*,添加索引)安全加固：数据库密码加密(Druid支持)，参数校验(SpringValidation注解)优化案例：添加索引ALTERTABLEusersADDINDEXidx_username(username);整合总结与扩展核心要点：整合四步曲(数据源→SqlSessionFactory→Mapper扫描→事务管理)关键文件：spring-dao.xml,UserMapper.xml,perties扩展方向：读写