MyBatis学习笔记(1)

阅读数: 次 2021-03-26

文章导航

MyBatis学习笔记

⛅ ⛅ ⛅

利用接口实现增删改查，Mapper…

MyBatis简介

一. MyBatis历史

1）MyBatis是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation 迁移到了Google Code，随着开发团队转投Google Code旗下， iBatis3.x 正式更名为MyBatis ，代码于2013年11月迁移到Github

2）iBatis一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。 iBatis 提供的持久层框架包括SQL Maps和Data Access Objects（DAO）

二. MyBatis简介

1） MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架

2） MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集

3） MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO（Plain Old Java Objects，普通的Java对象）映射成数据库中的记录

4） Mybatis 是一个 半自动的ORM（Object Relation Mapping）框架

三. 如何下载MyBatis

1). 下载网址

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

四. 持久化技术的对比

1).JDBC

① SQL夹在Java代码块里，耦合度高导致硬编码内伤
② 维护不易且实际开发需求中sql有变化，频繁修改的情况多见

2).Hibernate和JPA

① 长难复杂SQL，对于Hibernate而言处理也不容易
② 内部自动生产的SQL，不容易做特殊优化
③ 基于全映射的全自动框架，大量字段的POJO进行部分映射时比较困难。导致数据库性能下降

3).MyBatis

① 对开发人员而言，核心sql还是需要自己优化
② sql和java编码分开，功能边界清晰，一个专注业务、一个专注数据

五. 优缺点

优点:
1.简单易学
2.程序与sql语言分离，降低耦合，重用
3.支持动态sql
4.sql与对象之间的映射
缺点:
1.工作量大
2.可移植性差

六. Mybatis执行过程

1). 语言描述

2). 图解

七. 三个对象的作用域

作用域	有效范围	生命周期
SqlSessionFactoryBuilder	局部变量	方法体内
SqlSessionFactory	整个程序	application
SqlSession	一次会话	jsp里的session

八. session方法

selectOne(查询一条数据)
insert(插入数据)
update(修改数据)
delete(删除数据)
selectList (查询多条数据)
getMapper(①要保证映射文件的包名和接口的类全名一致,②要保证映射文件里的id和接口的标准名一致)

MyBatis Helloworld项目

一. 开发环境的准备

1). 导入MyBatis框架的jar包、Oracle驱动包、log4j的jar包

jar包

2). 导入log4j 的配置文件

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
 
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
 
 <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
   <param name="Encoding" value="UTF-8" />
   <layout class="org.apache.log4j.PatternLayout">
    <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m  (%F:%L) \n" />
   </layout>
 </appender>
 <logger name="java.sql">
   <level value="debug" />
 </logger>
 <logger name="org.apache.ibatis">
   <level value="info" />
 </logger>
 <root>
   <level value="debug" />
   <appender-ref ref="STDOUT" />
 </root>
</log4j:configuration>

二. 创建javaBean(实体类)

1). 属性名要和表的列名相同

package com.AAA.Text1;

import java.util.Date;

public class Emp {
	private Integer empno;
	private String ename;
	private String job;
	private Date hiredate;
	private Double sal;
	private Integer deptno;
	
	public Emp() {
		super();
		// TODO Auto-generated constructor stub
	}

	public Emp(int empno, String ename, String job, Date hiredate, double sal, int deptno) {
		super();
		this.empno = empno;
		this.ename = ename;
		this.job = job;
		this.hiredate = hiredate;
		this.sal = sal;
		this.deptno = deptno;
	}

	public int getEmpno() {
		return empno;
	}

	public void setEmpno(int empno) {
		this.empno = empno;
	}

	public String getEname() {
		return ename;
	}

	public void setEname(String ename) {
		this.ename = ename;
	}

	public String getJob() {
		return job;
	}

	public void setJob(String job) {
		this.job = job;
	}

	public Date getHiredate() {
		return hiredate;
	}

	public void setHiredate(Date hiredate) {
		this.hiredate = hiredate;
	}

	public double getSal() {
		return sal;
	}

	public void setSal(double sal) {
		this.sal = sal;
	}

	public int getDeptno() {
		return deptno;
	}

	public void setDeptno(int deptno) {
		this.deptno = deptno;
	}

	@Override
	public String toString() {
		return "Emp [empno=" + empno + ", ename=" + ename + ", job=" + job + ", hiredate=" + hiredate + ", sal=" + sal
				+ ", deptno=" + deptno + "]";
	}
	
}

三. 创建MyBatis的全局配置文件

1). 参考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>
	<!-- 和spring整合后environments配置将废除 -->
	<environments default="development">
		<!-- 开发环境 -->
		<environment id="development">
		<!-- 配置事务提交方式 
			JDBC:利用JDBC方式处理事务(commit rollback close)
             MANAGED:将事务交由其他组件去托管(spring,jobss),默认关闭连接
		-->
		<transactionManager type="JDBC"/>
		<!-- 数据库连接池
			POOLED:使用数据库连接池
			UNPOOLED:不使用连接池,频繁开关数据库消耗性能
			JNDI:从tomcat中获取一个内置的数据库连接池(第三方)
		-->
		<dataSource type="POOLED">
			<!-- 配置数据库信息 -->
			<property name="driver" value="oracle.jdbc.OracleDriver"/>
			<property name="url" value="jdbc:oracle:thin:@127.0.0.1:1521:BOOKSHOP"/>
			<property name="username" value="scott"/>
			<property name="password" value="123456"/>
		</dataSource>
		</environment>
	</environments>
	<mappers>
		<!-- 加载映射文件 -->
		<mapper resource="com/AAA/Text1/EmpMapper.xml"/>
	</mappers>
</configuration>

四. 创建Mybatis的sql映射文件

1). <select>:定义查询语句

2). ID:设置SQL语句的唯一标识

3). resultType:结果类型，即实体类的全限定名

<?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:该mapper.xml映射文件的唯一标识 -->
	<mapper namespace="com.AAA.Text1.EmpMapper">
	<!-- resultType:查询返回结果值的类型，parameterType:输入参数类型 -->
    <select id="getEmp" resultType="com.AAA.Text1.Emp" parameterType="int">
        select * from emp where empno= #{empno}
    </select>
    <select id="getEmps" resultType="com.AAA.Text1.Emp" parameterType="String">
        select * from emp where job= #{job}
    </select>
</mapper>

五. 测试

package com.AAA.Text1;

import java.io.InputStream;
import java.util.List;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class Text {
	public static void main(String[] args) throws Exception {
		//mybatis全局配置文件
		String resource = "MybatisConfig.xml";
		InputStream inputStream = Resources.getResourceAsStream(resource);
		//创建会话工厂
		SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(inputStream);
		//通过工厂得到SqlSession
		SqlSession session = factory.openSession();
		//通过SqlSession操作数据库
		//第一个参数：映射文件的statement的id，等于namespace+“.”+statement的id
		//第二个参数：指定和映射文件中所匹配的所有parameterType类型的对象
		Emp emp = session.selectOne("com.AAA.Text1.EmpMapper.getEmp",7788);
		System.out.println("编号为7788的员工信息：");
		System.out.println(emp);
		List<Emp> emps = session.selectList("com.AAA.Text1.EmpMapper.getEmps", "SALESMAN");
		System.out.println("工作为SALESMAN的员工信息：");
		System.out.println(emps);
		session.close();
	}
}

MyBatis CRUD项目

目录结构

catalog

注意事项
1). 如果使用的事务方式为 jdbc,则需要手工commit提交，即session.commit();

2). 所有的标签 <select> <update>等，都必须有sql语句，但是sql参数值可选
select* from student where stuno = #{xx}

3). sql有参数：session.insert(statement, 参数值 );
sql没参数：session.insert(statement);

一. 创建一个实体类

package com.AAA.Text.entity;

import java.util.Date;

public class Emp {
	private Integer empno;
	private String ename;
	private String job;
	private Integer mgr;
	private Date hiredate;
	private Double sal;
	private Double comm;
	private Integer deptno;
	
	public Emp(Integer empno, String ename, String job, Integer mgr, Date hiredate, Double sal, Double comm,
			Integer deptno) {
		super();
		this.empno = empno;
		this.ename = ename;
		this.job = job;
		this.mgr = mgr;
		this.hiredate = hiredate;
		this.sal = sal;
		this.comm = comm;
		this.deptno = deptno;
	}
	public Emp() {
		super();
		// TODO Auto-generated constructor stub
	}
	public Integer getEmpno() {
		return empno;
	}
	public void setEmpno(Integer empno) {
		this.empno = empno;
	}
	public String getEname() {
		return ename;
	}
	public void setEname(String ename) {
		this.ename = ename;
	}
	public String getJob() {
		return job;
	}
	public void setJob(String job) {
		this.job = job;
	}
	public Integer getMgr() {
		return mgr;
	}
	public void setMgr(Integer mgr) {
		this.mgr = mgr;
	}
	public Date getHiredate() {
		return hiredate;
	}
	public void setHiredate(Date hiredate) {
		this.hiredate = hiredate;
	}
	public Double getSal() {
		return sal;
	}
	public void setSal(Double sal) {
		this.sal = sal;
	}
	public Double getComm() {
		return comm;
	}
	public void setComm(Double comm) {
		this.comm = comm;
	}
	public Integer getDeptno() {
		return deptno;
	}
	public void setDeptno(Integer deptno) {
		this.deptno = deptno;
	}
	@Override
	public String toString() {
		return "Emp [empno=" + empno + ", ename=" + ename + ", job=" + job + ", mgr=" + mgr + ", hiredate=" + hiredate
				+ ", sal=" + sal + ", comm=" + comm + ", deptno=" + deptno + "]";
	}	
}

二. 创建一个工具类

package com.AAA.Text.util;

import java.io.IOException;
import java.io.InputStream;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class MybatisUtil {
	private static SqlSession session;
	private static SqlSessionFactory factory;
	public static SqlSession getSession() {
        //通过工厂获取session对象来操作MyBatis
		session = factory.openSession();
		return session;
	}
	public static SqlSessionFactory getFactory() {
		return factory;
	}
	static{
		String resource = "MybatisConfig.xml";
		InputStream inputStream = null;
		try{
         	 //将配置文件变成对象
			inputStream = Resources.getResourceAsStream(resource);
		}catch(IOException e){
			e.printStackTrace();
		}
        //建造工厂
		factory = new SqlSessionFactoryBuilder().build(inputStream);
	}
}

三. 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" >
	<mapper namespace="com.AAA.Text.EmpMapper">
    <select id="getEmpno" resultType="com.AAA.Text.entity.Emp" parameterType="int">
        select * from emp where empno= #{empno}
    </select>
    <select id="getEmps" resultType="com.AAA.Text.entity.Emp">
        select * from emp
    </select>
    <insert id="addEmp" parameterType="com.AAA.Text.entity.Emp">
    	insert into Emp values(#{empno},#{ename},#{job},#{mgr},#{hiredate},#{sal},#{comm},#{deptno})
    </insert>
    <update id="updateEmp" parameterType="com.AAA.Text.entity.Emp">
    	update emp set ename=#{ename},job=#{job},mgr=#{mgr},hiredate=#{hiredate},sal=#{sal},comm=#{comm},deptno=#{deptno} where empno=#{empno}
    </update>
    <delete id="deleteEmp" parameterType="com.AAA.Text.entity.Emp">
    	delete from emp where empno=#{empno} 
    </delete>
</mapper>

四. 创建一个Mapper接口

接口中的方法必须遵循以下约定：

1.方法名和mapper.xml文件中标签的id值相同

2.方法的输入参数和mapper.xml文件中标签的 parameterType类型一致 (如果mapper.xml的标签中没有 parameterType，则说明方法没有输入参数)
3.方法的返回值和mapper.xml文件中标签的 resultType类型一致（无论查询结果是一个还是多个（Emp、List），在mapper.xml标签中的resultType中只写一个（Emp）；如果没有resultType，则说明方法的返回值为void）

package com.AAA.Text.dao;

import java.util.List;

import com.AAA.Text.entity.Emp;


public interface EmpMapper {
	public void add(Emp emp);
	public void update(Emp emp);
	public void delete(Emp emp);
	public Emp selectEmpByEmpno(Integer empno);
	public List<Emp> selectEmps();
}

五. 实现这个接口

package com.AAA.Text.dao.impl;

import java.util.List;

import org.apache.ibatis.session.SqlSession;

import com.AAA.Text.dao.EmpMapper;
import com.AAA.Text.entity.Emp;
import com.AAA.Text.util.MybatisUtil;

public class EmpMapperImpl implements EmpMapper {

	@Override
	public void add(Emp emp) {
		// TODO Auto-generated method stub
		SqlSession session = MybatisUtil.getSession();
		session.insert("com.AAA.Text.EmpMapper.addEmp",emp);
		session.commit();
		session.close();
	}

	@Override
	public void update(Emp emp) {
		// TODO Auto-generated method stub
		SqlSession session = MybatisUtil.getSession();
		session.update("com.AAA.Text.EmpMapper.updateEmp",emp);
		session.commit();
		session.close();
	}

	@Override
	public void delete(Emp emp) {
		// TODO Auto-generated method stub
		SqlSession session = MybatisUtil.getSession();
		session.delete("com.AAA.Text.EmpMapper.deleteEmp",emp);
		session.commit();
		session.close();
	}

	@Override
	public Emp selectEmpByEmpno(Integer empno) {
		SqlSession session = MybatisUtil.getSession();
		Emp emp = session.selectOne("com.AAA.Text.EmpMapper.getEmpno",empno);
		session.close();
		return emp;
	}

	@Override
	public List<Emp> selectEmps() {
		// TODO Auto-generated method stub
		SqlSession session = MybatisUtil.getSession();
		List<Emp> emp = session.selectList("com.AAA.Text.EmpMapper.getEmps");
		session.close();
		return emp;
	}

}

六. 测试

package com.AAA.Text.test;

import java.util.Date;
import java.util.List;

import com.AAA.Text.dao.EmpMapper;
import com.AAA.Text.dao.impl.EmpMapperImpl;
import com.AAA.Text.entity.Emp;


public class Test {
	public static void main(String[] args) throws Exception {
		EmpMapper em = new EmpMapperImpl();
		System.out.println("----------查寻所有员工信息-----------");
		List<Emp> emps = em.selectEmps();
		for(Emp emp : emps){
			System.out.println(emp);
		}

		System.out.println("----------根据员工编号查员工信息-----------");
		Emp emp = em.selectEmpByEmpno(7788);
		System.out.println(emp);

//		System.out.println("----------插入一个员工-----------");
//		emp = new Emp(8888,"张三","总统",7788,new Date(),1000.0,5.0,40);
//		em.add(emp);
//		System.out.println("添加成功！");
		System.out.println("----------修改一个员工-----------");
		emp = new Emp(8888,"特朗普","总统",7369,new Date(),1200.0,15.0,40);
		em.update(emp);
		System.out.println("修改成功！");
		System.out.println("----------根据编号删除一个员工-----------");
		emp = new Emp(8888,"特朗普","总统",7369,new Date(),1200.0,15.0,40);
		em.delete(emp);
		System.out.println("删除成功！");

	}
}

Mapper动态实现CRUD

getMapper绑定
1). 根据接口名找到 mapper.xml文件（根据的是namespace=接口全类名）
2). 根据接口的方法名找到 mapper.xml文件中的SQL标签（方法名=SQL标签Id值）

习惯：SQL映射文件（mapper.xml）和接口放在同一个包中（注意修改全局配置文件中加载mapper.xml文件的路径）

约定的目标： 省略掉实现方法,即根据约定直接可以定位出SQL语句

目录结构
catalog

一. 删除实现类,修改映射文件

映射文件修改地址，要在配置文件中重新设置
namespace的值，就是接口的全类名（接口 - mapper.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="com.AAA.Text.dao.EmpMapper">
    <select id="selectEmpByEmpno" resultType="com.AAA.Text.entity.Emp" parameterType="int">
        select * from emp where empno= #{empno}
    </select>
    <select id="selectEmps" resultType="com.AAA.Text.entity.Emp">
        select * from emp
    </select>
    <insert id="add" parameterType="com.AAA.Text.entity.Emp">
    	insert into Emp values(#{empno},#{ename},#{job},#{mgr},#{hiredate},#{sal},#{comm},#{deptno})
    </insert>
    <update id="update" parameterType="com.AAA.Text.entity.Emp">
    	update emp set ename=#{ename},job=#{job},mgr=#{mgr},hiredate=#{hiredate},sal=#{sal},comm=#{comm},deptno=#{deptno} where empno=#{empno}
    </update>
    <delete id="delete" parameterType="com.AAA.Text.entity.Emp">
    	delete from emp where empno=#{empno} 
    </delete>
</mapper>

二. 工具类

factory.openSession(true) 该方法需改为自动提交事务

package com.AAA.Text.util;

import java.io.IOException;
import java.io.InputStream;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class MybatisUtil {
	public static SqlSession session;
	public static SqlSessionFactory factory;
	public static SqlSession getSession() {
		session = factory.openSession();
		return session;
	}
	public static SqlSessionFactory getFactory() {
		return factory;
	}
	static{
		String resource = "MybatisConfig.xml";
		InputStream inputStream = null;
		try{
			inputStream = Resources.getResourceAsStream(resource);
		}catch(IOException e){
			e.printStackTrace();
		}
		factory = new SqlSessionFactoryBuilder().build(inputStream);
	}
}

三. 测试

package com.AAA.Text.test;

import java.util.Date;
import java.util.List;

import com.AAA.Text.dao.EmpMapper;
import com.AAA.Text.entity.Emp;
import com.AAA.Text.util.MybatisUtil;


public class Test {
	public static void main(String[] args) throws Exception {
		//Mapper接口:获取Mapper接口的 代理实现类对象
		EmpMapper em = MybatisUtil.getSession().getMapper(EmpMapper.class);
		System.out.println("自动创建的代理对象"+em.getClass().getSimpleName());
		System.out.println("----------查寻所有员工信息-----------");
		List<Emp> emps = em.selectEmps();
		for(Emp emp : emps){
			System.out.println(emp);
		}

		System.out.println("----------根据员工编号查员工信息-----------");
		Emp emp = em.selectEmpByEmpno(7788);
		System.out.println(emp);

//		System.out.println("----------插入一个员工-----------");
//		emp = new Emp(8888,"张三","总统",7788,new Date(),1000.0,5.0,40);
//		em.add(emp);
//		System.out.println("添加成功！");
//		System.out.println("----------修改一个员工-----------");
//		emp = new Emp(8888,"特朗普","总统",7369,new Date(),1100.0,15.0,40);
//		em.update(emp);
//		System.out.println("修改成功！");
//		System.out.println("----------根据编号删除一个员工-----------");
//		emp = new Emp(8888,"特朗普","总统",7369,new Date(),1200.0,15.0,40);
//		em.delete(emp);
//		System.out.println("删除成功！");
	}
}

优化

可以将配置信息单独放入 db.properties文件中，然后再动态引入

一. 创建db.properties文件

driver=oracle.jdbc.OracleDriver
url=jdbc:oracle:thin:@127.0.0.1:1521:BOOKSHOP
username=scott
password=123456

二. 修改全局配置文件

<?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="db.properties"/>
	<!-- 设置连接数据库的环境，和spring整合后environments配置将废除 -->
	<environments default="development">
		<!-- 设置某个具体的数据库环境 -->
		<environment id="development">
			<!-- 使用JDBC事务管理 -->
			<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>
	<mappers>
		<!-- 加载映射文件 -->
		<mapper resource="com/AAA/Text/dao/EmpMapper.xml"/>
	</mappers>
</configuration>

扩展

insert从序列中获取主键值

1). sql映射文件

  <insert id="add" parameterType="com.AAA.Text.entity.Emp" databaseId="oracle">
<!-- 
	keyProperty:查出的主键值封装给javaBean的哪个属性
	order="BEFORE":当前sql在插入sql之前运行
		AFTER:当前sql在插入sql之后运行
	resultType:查出的数据的返回值类型
 -->
  	<selectKey keyProperty="id" order="BEFORE" resultType="Integer">
  		select EMPLOYEES_SEQ.nextval from dual
  	</selectKey>    
  	insert into Emp values(#{id},#{EmpName},#{email})
  </insert>

参数传递

1). 单个普通类型参数
可以接受基本类型，包装类型，字符串类型等。这种情况MyBatis可直接使用这个参数，不需要经过任何处理。

2). 多个参数
任意多个参数，都会被MyBatis重新包装成一个Map传入。Map的key是param1，param2，或者0，1…，值就是参数的值

3). 命名参数
为参数使用@Param起一个名字，MyBatis就会将这些参数封装进map中，key就是我们自己指定的名字

4). POJO
当这些参数属于我们业务POJO时，我们直接传递POJO

5). Map
我们也可以封装多个参数为map，直接传递

6). Collection/Array
会被MyBatis封装成一个map传入, Collection对应的key是collection,Array对应的key是array. 如果确定是List集合，key还可以是list.

本文作者： 腾飞
本文链接： https://www.tengfei.eu.org/article/f6f3f545.html
版权声明： 本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。转载请注明出处！