MyBatis基础：配置与映射

# 一、MyBatis简介与概述 ## 1.1 什么是MyBatis MyBatis是一个优秀的持久层框架，它消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。MyBatis可以使用简单的XML或注解来配置和映射原始数据库记录，将接口和Java的POJO（Plain Old Java Objects,普通的Java对象）映射成数据库中的记录。 ## 1.2 MyBatis的优势和特点 MyBatis的优势在于可以减少开发人员的工作量，提高开发效率。它具有灵活的SQL映射，可以通过简单的XML或注解来配置映射关系。此外，MyBatis还提供了良好的性能和可靠的缓存机制。 ## 1.3 MyBatis在项目中的应用场景 MyBatis适用于需要对数据库进行频繁操作的项目，特别是对SQL进行较多定制化操作的项目。同时，MyBatis也可以很好地与Spring等框架集成，使得在企业级应用中广泛应用。 ## 二、MyBatis的配置 MyBatis的配置是使用MyBatis的第一步，通过配置可以定制化MyBatis的行为，包括数据库连接、属性配置、Mapper文件配置以及插件配置等。接下来将详细介绍MyBatis的配置内容。 ### 2.1 MyBatis配置文件详解 MyBatis的配置文件是MyBatis框架的核心配置文件，其中包含了数据库连接信息、对象工厂、类型处理器、映射器等配置内容。示例： ```xml <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <properties resource="database.properties"/> <settings> <setting name="cacheEnabled" value="true"/> <setting name="lazyLoadingEnabled" value="true"/> </settings> <typeAliases> <typeAlias alias="User" type="com.example.User"/> </typeAliases> <environments default="development"> <environment id="development"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <property name="driver" value="${driver}"/> <property name="url" value="${url}"/> <property name="username" value="${username}"/> <property name="password" value="${password}"/> </dataSource> </environment> </environments> <mappers> <mapper resource="com/example/UserMapper.xml"/> </mappers> </configuration> ``` ### 2.2 数据库连接配置数据库连接配置包括了驱动、URL、用户名、密码等，通过配置文件进行数据库连接的信息写入，示例： ```xml <dataSource type="POOLED"> <property name="driver" value="${driver}"/> <property name="url" value="${url}"/> <property name="username" value="${username}"/> <property name="password" value="${password}"/> </dataSource> ``` ### 2.3 MyBatis属性配置 MyBatis的属性配置可以设置一些全局或局部的属性，如缓存是否开启、延迟加载等，示例： ```xml <settings> <setting name="cacheEnabled" value="true"/> <setting name="lazyLoadingEnabled" value="true"/> </settings> ``` ### 2.4 Mapper文件配置 Mapper文件配置是指在配置文件中注册Mapper接口或XML文件的位置，示例： ```xml <mappers> <mapper resource="com/example/UserMapper.xml"/> </mappers> ``` ### 2.5 分页插件配置在MyBatis中使用分页插件进行分页查询时，需要进行插件配置，示例： ```java // Java代码示例 PageHelper.startPage(1, 10); List<User> userList = userMapper.getUserList(); ``` ### 三、MyBatis的映射在使用MyBatis时，映射是非常重要的一环，它涉及了数据库表与实体类的映射关系、MyBatis映射文件的详解、实体类与数据库字段的映射以及关联查询的映射处理。下面我们将逐一介绍这些内容。 #### 3.1 数据库表与实体类的映射关系在MyBatis中，数据库表与实体类的映射关系是通过映射文件来定义的，在映射文件中可以指定表的字段与实体类的属性之间的映射关系，以便MyBatis可以将数据库中的数据映射到实体类中，或者将实体类中的数据映射到数据库表中。 #### 3.2 MyBatis映射文件详解 MyBatis的映射文件是XML格式的文件，用于定义SQL语句和结果映射，其中包括了数据库操作的SQL语句、输入参数映射、输出结果映射等。在映射文件中，我们可以使用<resultMap>来定义结果集映射，使用<sql>来定义公共的SQL片段，使用<select>、<insert>、<update>、<delete>等标签来定义具体的数据库操作语句。 #### 3.3 实体类与数据库字段的映射在MyBatis的映射文件中，可以使用<resultMap>来定义结果集映射，通过这样的映射关系，可以将数据库查询的结果集映射到实体类中，实现数据的自动封装。在实体类中，我们可以使用注解或者XML配置来定义实体类与数据库表字段之间的映射关系，以便在数据库操作时可以对数据进行正确的映射。 #### 3.4 关联查询的映射处理在实际项目中，经常会有复杂的查询操作，涉及多个表之间的关联查询。MyBatis提供了丰富的映射处理方式，包括一对一、一对多、多对一、多对多等关联查询的映射处理，通过映射文件的配置，可以方便地将多表查询的结果映射到实体类中，实现数据的自动封装和关联对象的处理。 ### 四、MyBatis的基本CRUD操作在实际的项目开发中，对数据库的增删改查操作是必不可少的，而MyBatis作为持久层框架，提供了非常方便的基本CRUD操作方法，接下来我们将介绍MyBatis中的基本CURD操作。 #### 4.1 MyBatis的基本CURD操作概述在MyBatis中，CURD操作主要包括新增（Create）、查询（Retrieve）、更新（Update）和删除（Delete）四种操作。通过Mapper文件配置和SQL语句的编写，可以很方便地实现这些数据库操作。 #### 4.2 使用MyBatis进行数据的新增新增数据是我们在数据库操作中经常会使用的操作，下面是一个使用MyBatis进行数据新增的示例代码： ```java // 实体类 public class User { private Long id; private String username; private String password; // 省略getter和setter方法 } // Mapper接口 public interface UserMapper { void insert(User user); } // Mapper XML 文件  <mapper namespace="com.example.UserMapper"> <insert id="insert" parameterType="User"> INSERT INTO user (username, password) VALUES (#{username}, #{password}) </insert> </mapper> // 调用新增操作 User user = new User(); user.setUsername("test"); user.setPassword("123456"); userMapper.insert(user); ``` #### 4.3 使用MyBatis进行数据的查询 MyBatis提供了丰富的查询方法，包括根据主键查询、条件查询、分页查询等。下面是一个简单的条件查询示例： ```java // Mapper接口 public interface UserMapper { User selectById(Long id); } // Mapper XML 文件  <mapper namespace="com.example.UserMapper"> <select id="selectById" resultType="User" parameterType="Long"> SELECT * FROM user WHERE id = #{id} </select> </mapper> // 调用查询操作 User user = userMapper.selectById(1L); ``` #### 4.4 使用MyBatis进行数据的更新更新数据使用频率也很高，MyBatis提供了方便的更新操作方法，下面是一个简单的更新操作示例： ```java // Mapper接口 public interface UserMapper { void update(User user); } // Mapper XML 文件  <mapper namespace="com.example.UserMapper"> <update id="update" parameterType="User"> UPDATE user SET username = #{username}, password = #{password} WHERE id = #{id} </update> </mapper> // 调用更新操作 User user = new User(); user.setId(1L); user.setUsername("newName"); user.setPassword("newPassword"); userMapper.update(user); ``` #### 4.5 使用MyBatis进行数据的删除最后是数据的删除操作，在MyBatis中，删除操作也非常简单，下面是一个简单的删除操作示例： ```java // Mapper接口 public interface UserMapper { void delete(Long id); } // Mapper XML 文件  <mapper namespace="com.example.UserMapper"> <delete id="delete" parameterType="Long"> DELETE FROM user WHERE id = #{id} </delete> </mapper> // 调用删除操作 userMapper.delete(1L); ``` ## 五、MyBatis的高级映射与使用技巧在本章节中，我们将探讨MyBatis的高级映射与使用技巧，包括结果集映射技巧、动态SQL的使用、批量操作的处理以及MyBatis中的一级缓存和二级缓存。 ### 5.1 结果集映射技巧在MyBatis中，可以通过结果集映射技巧，将数据库查询结果映射到Java对象上。使用MyBatis的ResultMap可以实现复杂的映射关系，包括一对一、一对多、多对一、多对多等情况，这使得我们能够灵活地处理各种复杂的查询需求。 ```java // 示例代码 <resultMap id="userResultMap" type="User"> <id property="id" column="user_id"/> <result property="username" column="username"/> <association property="department" column="dept_id" javaType="Department"> <id property="id" column="dept_id"/> <result property="name" column="dept_name"/> </association> <collection property="articles" ofType="Article"> <id property="id" column="article_id"/> <result property="title" column="title"/> </collection> </resultMap> ``` ### 5.2 动态SQL的使用 MyBatis提供了丰富的动态SQL支持，包括if、choose、when、otherwise、trim、where等标签，可以根据条件动态生成SQL语句，实现灵活的SQL拼装，使开发者能够动态地构建各种复杂的SQL语句。 ```java // 示例代码 <select id="selectUser" parameterType="map" resultType="User"> SELECT * FROM users <where> <if test="username != null">AND username = #{username}</if> <if test="deptId != null">AND dept_id = #{deptId}</if> </where> </select> ``` ### 5.3 批量操作的处理 MyBatis支持批量插入、更新和删除操作，可以通过使用foreach标签处理批量操作，这对于处理大量数据时非常有用，能够有效提高数据库操作的效率。 ```java // 示例代码 <insert id="batchInsertUser" parameterType="java.util.List"> INSERT INTO users (username, password) VALUES <foreach collection="list" item="user" separator=","> (#{user.username}, #{user.password}) </foreach> </insert> ``` ### 5.4 MyBatis中的一级缓存和二级缓存 MyBatis提供了一级缓存和二级缓存的支持，一级缓存默认开启，是SqlSession级别的缓存，可以减少对数据库的访问次数。而二级缓存是Mapper级别的缓存，可以跨SqlSession共享数据，提高系统性能，但需要手动配置和管理。 ### 六、MyBatis与Spring集成在实际项目中，很多时候我们会将MyBatis与Spring进行集成，以便更好地利用Spring框架的依赖注入和事务管理等特性。接下来，我们将详细介绍MyBatis与Spring集成的方法、Spring中的MyBatis配置、Spring中的MyBatis事务处理以及使用Spring对MyBatis进行测试。 #### 6.1 MyBatis与Spring的整合方法目前，最流行的MyBatis与Spring集成方式是通过`SqlSessionFactoryBean`来完成的。`SqlSessionFactoryBean`是一个用于创建SqlSessionFactory的FactoryBean，它可以直接在Spring的配置文件中配置，实现MyBatis与Spring的无缝整合。下面是一个简单的Spring配置文件，展示了如何将MyBatis与Spring进行整合： ```xml  <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource" /> <property name="typeAliasesPackage" value="com.example.model" /> <property name="mapperLocations" value="classpath:mapper/*.xml" /> </bean>  <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.example.mapper" /> </bean>  <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close"> <property name="driverClassName" value="${jdbc.driverClassName}" /> <property name="url" value="${jdbc.url}" /> <property name="username" value="${jdbc.username}" /> <property name="password" value="${jdbc.password}" /> </bean> ``` #### 6.2 Spring中的MyBatis配置在Spring的配置文件中，我们需要配置`SqlSessionFactoryBean`来整合MyBatis和Spring。除此之外，我们还需要配置`MapperScannerConfigurer`，用于自动扫描Mapper接口，这样就不需要手动去编写Mapper接口的实现类了。 #### 6.3 Spring中的MyBatis事务处理 Spring提供了非常强大的事务管理功能，对MyBatis的事务进行处理非常方便。通常可以通过在Service层的方法上添加`@Transactional`注解来实现事务管理，Spring会自动管理事务的开始、提交、回滚等操作。 ```java @Service @Transactional public class UserService { @Autowired private UserMapper userMapper; public void updateUser(User user) { userMapper.updateUser(user); } } ``` #### 6.4 使用Spring对MyBatis进行测试在集成测试中，我们可以使用Spring提供的`@RunWith(SpringJUnit4ClassRunner.class)`和`@ContextConfiguration`注解来初始化Spring容器，并在测试中使用MyBatis进行数据库操作。 ```java @RunWith(SpringJUnit4ClassRunner.class) @ContextConfiguration(locations = {"classpath:applicationContext.xml"}) @Transactional public class UserMapperTest { @Autowired private UserMapper userMapper; @Test public void testGetUserById() { User user = userMapper.getUserById(1); assertNotNull(user); } } ```