MyBatis-入门、动态代理、配置

MyBatis介绍

MyBatis前身是apache的一个开源项目iBatis。10年项目迁移到google code，并改名为MyBatis。13年11月迁移到Github。

MyBatis是一个优秀的持久层框架，对jdbc的操作进行封装，开发者关注的是sql本身，而不需要花费精力去处理例如注册驱动、创建连接、创建预处理对象、设置参数、结果集检索等jdbc繁杂的过程。

MyBatis通过xml或注解的方式将要执行的各种statement配置，通过java对象和statement中的sql映射成最终执行的sql语句，最后由MyBatis框架执行sql并将结果映射成java对象返回。

传统JDBC问题总结

1、数据库连接创建、释放频繁造成资源浪费，影响系统性能。使用数据库连接池解决此问题。

2、sql语句硬编码，代码不易维护。

3、使用PrepareStatement向占位符传参存在硬编码，同时sql语句where条件亦不一定，不易维护。

4、对结果集解析存在硬编码，sql变化导致解析代码变化，不易维护。如果将数据库记录封装成POJO解析比较方便。

MyBatis架构

MyBatis入门程序

1、创建工程

2、导入jar包( 数据库驱动、MyBatis核心包、依赖包 )

3、加入配置文件( log4j.properties、SqlMapConfig.xml )

MyBatis默认log4j作为日志输出信息。

# Global logging configuration
log4j.rootLogger=DEBUG, stdout
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

SqlMapConfig.xml是MyBatis核心配置文件。

	<!-- 整合spring后，envirment将废除 -->
	<environments default="development">
		<environment id="development">
			
			<!-- 使用jdbc事务管理 -->
			<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>

4、创建POJO类，通常与数据库表对应。

5、创建sql映射文件，对应POJO类。

<!-- namespace:隔离sql，动态代理接口路径 -->
<mapper namespace="test">
	
	<!-- 根据id查找用户
		id : Statement_ID    SQL_ID 
		parameterType： 输入参数类型
		parameterMap：输入参数类型 在MyBatis3.0以上版本废除
		resultType ： 返回值类型  自动映射 返回POJO对象时要用全限定名
		${} : 字符串拼接  非预编译 不防止SQL注入	 比如：输入  三——>三
		#{} ： 占位符  预编译  防止SQL注入      	 比如：输入 三——>'三'
	-->
	<select id="findUserById" parameterType="Integer" resultType="cn.demo.pojo.User">
		select * from user where id = #{id}
	</select>
	
</mapper>

6、在核心配置文件中加载映射文件。

	<!-- 加载配置文件 -->
	<mappers>
		<mapper resource="sqlmap/User.xml"/>
	</mappers>

7、简单实现：根据用户id查找一个用户

	public static SqlSessionFactory sqlSessionFactory;
	public SqlSession sqlSession; 
	
	static {
		InputStream is;
		try {
			//1 读取 核心配置文件
			is = Resources.getResourceAsStream("SqlMapConfig.xml");
			//2 创建SqlSessionFactory工厂对象
			sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
		} catch (IOException e) {
			e.printStackTrace();
		}
	}
	
	@Test
	public void fun1() {
		//3 SqlSession对象
		sqlSession = sqlSessionFactory.openSession();
		//4 执行，并且获取结果	参数1：映射文件中 id值
		User user = sqlSession.selectOne("test.findUserById", 10);
		System.err.println(user);
		//5 释放资源
		sqlSession.close();
	}

8、根据用户名模糊查询用户

映射文件：

	<!-- 根据用户名模糊查询用户
		如果返回多个对象时，MyBatis会自动把返回结果封装成list
		"%"#{username}"%"   如：当传入 李 时，解析为："%"'李'"%"
	-->
	<select id="findUserByUsername" parameterType="String" resultType="cn.demo.pojo.User">
	 	select * from user where username like "%"#{username}"%"
	</select>

代码：

	@Test
	public void fun2(){
		sqlSession = sqlSessionFactory.openSession();
		List<User> list = sqlSession.selectList("test.findUserByUsername", "%三%");
		for (User user : list) {
			System.err.println(user);
		}
		sqlSession.close();
	}

9、#{ } 和 ${ }

#{ } 表示一个占位符，自动进行Java类型和jdbc类型转换，有效防止sql注入，可以接收简单类型和pojo属性值，如果parameterType传入简单类型，#{}

括号内可以是value或其他名称。

${ } 表示拼接字符串，可以将parameterType传入的内容拼接在sql中且不进行jdbc类型转换，可以接收简单类型和pojo属性值，

如果parameterType传入简单类型，${}括号内只能是value。

当使用MyBatis进行增删改时，需要进行事务的提交：

		sqlSession.commit();

10、添加用户时的xml映射配置( 插入成功时的主键返回 )：

	<!-- 添加用户 -->
	<insert id="addUser" parameterType="cn.demo.pojo.User">
		<!-- selectKey：查询主键返回 
			keyProperty：主键对应POJO对象中那个属性名
			Mysql  ：  
					自增长 ： order = AFTER
					UUID： order = BEFORE
			Oracle ：order = BEFORE
		-->
		<selectKey keyProperty="id" resultType="Integer" order="AFTER">
			select LAST_INSERT_ID()
		</selectKey>
	
		insert into user(username,birthday,sex,address) values(#{username},#{birthday},#{sex},#{address})
	</insert>

此时，id已保存在POJO对象中

11、MyBatis解决传统JDBC问题：

1、核心配置中，配置连接池

2、sql语句配置在xml中，与代码分离

3、MyBatis将java对象映射到sql语句，通过parameterType

4、MyBatis将sql执行结果映射到Java对象，通过resultType

MyBatis和Hibernate区别

不完全是ORM框架，通过注解或xml方式自定义sql

简单易学，

灵活原生态sql，严格控制执行性能，

自定义返回字段 selectKey

但

无法做到数据库无关性，( Mysql、Oracle )

适合做互联网项目、企业运营类( 因为需求变化频繁 )，hibernate适合金融(银行)、政府项目。

一句话：框架只有适合才是最好的。

Dao开发

使用MyBatis开发Dao，通常分两个：原始Dao开发和Mapper动态代理

原始Dao开发

1-6 同上

7、创建Dao接口和实现类

	// 工厂单例
	private SqlSessionFactory sqlSessionFactory;
	public void setSqlSessionFactory(SqlSessionFactory sqlSessionFactory) {
		this.sqlSessionFactory = sqlSessionFactory;	// set注入
	}
	public UserDao(SqlSessionFactory sqlSessionFactory) {
		super();
		this.sqlSessionFactory = sqlSessionFactory; // 构造注入
	}
	@Override
	public User findUserById(Integer id) {
		SqlSession sqlSession = sqlSessionFactory.openSession();
		User user = sqlSession.selectOne("findUserById", id);
		sqlSession.close();
		return user;
	}

8、测试

	private SqlSessionFactory sqlSessionFactory;
	@Before
	public void init() throws IOException{
		SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
		InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
		sqlSessionFactory = builder.build(is);
	}
	@Test
	public void testFindUserById() {
		IUserDao userDao = new UserDao(sqlSessionFactory);
		User user = userDao.findUserById(10);
		System.err.println(user);
	}

9、原始Dao开发存在的问题：

方法体存在重复代码；sqlSession对数据库操作方法需要指定statement的id( SQL_ID )，存在硬编码。

Mapper动态代理方式

此方式，只需要程序员编写Mapper接口( 类似Dao接口 )，由MyBatis框架根据接口定义来创建接口的动态代理对象，代理对象的方法体同上边Dao接口实现类方法

1、开发规范：

1、映射文件xml中的namespace与Mapper各接口的路径一一对应

2、Mapper接口方法名和映射文件xml中定义的每个statement的id相同

3、Mapper接口方法的输入参数类型和映射文件xml中定义的每个sql的parameterType的类型相同

4、Mapper接口方法的输出参数类型和映射文件xml中定义的每个sql的resultType的类型相同

2、映射文件

在config/mapper目录下，创建UserMapper.xml( 同上的xml映射文件 )

3、主配置中记载映射文件

		<mapper resource="mapper/UserMapper.xml"/>

4、测试

	private SqlSessionFactory sqlSessionFactory;
	@Before	// 初始化sqlSessionFactory
	public void init() throws IOException{
		SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
		InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
		sqlSessionFactory = builder.build(is);
	}
	@Test
	public void testFindUserById() {
		SqlSession sqlSession = sqlSessionFactory.openSession();	//创建sqlSession
		UserMapper userMapper = sqlSession.getMapper(UserMapper.class);	//获取代理对象
		User user = userMapper.findUserById(10);						//执行查询方法
		System.err.println(user);

		//整合spring后由spring管理									
		sqlSession.close();
	}

SqlMapConfig.xml配置文件( 部分属性 )

1、properties属性：可以引入java属性文件中的配置信息。例如：db.properties( 数据源 )

在resource加载的属性，会覆盖properties元素体内定义的属性。

2、typeAliases属性：类型别名。

MyBatis支持别名，并有默认支持的别名，

同时，可以自定义别名：

	<typeAliases>
		<!-- 单个别名定义 -->
		<typeAlias type="cn.demo.pojo.User" alias="user"/>
		<!-- 批量别名定义，扫描整个包及子包下的类，别名为 类名(不区分大小写) -->
		<package name="cn.demo.pojo"/>
	</typeAliases>

3、mappers( 映射器 )

	<!-- 加载配置文件 -->
	<mappers>
		<!-- 引入一个映射文件 -->
		<mapper resource="sqlmap/User.xml"/>
		<!-- 引入一个映射文件 -->
		<mapper resource="mapper/UserMapper.xml"/>
		<!-- 扫描包，但：接口类和Mapper映射文件必须同包同名 -->
		<package name="cn.demo.mapper"/>
	</mappers>