Mybatis入门

目录

• MyBatis入门
  • MyBatis简介
  • MyBatis的优势
  • MyBatis开发步骤
    • 1.添加需要的jar包
    • 2.创建数据库，添加测试数据
    • 3.创建实体类
    • 4.创建实体类映射配置文件
    • 5.创建mybatis主配置文件
  • 获取SqlSessionFactory对象
  • 访问数据库
  • 解决表字段与类属性名不对应
  • 使用日志查看SQL语句等
  • MyBatis的配置文件
    • 核心配置文件
    • 环境配置
    • 事务管理
    • 数据源
    • properties标签
    • 映射器
    • 别名的使用

MyBatis入门

Editor：SimpleWu

MyBatis简介

• MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。
• MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以对配置和原生Map使用简单的 XML 或注解，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。

MyBatis参考资料官网

http://www.mybatis.org/mybatis-3/zh/index.html

MyBatis下载地址

https://github.com/mybatis/mybatis-3

MyBatis的优势

• 开源的优秀的持久层框架
• SQL语句与代码分离
• 面向配置的编程
• 良好支持复杂数据映射
• 动态SQL

MyBatis开发步骤

1.添加需要的jar包

1）mybatis-3.3.0 核心包（如果需要日志操作，可以导入依赖包）

2）数据库驱动（mysql-connector-java-5.1.22-bin）

2.创建数据库，添加测试数据

create table `tal_employee` (
	`id` int (11),
	`last_name` varchar (360),
	`email` varchar (300),
	`gender` char (9)
); 

INSERT INTO `tal_employee` (`id`, `last_name`, `email`, `gender`) VALUES('1','韩信','hanxin@gemail.com','男');
INSERT INTO `tal_employee` (`id`, `last_name`, `email`, `gender`) VALUES('2','LiBaihH','libai@gemail.com','男');
INSERT INTO `tal_employee` (`id`, `last_name`, `email`, `gender`) VALUES('3','孙尚香','sunshangxiang@gemail.com','女');
INSERT INTO `tal_employee` (`id`, `last_name`, `email`, `gender`) VALUES('4','安琪拉','anqila@gemail.com','女');
INSERT INTO `tal_employee` (`id`, `last_name`, `email`, `gender`) VALUES('5','Hello','Hello@gemail.com','男');
INSERT INTO `tal_employee` (`id`, `last_name`, `email`, `gender`) VALUES('6','Miya','Miya@gemail.com','男');

3.创建实体类

public class Employee {
	private Integer id;
	private String lastName;
	private String email;
	private String gender;
	//此处省略get set toString。。。
}

4.创建实体类映射配置文件

<?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="EmployeeMapper">
	<!-- 定义一个查询方法  resultType 返回值类型-->
	<select id="findAll" resultType="com.simple.mybatis.entitys.Employee">
		select * from tal_employee
	</select>
</mapper>

5.创建mybatis主配置文件

<?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>
	<!-- 配置环境  default默认使用环境名字-->
	<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" />
				<property name="username" value="root" />
				<property name="password" value="root" />
			</dataSource>
		</environment>
	</environments>
	<!-- 加载映射 -->
	<mappers>
		<mapper resource="com/simple/mybatis/entitys/EmployeeMapper.xml" />
	</mappers>
</configuration>

编写代码见下文

获取SqlSessionFactory对象

private SqlSessionFactory sqlSessionFactory;
	@Before
	public void init() throws IOException{
		//读取mybatis主配置文件
		InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
		/**
		 * 实例化SqlSessionFactory
		 * 如果没有指定默认环境，可以在这里指定使用的环境ID，比如我先在有个DEV环境
		 * sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream,"DEV");
		 * 我这里已经使用了默认环境所以我就不用这种方式创建了
		 */
		sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
	}

访问数据库

获取SqlSession对象，作用于与数据库的一次回话作用于与数据库的一次回话

SqlSession session = sqlSessionFactory.openSession();

获取所有员工记录

EmployeeMapper就是我们实体类映射文件的命名空间，findAll就是我们select标签的ID

List<Employee> employees = session.selectList("EmployeeMapper.findAll");
		for (Employee employee : employees) {
			System.out.println(employee);
		}

访问结果：

Employee [id=1, lastName=null, email=hanxin@gemail.com, gender=男]
Employee [id=2, lastName=null, email=libai@gemail.com, gender=男]
Employee [id=3, lastName=null, email=sunshangxiang@gemail.com, gender=女]
Employee [id=4, lastName=null, email=anqila@gemail.com, gender=女]
Employee [id=5, lastName=null, email=Hello@gemail.com, gender=男]
Employee [id=6, lastName=null, email=Miya@gemail.com, gender=男]

在这里我们访问数据库是正常的，为什么lastName为空呢？

解决表字段与类属性名不对应

原因：应为我们这里实体类上的属性叫做lastName与数据库列last_name名字不对应所以获取的值为空

解决方案1：将实体类映射文件的中select标签中的取别名

<select id="findAll" resultType="com.simple.mybatis.entitys.Employee">
		select id,last_name AS lastName,email,gender from tal_employee
</select>

解决方案2：在mybatis主配置文件中配置驼峰式命名，需要将配置排在前面否则XML报错

<settings>
	<!-- 开启驼峰式命名规则 -->
	<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>

使用方案2我们类中属性lastName会匹配数据库字段last_name

使用日志查看SQL语句等

首先我们需要添加mybatis依赖包

添加log4j.properties

#设置输出级别和输出位置
log4j.rootLogger=debug,Console
#设置控制台相关的参数
log4j.appender.Console=org.apache.log4j.ConsoleAppender  
log4j.appender.Console.layout=org.apache.log4j.PatternLayout  
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n  
#设置MyBatis的输出内容
log4j.logger.java.sql.ResultSet=INFO  
log4j.logger.org.apache=INFO  
log4j.logger.java.sql.Connection=DEBUG  
log4j.logger.java.sql.Statement=DEBUG  
log4j.logger.java.sql.PreparedStatement=DEBUG

这样我们就可以使用log4j来查看我们的sql语句啊，传入的参数啊。。等等

MyBatis的配置文件

• 通过前面简单的MyBatis案例，大家应该了解到了MyBatis框架的基本结构，和Hibernate一样，MyBatis包含了一个核心配置文件和映射文件。
• 核心配置文件(mybatis-config.xml)：包含了对Mybatis的核心配置，包含连接池信息，事务，加载映射文件，参数设置等配置。
• 映射文件(EmployeeMapper.xml）：主要实现实体对象对数据库的映射，关联关系，Sql语句等。

核心配置文件

标签	说明
	配置环境
	一些外部属性，这些属性可以被替换
	Mybatis中极为重要的调整设置，会改变Mybatis的默认行为。
	为Java类型设置一个别名，它只和xml配置有关。
	映射器，加载MyBatis的映射文件。
	插件，Mybatis允许用户在映射的某一点进行拦截。

环境配置

1. Mybatis可以通过配置多种环境，比如开发环境、测试环境和生产环境等。
2. 不过要记住，尽管可以配置多个环境，但是SqlSessionFactory对象只能加载一个。如果你需要同时连接多个数据库，需要创建多个SqlSessionFactory实例。

事务管理

在 MyBatis 来进行事务的设置，其中有两种类型的事务管理器。

1. JDBC：这个配置就是直接使用了 JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务范围。
2. MANAGED：这个配置几乎没做什么。它从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。 默认情况下它会关闭连接，然而一些容器并不希望这样，因此需要将 closeConnection 属性设置为 false 来阻止它默认的关闭行为。

<transactionManager type="MANAGED">
    <property name="closeConnection" value="false"/>
</transactionManager>

如果你正在使用 Spring + MyBatis，则没有必要配置事务管理器， 因为 Spring 模块会使用自带的管理器来覆盖前面的配置。

数据源

使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。有三种数据源类型

1. UNPOOLED：这个数据源的实现只是每次被请求时打开和关闭连接。
2. POOLED：这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来， 避免了创建新的连接实例时所必需的初始化和认证时间。
3. JNDI：使用JNDI在外部配置数据源。

properties标签

properties为外部属性，比如数据库连接信息可以配置到一个单独的properties文件中，然后在xml中进行引入。

添加一个db.properties文件

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/test
username=root
password=root

在mybatis主配置文件中引用

<properties resource="db.properties" />
<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>

映射器

通常MyBatis中将映射关系（非必须）和SQL语句写入到映射文件中，在配置文件中需要手动进行加载映射文件。加载映射文件使用进行加载。Mybatis中有4种加载方式。

1.使用resource，加载classpath路径进行加载。

<mappers>
    <mapper resource="com/simple/mybatis/entitys/EmployeeMapper.xml"/>
</mappers>

2.使用url路径进行加载。

<mappers>
    <mapper url="file:///var/mappers/AuthorMapper.xml"/>
</mappers>

3.使用calss进行加载，注解方式。

<!– 加载class类-->
<mappers>
    <mapper class="使用注解的全类名"/>
</mappers>

4.使用package进行加载，注解方式。

<!– 加载某个包下的所有class文件-->
<mappers>
    <package name="com.simple.mybatis.entitys"/>
</mappers>

别名的使用

之前，我们在sql映射xml文件中的引用实体类时，resultType需要写上实体类的全类名(包名+类名)，如下：

<select id="findAll" resultType="com.simple.mybatis.entitys.Employee">
		select id,last_name AS lastName,email,gender from tal_employee
</select>

在mybatis主配置文件中加入

<typeAliases>
    <typeAlias type=“com.simple.mybatis.entitys.Employee" alias="Employee"/>
</typeAliases>

这样在resultType中就可以直接使用Employee类型了。这个别名是不区分大小写的。