第27章 最佳实践

学习MyBatis开发的最佳实践和经验总结 学习进度：100% 代码演示按钮 💻 查看完整代码 - 在线IDE体验

🛠️ 技术栈

☕

Spring Boot

v2.7.0 🗃️

MyBatis

v3.5.10 🐬

MySQL

v8.0 🔧

Maven

v3.8.6 🚀

Druid

v1.2.11

🎯 学习目标

📋

最佳实践掌握

学习MyBatis开发中的最佳实践和编码规范 ⚠️

反模式识别

了解常见的反模式和避免方法 🏗️

项目结构设计

掌握合理的项目结构和代码组织方式 🔒

安全与性能

学习安全防护和性能优化技巧

🎯 最佳实践概述

最佳实践是在MyBatis开发过程中总结出的经验和技巧。遵循这些实践可以提高代码质量、开发效率和系统性能，同时降低维护成本和出错概率。

⭐ 核心原则

🔧 简洁明了

保持代码简洁，逻辑清晰，易于理解和维护

📊 性能优先

优化SQL查询，合理使用缓存，提升系统性能

🚀 安全可靠

防止SQL注入，保护敏感数据，确保系统安全

🎨 可维护性

良好的代码结构，完善的文档，便于团队协作

✅ 编码最佳实践

1. Mapper接口设计// ✅ 好的实践 @Mapper public interface UserMapper { // 方法名清晰表达意图 User selectByPrimaryKey(Long id); // 使用具体的参数类型 List selectByCondition(UserQuery query); // 批量操作使用List参数 int batchInsert(@Param("users") List users); }

2. SQL语句编写 SELECT id, username, email, create_time FROM user WHERE status = 1 AND (username LIKE CONCAT('%', #{keyword}, '%') OR email LIKE CONCAT('%', #{keyword}, '%')) ORDER BY create_time DESC LIMIT #{offset}, #{limit}

❌ 常见反模式

1. 避免SELECT *

-- ❌ 不好的实践
SELECT * FROM user WHERE id = #{id};

-- ✅ 好的实践
SELECT id, username, email, status 
FROM user WHERE id = #{id};

2. 避免N+1查询问题

<!-- ❌ 会产生N+1查询 -->
<select id="selectUser" resultMap="userMap">
    SELECT * FROM user WHERE id = #{id}
</select>

<!-- ✅ 使用关联查询 -->
<select id="selectUserWithOrders" resultMap="userWithOrdersMap">
    SELECT u.*, o.id as order_id, o.amount
    FROM user u
    LEFT JOIN orders o ON u.id = o.user_id
    WHERE u.id = #{id}
</select>

🏗️ 项目结构设计

src/main/java/
├── com/example/
│   ├── config/          # 配置类
│   │   ├── MybatisConfig.java
│   │   └── DataSourceConfig.java
│   ├── entity/          # 实体类
│   │   ├── User.java
│   │   └── Order.java
│   ├── mapper/          # Mapper接口
│   │   ├── UserMapper.java
│   │   └── OrderMapper.java
│   ├── service/         # 业务逻辑
│   │   ├── UserService.java
│   │   └── OrderService.java
│   └── dto/             # 数据传输对象
│       ├── UserQuery.java
│       └── OrderQuery.java

src/main/resources/
├── mappers/             # Mapper XML文件
│   ├── UserMapper.xml
│   └── OrderMapper.xml
├── application.yml      # 配置文件
└── schema.sql          # 数据库脚本

🔒 安全防护

防止SQL注入 SELECT * FROM user WHERE username = #{username}

SELECT * FROM user WHERE username = '${username}'

📊 性能优化建议

• 索引优化：为常用查询字段创建合适的索引
• 分页查询：使用LIMIT进行分页，避免查询大量数据
• 缓存策略：合理使用一级缓存和二级缓存
• 批量操作：使用批量插入、更新减少数据库交互
• 连接池配置：合理配置连接池参数

🔧 开发工具推荐

MyBatis Generator

自动生成Mapper接口和XML文件

MyBatis Plus

增强MyBatis功能的开发框架

PageHelper

简化分页查询的插件

Druid

高性能的数据库连接池

💡 本章小结

本章我们总结了MyBatis开发的最佳实践。这些实践是在实际项目中积累的宝贵经验，遵循这些原则可以帮助我们写出高质量、高性能、易维护的MyBatis应用。学习完成：恭喜你完成了MyBatis学习教程！现在你已经掌握了MyBatis的核心概念和实践技巧，可以在实际项目中灵活运用这些知识。

课程完成 🎉

恭喜！课程学习完成

您已经完成了MyBatis完整学习教程 ← 上一章：测试方法 📚 返回目录