Mybatis使用入门

清疚 2022-04-24 15:16 142阅读 0赞

**1.Mybatis介绍**

Mybatis是一个优秀的**持久层框架**，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。

Mybatis通过xml或注解的方式将要执行的各种statement（statement、preparedStatemnt、CallableStatement）配置起来，并通过java对象和statement中的sql进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射成java对象并返回。

**2.Mybatis架构**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI5NjYwOTU3_size_16_color_FFFFFF_t_70][]

*  SqlMapConfig.xml，此文件作为mybatis的全局配置文件，配置了mybatis的运行环境等信息。
 *  mapper.xml文件即sql映射文件，文件中配置了操作数据库的sql语句。此文件需要在SqlMapConfig.xml中加载。
 *  通过mybatis环境等配置信息构造SqlSessionFactory即会话工厂
 *  由会话工厂创建sqlSession即会话，操作数据库需要通过sqlSession进行。
 *  mybatis底层自定义了Executor执行器接口操作数据库，Executor接口有两个实现，一个是基本执行器、一个是缓存执行器。
 *  Mapped Statement也是mybatis一个底层封装对象，它包装了mybatis配置信息及sql映射信息等。mapper.xml文件中一个sql对应一个Mapped Statement对象，sql的id即是Mapped statement的id。
 *  Mapped Statement对sql执行输入参数进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql前将输入的java对象映射至sql中，输入参数映射就是jdbc编程中对preparedStatement设置参数。
 *  Mapped Statement对sql执行输出结果进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql后将输出结果映射至java对象中，输出结果映射过程相当于jdbc编程中对结果的解析处理过程。

**3.Mybatis环境搭建**

**3.1mybatis的jar包**

![20190429142135339.png][]

mybatis-3.2.7为核心包、lib文件夹内装的为mybatis的依赖包。

**3.2创建配置文件**

主配置文件为SqlMapConfig.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>
    	
    	<environments default="development">
    		<environment id="development">
    			
    			<transactionManager type="JDBC" />
    			
    			<dataSource type="POOLED">
    				<property name="driver" value="com.mysql.jdbc.Driver" />
    				<property name="url"
    					value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8" />
    				<property name="username" value="root" />
    				<property name="password" value="root" />
    			</dataSource>
    		</environment>
    	</environments>
    <mappers>
    		<mapper resource="sqlmap/User.xml" />
    		<mapper resource="mapper/UserMapper.xml" />
    	</mappers>
    
    </configuration>

**3.3创建实体类并配置映射文件**

实体类通常与数据库中的表对应

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI5NjYwOTU3_size_16_color_FFFFFF_t_70 1][]

随后需要定义一份mapper映射文件UserMapper.xml，以此来实现mybatis的动态开发。

Mapper接口开发方法只需要程序员编写Mapper接口（相当于Dao接口），由Mybatis框架根据接口定义创建接口的动态代理对象，代理对象的方法体同上边Dao接口实现类方法。

Mapper接口开发需要遵循以下规范：

1.  Mapper.xml文件中的namespace与mapper接口的类路径相同。
2.  Mapper接口方法名和Mapper.xml中定义的每个statement的id相同
3.  Mapper接口方法的输入参数类型和mapper.xml中定义的每个sql 的parameterType的类型相同
4.  Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同

UserMapper.xml配置文件内容：

<?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE mapper
    PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
    "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    
    
    <mapper namespace="cn.itcast.mybatis.mapper.UserMapper">
    	
    	
    	
    	
    	<select id="queryUserById" parameterType="int"
    		resultType="cn.itcast.mybatis.pojo.User">
    		select * from user where id = #{id}
    	</select>
    
    	
    	<select id="queryUserByUsername" parameterType="string"
    		resultType="cn.itcast.mybatis.pojo.User">
    		select * from user where username like '%${value}%'
    	</select>
    <insert id="saveUser" parameterType="cn.itcast.mybatis.pojo.User">
    		<selectKey keyProperty="id" keyColumn="id" order="AFTER"
    			resultType="int">
    			select last_insert_id()
    		</selectKey>
    		insert into user(username,birthday,sex,address) values
    		(#{username},#{birthday},#{sex},#{address});
    	</insert>
    
    </mapper>

**3.4创建UserMapper接口文件**

public interface UserMapper {
    	/**
    	 * 根据id查询
    	 * 
    	 * @param id
    	 * @return
    	 */
    	User queryUserById(int id);
    
    	/**
    	 * 根据用户名查询用户
    	 * 
    	 * @param username
    	 * @return
    	 */
    	List<User> queryUserByUsername(String username);
    
    	/**
    	 * 保存用户
    	 * 
    	 * @param user
    	 */
    	void saveUser(User user);
    }

**3.5测试**

public class UserMapperTest {
    	private SqlSessionFactory sqlSessionFactory;
    
    	@Before
    	public void init() throws Exception {
    		// 创建SqlSessionFactoryBuilder
    		SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
    		// 加载SqlMapConfig.xml配置文件
    		InputStream inputStream = Resources.getResourceAsStream("SqlMapConfig.xml");
    		// 创建SqlsessionFactory
    		this.sqlSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
    	}
    
    	@Test
    	public void testQueryUserById() {
    		// 获取sqlSession，和spring整合后由spring管理
    		SqlSession sqlSession = this.sqlSessionFactory.openSession();
    
    		// 从sqlSession中获取Mapper接口的代理对象
    		UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    		// 执行查询方法
    		User user = userMapper.queryUserById(1);
    		System.out.println(user);
    
    		// 和spring整合后由spring管理
    		sqlSession.close();
    	}
    public void testQueryUserByUsername() {
    		// 获取sqlSession，和spring整合后由spring管理
    		SqlSession sqlSession = this.sqlSessionFactory.openSession();
    
    		// 从sqlSession中获取Mapper接口的代理对象
    		UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    		// 执行查询方法
    		List<User> list = userMapper.queryUserByUsername("张");
    		for (User user : list) {
    			System.out.println(user);
    		}
    
    		// 和spring整合后由spring管理
    		sqlSession.close();
    	}
    
    	@Test
    	public void testSaveUser() {
    		// 获取sqlSession，和spring整合后由spring管理
    		SqlSession sqlSession = this.sqlSessionFactory.openSession();
    
    		// 从sqlSession中获取Mapper接口的代理对象
    		UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    		// 创建保存对象
    		User user = new User();
    		user.setUsername("刘备");
    		user.setBirthday(new Date());
    		user.setSex("1");
    		user.setAddress("蜀国");
    		// 执行查询方法
    		userMapper.saveUser(user);
    		System.out.println(user);
    
    
    		// 和spring整合后由spring管理
    		sqlSession.commit();
    		sqlSession.close();
    	}
    }

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI5NjYwOTU3_size_16_color_FFFFFF_t_70]: /images/20220212/f8c732582c2844c6923b5566a2890399.png
[20190429142135339.png]: /images/20220212/b83e0bcdb89e437ea79a3a930c70f2dc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI5NjYwOTU3_size_16_color_FFFFFF_t_70 1]: /images/20220212/73baeda9c9274238b800c09c9f73f747.png