一、在 Web 应用中使用 MyBatis
项目目录结构
pojo
package org.qiu.bank.pojo;
/**
* 账户类,封装账户数据
* @author 秋玄
* @version 1.0
* @package org.qiu.bank.pojo
* @date 2022-09-27-20:31
* @since 1.0
*/
public class Account {
private Long id;
private String actno;
private Double balance;
@Override
public String toString() {
return "Account{" +
"id=" + id +
", actno='" + actno + '\'' +
", balance=" + balance +
'}';
}
public Account(Long id, String actno, Double balance) {
this.id = id;
this.actno = actno;
this.balance = balance;
}
public Account() {
}
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public String getActno() {
return actno;
}
public void setActno(String actno) {
this.actno = actno;
}
public Double getBalance() {
return balance;
}
public void setBalance(Double balance) {
this.balance = balance;
}
}
dao
package org.qiu.bank.dao;
import org.qiu.bank.pojo.Account;
/**
* @author 秋玄
* @version 1.0
* @package org.qiu.bank.dao
* @date 2022-09-28-10:11
* @since 1.0
*/
public interface AccountDao {
Account select(String actno);
int update(Account account);
}
package org.qiu.bank.dao.impl;
import org.apache.ibatis.session.SqlSession;
import org.qiu.bank.dao.AccountDao;
import org.qiu.bank.pojo.Account;
import org.qiu.bank.utils.SqlSessionUtil;
/**
* @author 秋玄
* @version 1.0
* @package org.qiu.bank.dao.impl
* @date 2022-09-28-10:13
* @since 1.0
*/
public class AccountDaoImpl implements AccountDao {
@Override
public Account select(String actno) {
SqlSession sqlSession = SqlSessionUtil.openSession();
Account account = sqlSession.selectOne("account.selectById", actno);
sqlSession.close();
return account;
}
@Override
public int update(Account account) {
SqlSession sqlSession = SqlSessionUtil.openSession();
int count = sqlSession.update("account.updateByActno", account);
sqlSession.commit();
sqlSession.close();
return count;
}
}
mybatis 的 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="account">
<select id="selectById" resultType="org.qiu.bank.pojo.Account">
select * from t_act where actno = #{actno};
</select>
<update id="updateByActno">
update t_act set balance = #{balance} where actno = #{actno}
</update>
</mapper>
service
package org.qiu.bank.service;
import org.qiu.bank.exceptions.MoneyNotEnoughException;
import org.qiu.bank.exceptions.TransferException;
/**
* @author 秋玄
* @version 1.0
* @package org.qiu.bank.service
* @date 2022-09-28-10:06
* @since 1.0
*/
public interface AccountService {
void transfer(String fromActno,String toActno,Double money) throws MoneyNotEnoughException, TransferException;
}
package org.qiu.bank.service.impl;
import org.qiu.bank.dao.AccountDao;
import org.qiu.bank.dao.impl.AccountDaoImpl;
import org.qiu.bank.exceptions.MoneyNotEnoughException;
import org.qiu.bank.exceptions.TransferException;
import org.qiu.bank.pojo.Account;
import org.qiu.bank.service.AccountService;
/**
* @author 秋玄
* @version 1.0
* @package org.qiu.bank.service.impl
* @date 2022-09-28-10:08
* @since 1.0
*/
public class AccountServiceImpl implements AccountService {
AccountDao accountDao = new AccountDaoImpl();
@Override
public void transfer(String fromActno, String toActno, Double money) throws MoneyNotEnoughException, TransferException {
Account fromAct = accountDao.select(fromActno);
if (fromAct.getBalance() < money) {
// 余额不足
throw new MoneyNotEnoughException("对不起,余额不足");
}
Account toAct = accountDao.select(toActno);
fromAct.setBalance(fromAct.getBalance() - money);
toAct.setBalance(toAct.getBalance() + money);
int count = accountDao.update(fromAct);
count += accountDao.update(toAct);
if (count != 2) {
throw new TransferException("转账异常");
}
}
}
异常处理类
package org.qiu.bank.exceptions;
/**
* @author 秋玄
* @version 1.0
* @package org.qiu.bank.exceptions
* @date 2022-09-28-10:22
* @since 1.0
*/
public class MoneyNotEnoughException extends Exception{
public MoneyNotEnoughException(){}
public MoneyNotEnoughException(String message) {
super(message);
}
}
package org.qiu.bank.exceptions;
/**
* @author 秋玄
* @version 1.0
* @package org.qiu.bank.exceptions
* @date 2022-09-28-10:35
* @since 1.0
*/
public class TransferException extends Exception{
public TransferException() {
}
public TransferException(String message) {
super(message);
}
}
controller
package org.qiu.bank.web;
import org.qiu.bank.exceptions.MoneyNotEnoughException;
import org.qiu.bank.exceptions.TransferException;
import org.qiu.bank.service.AccountService;
import org.qiu.bank.service.impl.AccountServiceImpl;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
/**
* @author 秋玄
* @version 1.0
* @package org.qiu.bank.web
* @date 2022-09-28-09:59
* @since 1.0
*/
@WebServlet("/transfer")
public class AccountServlet extends HttpServlet {
AccountService accountService = new AccountServiceImpl();
@Override
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// 获取表单数据
String fromActno = request.getParameter("fromActno");
String toActno = request.getParameter("toActno");
Double money = Double.parseDouble(request.getParameter("money"));
try {
// 调用 service 的转账方法完成转账
accountService.transfer(fromActno,toActno,money);
// 调用 View 展示结果
response.sendRedirect(request.getContextPath() + "/success.html");
} catch (MoneyNotEnoughException e) {
response.sendRedirect(request.getContextPath() + "/err1.html");
} catch (TransferException e) {
response.sendRedirect(request.getContextPath() + "/err2.html");
}
}
}
测试:浏览器访问 http://localhost:8080/bank/
存在的问题:
当用户进行转账时,需要更新两个账号的余额信息,若两次更新操作之间,程序出现了异常,此时对于收款账号的更新操作不会执行,但是转账账号的余额更新操作已经完成,所以会造成数据丢失问题。
解决思路:
首先考虑的肯定是给更新操作添加事务,使得程序对两个账号余额的更新操作同时成功或者同时失败。在 transfer 方法开始执行时开启事务,直到两个更新都成功之后,再提交事务
存在的问题:
在给两次更新操作添加事务后发现,上述的问题并未得到解决。原因是 service 和 dao 里使用的 SqlSession 对象不是同一个。
解决思路:
为了保证 service 和 dao 中使用的 SqlSession 对象是同一个,可以将 SqlSession 对象存放到 ThreadLocal 当中
改造工具类
package org.qiu.bank.utils;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
/**
* MyBatis工具类
*
* @author 秋玄
* @version 1.0.0
* @since 1.0.0
*/
public class SqlSessionUtil {
private static SqlSessionFactory sqlSessionFactory;
private static ThreadLocal<SqlSession> local = new ThreadLocal<>();
/**
* 类加载时初始化sqlSessionFactory对象
*/
static {
try {
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsStream("mybatis-config.xml"));
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* 每调用一次openSession()可获取一个新的会话,该会话支持自动提交。
* @return 新的会话对象
*/
public static SqlSession openSession() {
SqlSession sqlSession = local.get();
if (sqlSession == null) {
sqlSession = sqlSessionFactory.openSession();
local.set(sqlSession);
}
return sqlSessionFactory.openSession();
}
/**
* 关闭 SqlSession 对象
* @param sqlSession
*/
public static void close(SqlSession sqlSession){
if (sqlSession != null) {
sqlSession.close();
// tomcat 支持线程池,所以关闭 SqlSession 需要将其从当前线程中移除
local.remove();
}
}
}
改造 transfer 方法
@Override
public void transfer(String fromActno, String toActno, Double money) throws MoneyNotEnoughException, TransferException {
SqlSession sqlSession = SqlSessionUtil.openSession();
Account fromAct = accountDao.select(fromActno);
if (fromAct.getBalance() < money) {
// 余额不足
throw new MoneyNotEnoughException("对不起,余额不足");
}
Account toAct = accountDao.select(toActno);
fromAct.setBalance(fromAct.getBalance() - money);
toAct.setBalance(toAct.getBalance() + money);
int count = accountDao.update(fromAct);
// 模拟异常
String s = null;
s.toString();
count += accountDao.update(toAct);
if (count != 2) {
throw new TransferException("转账异常");
}
sqlSession.commit();
SqlSessionUtil.close(sqlSession);
}
改造 DaoImpl
public class AccountDaoImpl implements AccountDao {
@Override
public Account select(String actno) {
SqlSession sqlSession = SqlSessionUtil.openSession();
Account account = sqlSession.selectOne("account.selectById", actno);
return account;
}
@Override
public int update(Account account) {
SqlSession sqlSession = SqlSessionUtil.openSession();
int count = sqlSession.update("account.updateByActno", account);
return count;
}
}
二、MyBatis 对象作用域
SqlSessionFactoryBuilder
这个类可以被实例化、使用和丢弃,一旦创建了 SqlSessionFactory,就不再需要它了。
因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域(也就是局部方法变量)。
可以重用 SqlSessionFactoryBuilder 来创建多个 SqlSessionFactory 实例,但最好还是不要一直保留着它,以保证所有的 XML 解析资源可以被释放给更重要的事情。
SqlSessionFactory
SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。
使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次,多次重建 SqlSessionFactory 被视为一种代码“坏习惯”。
因此 SqlSessionFactory 的最佳作用域是应用作用域。
有很多方法可以做到,最简单的就是使用单例模式或者静态单例模式。
SqlSession
每个线程都应该有它自己的 SqlSession 实例。
SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域。
绝对不能将 SqlSession 实例的引用放在一个类的静态域,甚至一个类的实例变量也不行。
也绝不能将 SqlSession 实例的引用放在任何类型的托管作用域中,比如 Servlet 框架中的 HttpSession。
如果现在正在使用一种 Web 框架,考虑将 SqlSession 放在一个和 HTTP 请求相似的作用域中。
换句话说,每次收到 HTTP 请求,就可以打开一个 SqlSession,返回一个响应后,就关闭它。
这个关闭操作很重要,为了确保每次都能执行关闭操作,应该把这个关闭操作放到 finally 块中。
下面的示例就是一个确保 SqlSession 关闭的标准模式:
try (SqlSession session = sqlSessionFactory.openSession()) {
// 应用逻辑代码
}
一 叶 知 秋,奥 妙 玄 心