MyBatis
- maven中央仓库和本地仓库
- 使用maven创建javaSE和javaEE工程
- mybatis的介绍
- mybatis的入门
- 使用jdbc操作数据库存在的问题
- Mybatis架构
- Mybatis的入门程序
- Dao的开发方法-动态代理开发
- sqlMapConfig 文件的详细说明
一.mybatis的介绍
-
MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code,并且改名为MyBatis 。2013年11月迁移到Github。
-
iBATIS一词来源于“internet”和“abatis”的组合,是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects(sDAO)
-
mybatis是一个优秀的持久层的框架,它对jdbc的操作数据库过程进行封装,使开发者只需要关注SQL本身,而不需要花费精力去处理如加载启动,创建Connection,创建statement,结果集封装等操作。
1.使用jdbc编程存在的问题
- 比如是我们要是使用jdbc编程,那么需要完成如下步骤
-
加载数据库驱动
-
获取数据库连接
-
创建jdbc statement对象
-
编写sql语句
-
设置sql语句中的参数(preparedStatment)
-
通过statement执行sql获取结果
-
对sql执行结果进行解析处理
-
释放资源
1.Jdbc 问题总结
-
数据库连接创建,释放频繁会造成系统资源浪费从而影响系统性能,如果使用数据库连接池可以解决这个问题
-
Sql语句在代码中硬编码,造成代码不易维护,实际应用sql变化可能较大,sql变动需要修改java代码
-
使用prepareStatment向占位符号传参数存在硬编码,因为sql语句的where条件不一定,可能多也可能少,修改sql还要修改代码,系统维护困难
-
对结果集解析存在硬编码,sql变化导致解析代码变化,系统维护困难,如果能将数据库记录封装成javaBean对象解析比较方便。
二. mybatis 架构
- mybatis配置:
- 两大配置文件 :核心配置文件 SqlMapConfig.xml 映射配置文件: mapper.xml
- 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编程中对结果的解析处理过程。
三.Mybatis入门程序准备工作
1. mybatis下载
-
mybatis的代码由github.com管理 ,下载地址: https://github.com/mybatis/mybatis-3/releases
-
现在使用maven导入更方便
<dependency>
<groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId>
<version>3.4.4</version>
</dependency>
2.工程的搭建
1.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>
<!--引入外部文件的标签 -->
<properties resource="properties/db.properties"></properties>
<settings>
<!-- 可以在控制台输出日志信息:sql语句和参数 -->
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
<!-- 表示类型别名 库-->
<typeAliases>
<!-- 每一个类型的别名 type属性表示别名对应的类型地址 alias表示起的别名--> <typeAlias type="java.util.List" alias="list"/>
<!-- package表示包,利用包的形式进行扫描包之下的所有的类,别名就是当前类名 --> <package name="com.kgc.pojo"/>
</typeAliases>
<!-- 分页插件 -->
<!-- <plugins>
<plugin interceptor="com.github.pagehelper.PageInterceptor"> 3.3.0版本可用 - 分页参数合理化,默认false禁用
pageNum表示当前页 pages表示尾页
true启用合理化时,如果pageNum<1会查询第一页,如果pageNum>pages会查询最后一页 false禁用合理化时,如果pageNum<1或pageNum>pages会返回空数据
<property name="reasonable" value="true"/>
</plugin>
</plugins> -->
<!-- 环境配置 作为连接数据库的环境 -->
<environments default="development">
<environment id="development">
<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表示代理模式扫描 ,目的主要是在当前配置文件中扫描到sql映射文件-->
<mappers>
<mapper resource="mapper/BookMapper.xml"/>
</mappers>
</configuration>
2.sql映射文件
<?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">
<!--代理扫描 namespace属性表示当前代理的命名空间,
属性值一般情况下等于dao的接口类地址 相当于dao接口实现类 -->
<mapper namespace="com.kgc.mapper.BookMapper">
<!--这里会有增删改查的标签-->
</mapper>
3. mybatis解决jdbc编程的问题
-
数据库链接创建、释放频繁造成系统资源浪费从而影响系统性能,如果使用数据库链接池可解决此问题。
解决:在SqlMapConfig.xml中配置数据链接池,使用连接池管理数据库链接。
-
Sql语句写在代码中造成代码不易维护,实际应用sql变化的可能较大,sql变动需要改变java代码。
解决:将Sql语句配置在XXXXmapper.xml文件中与java代码分离。
-
向sql语句传参数麻烦,因为sql语句的where条件不一定,可能多也可能少,占位符需要和参数一一对应。
解决:Mybatis自动将java对象映射至sql语句,通过statement中的parameterType定义输入参数的类型。
-
对结果集解析麻烦,sql变化导致解析代码变化,且解析前需要遍历,如果能将数据库记录封装成pojo对象解析比较方便。
解决:Mybatis自动将sql执行结果映射至java对象,通过statement中的resultType定义输出结果的类型。
4. mybatis和hibernate的区别
-
Mybatis和hibernate不同,它不完全是一个ORM框架,因为MyBatis需要程序员自己编写Sql语句,不过mybatis可以通过XML或注解方式灵活配置要运行的sql语句,并将java对象和sql语句映射生成最终执行的sql,最后将sql执行的结果再映射生成java对象。
-
Mybatis学习门槛低,简单易学,程序员直接编写原生态sql,可严格控制sql执行性能,灵活度高,非常适合对关系数据模型要求不高的软件开发,例如互联网软件、企业运营类软件等,因为这类软件需求变化频繁,一但需求变化要求成果输出迅速。但是灵活的前提是mybatis无法做到数据库无关性,如果需要实现支持多种数据库的软件则需要自定义多套sql映射文件,工作量大。
-
Hibernate对象/关系映射能力强,数据库无关性好,对于关系模型要求高的软件(例如需求固定的定制化软件)如果用hibernate开发可以节省很多代码,提高效率。但是Hibernate的学习门槛高,要精通门槛更高,而且怎么设计O/R映射,在性能和对象模型之间如何权衡,以及怎样用好Hibernate需要具有很强的经验和能力才行。
-
总之,按照用户的需求在有限的资源环境下只要能做出维护性、扩展性良好的软件架构都是好架构,所以框架只有适合才是最好。
四. mybatis的Dao开发
-
使用Mapper代理接口开发方式(主流)
-
面向接口 没有实现类(看不到接口的实现类)
1. SqlSession的使用范围
-
SqlSession中封装了对数据库的操作,如:查询、插入、更新、删除等。
-
通过SqlSessionFactory创建SqlSession,而SqlSessionFactory是通过SqlSessionFactoryBuilder进行创建。
2. SqlSessionFactoryBuilder
- SqlSessionFactoryBuilder用于创建SqlSessionFacoty,SqlSessionFacoty一旦创建完成就不需要-SqlSessionFactoryBuilder了,因为SqlSession是通过SqlSessionFactory生产,所以可以将SqlSessionFactoryBuilder当成一个工具类使用,最佳使用范围是方法范围即方法体内局部变量。
3.SqlSessionFactory
- SqlSessionFactory是一个接口,接口中定义了openSession的不同重载方法,SqlSessionFactory的最佳使用范围是整个应用运行期间,一旦创建后可以重复使用,通常以单例模式管理SqlSessionFactory。
4. SqlSessoin
-
SqlSession是一个面向用户的接口, sqlSession中定义了数据库操作方法。
-
每个线程都应该有它自己的SqlSession实例。SqlSession的实例不能共享使用,它也是线程不安全的。因此最佳的范围是请求或方法范围。绝对不能将SqlSession实例的引用放在一个类的静态字段或实例字段中。
-
打开一个 SqlSession;使用完毕就要关闭它。通常把这个关闭操作放到 finally 块中以确保每次都能执行关闭。如下:
SqlSession session = sqlSessionFactory.openSession();
try {
// do work
} finally {
session.close();
}
5.开发规范
-
Mapper接口开发方式需要程序员编写Mapper接口(相当于Dao接口),由mybatis框架根据接口定义创建接口的动态代理对象,就是接口的实现类
-
Mapper 接口开发需要遵循以下规范
- Mapper.xml文件中的namespace与mapper接口的路径相同
- Mapper接口方法名和Mapper.xml中定义的每个statement的id相同
- Mapper 接口方法的输入参数类型和mapper.xml中定义的每个sql的parameterType的类型相同.
- Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同。
-
开始写代码 查所有 新增 修改 删除
-
测试类
-
//1.读取核心配置文件 sqlMapConfig.xml InputStream is = Resources.getResourceAsStream("sqlMapConfig.xml"); //2.找一个建筑者 盖工厂 SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder(); //3.构建工厂 SqlSessionFactory factory = builder.build(is); //4.工厂生产 sqlSession对象 SqlSession sqlSession = factory.openSession(); //5.sqlSession对象 代理 增删改查 List<Pet> pets = sqlSession.getMapper(IPetDao.class).selectPets(); System.out.println(pets);
五.SqlMapConfig.xml配置文件
- SqlMapConfig.xml中配置的内容顺序如下:
1.配置内容
-
properties(属性)
-
settings(全局配置参数)
-
typeAliases(类型别名)
-
typeHandlers(类型处理器)
-
objectFactory(对象工厂)
-
plugins(插件)
-
environments(环境集合属性对象)
-
environment(环境子属性对象)
-
transactionManager(事务管理)
-
dataSource(数据源)
-
mappers(映射器)
2. properties(属性)
- 注意: Mybatis按照下面的顺序来加载属性:
- 在properties 元素体内定义的属性首先被读取。
- 然后会读取propertis元素中resource或者url加载的属性,它会覆盖已读取的同名属性。
3. typeAliases(类型别名)
别名 | 映射的类型 |
---|---|
_byte | byte |
_long | long |
_short | short |
_int | int |
_integer | int |
_double | double |
_float | float |
_boolean | boolean |
string | String |
byte | Byte |
long | Long |
short | Short |
int | Integer |
integer | Integer |
double | Double |
float | Float |
boolean | Boolean |
date | Date |
decimal | BigDecimal |
bigdecimal | BigDecimal |
map | Map |
4. 自定义别名
<!-- 配置别名 -->
<typeAliases>
<!-- 配置别名 -->
<!-- <typeAlias type="com.whhp.mybatis.pojo.User" alias="user" /> -->
<!-- 基于包扫描的方式配置别名 -->
<package name="com.whhp.mybatis.pojo" />
</typeAliases>
5.mappers(映射器)
- 使用相对类路径的资源
<!-- resource 基于calsspath查找 resources文件夹下查找 -->
<mapper resource="sqlMap/User.xml" />
- 注册指定包下面的所有mapper接口
<!-- 使用扫描包的形式加载mapper文件 -->
<package name="com.whhp.mybatis.mapper"/>
//注意:此种方法要求mapper接口名称和mapper映射文件名称相同,且放在同一个目录中。