mybatis-spring中文配置

### MyBatis与Spring整合的关键知识点 #### 一、整合动机与背景 MyBatis-Spring项目的出现主要是为了解决Spring框架与MyBatis框架之间的兼容性和整合问题。原本Spring只支持iBatis 2.x版本，而在MyBatis 3.x版本发布后，Spring并没有及时更新以支持新的MyBatis版本。因此，为了弥补这一空白，MyBatis社区决定自己动手，创建了一个名为MyBatis-Spring的小型库，旨在为Spring和MyBatis之间搭建桥梁。 **关键特点：** - **简化配置**：减少用户配置MyBatis和Spring环境所需的样板代码。 - **透明事务管理**：增加Spring对MyBatis事务的透明支持，简化事务管理逻辑。 - **异常转换**：将MyBatis异常转换为Spring的`DataAccessException`异常，统一异常处理机制。 #### 二、安装与配置要求 **安装步骤：** - 添加`mybatis-spring-1.0.0-RC3.jar`至项目的类路径中。 - 对于使用Maven的项目，在`pom.xml`文件中添加如下依赖： ```xml <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>1.0.0-RC3</version> </dependency> ``` **配置要求：** - 需要熟悉Spring和MyBatis框架的基本概念与术语。 - Java版本要求：Java 5或以上版本。 #### 三、SqlSessionFactoryBean **SqlSessionFactoryBean**是MyBatis-Spring提供的一个核心组件，用于创建`SqlSessionFactory`对象，它是MyBatis与Spring整合的基础。 **创建方式：** 在Spring的配置文件中定义`SqlSessionFactoryBean`，并通过`dataSource`属性指定数据源。 ```xml <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource"/> </bean> ``` **属性详解：** - `dataSource`：必须的属性，用于指定数据源。可以是任意类型的`DataSource`实现。 - `configLocation`：可选属性，用于指定MyBatis配置文件的位置。 - `mapperLocations`：可选属性，用于指定Mapper XML文件的位置。 #### 四、事务管理 MyBatis-Spring提供了对事务管理的支持，可以通过以下两种方式实现： 1. **标准配置**：通过Spring的`@Transactional`注解或`PlatformTransactionManager`来管理事务。 2. **容器管理事务**：MyBatis-Spring能够自动检测并使用Spring容器中已经配置好的事务管理器。 #### 五、使用SqlSession **SqlSessionSupport**与**SqlSessionTemplate**是MyBatis-Spring提供的两种用于执行SQL操作的工具类。 - **SqlSessionTemplate**：线程安全的，适用于执行单个SQL操作。 - **SqlSessionSupport**：非线程安全的，适用于执行多个SQL操作。 **示例：** ```java // 使用SqlSessionTemplate public class UserService { @Resource private SqlSessionTemplate sqlSession; public User getUserById(int id) { return sqlSession.selectOne("com.example.mapper.UserMapper.getUserById", id); } } // 使用SqlSessionSupport public class UserService extends SqlSessionSupport { public User getUserById(int id) { return getSqlSession().selectOne("com.example.mapper.UserMapper.getUserById", id); } } ``` #### 六、MapperFactoryBean **MapperFactoryBean**是MyBatis-Spring提供的用于自动装配Mapper接口实例的工具类。 **创建方式：** 1. **创建MapperFactoryBean**：在Spring配置文件中定义`MapperFactoryBean`。 2. **注入映射器**：通过`mapperInterface`属性指定需要注入的Mapper接口。 3. **自动配置**：如果开启了`@MapperScan`注解扫描，则无需手动配置每个Mapper。 **示例：** ```xml <!-- 手动配置 --> <bean class="org.mybatis.spring.mapper.MapperFactoryBean"> <property name="mapperInterface" value="com.example.mapper.UserMapper"/> <property name="sqlSessionFactory" ref="sqlSessionFactory"/> </bean> <!-- 自动配置 --> <context:component-scan base-package="com.example.mapper"/> <mapper scan-base-package="com.example.mapper"/> ``` #### 七、示例代码 在实际应用中，通常会结合以上各个组件，构建一个完整的MyBatis-Spring集成示例。以下是一个简单的示例： **Spring配置文件**： ```xml <bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource"> <property name="driverClassName" value="com.mysql.jdbc.Driver"/> <property name="url" value="jdbc:mysql://localhost:3306/mydb"/> <property name="username" value="root"/> <property name="password" value="password"/> </bean> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource"/> <property name="configLocation" value="classpath:mybatis-config.xml"/> <property name="mapperLocations" value="classpath:mapper/*.xml"/> </bean> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.example.mapper"/> <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/> </bean> ``` **Mapper接口**： ```java package com.example.mapper; import com.example.domain.User; import org.apache.ibatis.annotations.Select; public interface UserMapper { @Select("SELECT * FROM users WHERE id = #{id}") User getUserById(int id); } ``` **Service类**： ```java package com.example.service; import com.example.domain.User; import com.example.mapper.UserMapper; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; @Service public class UserService { private final UserMapper userMapper; @Autowired public UserService(UserMapper userMapper) { this.userMapper = userMapper; } public User getUserById(int id) { return userMapper.getUserById(id); } } ``` 通过上述示例可以看出，MyBatis-Spring不仅简化了MyBatis与Spring的集成过程，还提高了代码的可维护性和扩展性。