一、概述
Mybatis是一个持久层框架,它对jdbc的操作数据库的过程进行封装,使开发者只需要关注sql本身,而不需要处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等过程。
Mybatis通过xml或注解的方式将要执行的各种statement配置起来,并通过java对象和statement中的sql进行映射生成最终执行的sql语句,最后由Mybatis框架执行sql并将结果映射成java对象并返回。
二、Mybatis结构
1、mybatis配置
- sqlMapConfig.xml:mybatis的全局配置文件,配置了mybatis的运行环境等信息。
- mapper.xml:sql映射文件,文件中配置了操作数据库的sql语句,此文件需要在sqlMapConfig.xml中加载。
2、通过mybatis环境等配置信息构造SqlSessionFactory会话工厂。
3、由会话工厂创建Session会话,操作数据库需要通过SqlSession进行。
4、mybatis底层定义了Executor执行器接口操作数据库(有两个实现:基本执行器和缓存执行器)。
5、Mapped Statement是mybatis的一个底封装对象,包装了mybatis配置信息及sql映射信息等。mapper.xml文件中一个sql对应一个Mapped Statement对象,sql的id即是Mapped statement的id。
6、Mapped Statement对sql执行输入参数进行定义,包括HashMap、基本类型、pojo,Executor通过Mapped Statement在执行sql前将输入的java对象映射至sql中,输入参数映射就是jdbc编程中对preparedStatement设置参数。
7、Mapped Statement对sql执行输出结果进行定义,包括HashMap、基本类型、pojo,Executor通过Mapped Statement在执行sql后将输出结果映射至java对象中,输出结果映射过程相当于jdbc编程中对结果的解析处理过程。
三、搭建Mybatis运行环境
需求:根据用户ID查找用户信息
1、mysql数据库
2、核心jar包
3、配置log4j.properties
在classpath路径下创建log4j.properties文件,作为输出日志信息,内容如下:
# Global logging configuration
log4j.rootLogger=DEBUG, stdout
# MyBatis logging configuration...
log4j.logger.org.mybatis.example.BlogMapper=TRACE
# 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
4、配置sqlMapConfig.xml
在classpath路径下创建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> <!-- 和spring整合后 environments配置将废除--> <properties resource="db.properties"></properties> <environments default="development"> <environment id="development"> <!-- 使用jdbc事务管理,事务由mybatis管理--> <transactionManager type="JDBC" /> <!-- 数据库连接池--> <dataSource type="POOLED"> <property name="driver" value="${jdbc.driver}"/> <property name="url" value="${jdbc.url}"/> <property name="username" value="${jdbc.username}"/> <property name="password" value="${jdbc.password}"/> </dataSource> </environment> </environments> <!--加载映射文件 --> <mappers> <mapper resource="sqlmap/User.xml"/> <!-- <mapper resource="mapper/UserMapper.xml"/> <mapper resource="mapper/OrdersMapperCustom.xml"/> --> </mappers> </configuration>
5、创建po类
public class User { //属性名和表的字段对象 private int id; private String username;// 用户姓名 private String sex;// 性别 private Date birthday;// 生日 private String address;// 地址 //...get/set方法 @Override public String toString() { // TODO 自动生成的方法存根 return this.username+":"+this.address; } }
6、mapper映射文件
<?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="test"> <!-- 在映射文件中配置很多sql语句 --> <!-- id:标识映射文件中的sql,称为statemen的id 将sql语句封装到mappedStatement对象中 parameterType:指定输入参数的类型 #{}表示一个占位符号 #{id}:其中的id表示接受输入的参数,参数的名称就是id resultType:指定sql输出结果的所映射的java对象,select指定resultType表示将单条记录映射成的java对象 --> <select id="findUserById" parameterType="int" resultType="com.test.pojo.User"> select * from user where id=#{id} </select> </mapper>
然后在sqlMapConfig.xml文件中添加这个mapper:
<!--加载映射文件 --> <mappers> <mapper resource="sqlmap/User.xml"/> </mappers>
7、测试程序
public class MybatisFirst { //根据id查询用户信息 @Test public void findUserByIdTest() throws IOException { //创建会话工厂 String resource="SqlMapConfig.xml"; InputStream inputStream=Resources.getResourceAsStream(resource); SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream); //通过工厂得到SqlSession SqlSession sqlSession=sqlSessionFactory.openSession(); //通过SQLSession操作数据库 User user=sqlSession.selectOne("test.findUserById", 2); System.out.println(user.getUsername()+","+user.getAddress()+","+user.getSex()); sqlSession.close(); } }
测试结果截图:
四、小结
1、parameterType和resultType
parameterType:指定输入参数类型,mybatis通过ognl从输入对象中获取参数值拼接在sql中。
resultType:指定输出结果类型,mybatis将sql查询结果的一行记录数据映射为resultType指定类型的对象。