1 引导
框架的概念在以前的博文中也有提到,此处简单说明下,框架实质是软件开发中的一套解决方案,不同的框架解决的是不同的问题。
1)使用框架的好处:框架封装了很多细节,开发者可以很简单的实现某些功能,提高开发效率;
2)框架解决了什么问题?
看下三层架构和SSM框架的对应关系,MyBatis框架是解决的持久层的问题,与数据库交互,进行增删改查操作的。
3)持久层技术解决方案有哪些?
以上都不是框架,JDBC是规范,后两者都只是工具类,是对规范的实现,没有系统的解决方案。
以前使用传统jdbc的步骤很多,操作繁杂,我们要实现一个需求的功能,从数据库表中查找一个结果,希望没有这么多繁杂的操作步骤,把焦点放在功能的实现上即可,实现高效率开发,MyBatis框架就是帮我们解决这些问题的。
MyBatis是一个基于Java的持久层框架,封装了jdbc操作的细节,开发者只需要关注sql语句本身,不需要关注注册驱动、创建连接、创建statement等过程,它使用了ORM思想实现了结果集封装。
注:ORM,Object Relational Mapping对象关系映射,就是把数据库表和实体类的属性对应起来,让我们可以操作实体类就可以操作数据库表。我们需要保证实体类属性和数据库表的字段名称保持一致,有一个好习惯;
下面以一个案例形式一步步看下如何搭建MyBatis环境。
1)准备数据库,在本地数据库db4中新建一个user表,插入数据:
CREATE DATABASE db4;
USE db4;
CREATE TABLE USER (
id INT(11) NOT NULL PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(32) NOT NULL COMMENT '用户名称',
birthday DATETIME DEFAULT NULL COMMENT '生日',
sex VARCHAR(1) DEFAULT NULL COMMENT '性别',
address VARCHAR(256) DEFAULT NULL COMMENT '地址'
) ENGINE=INNODB DEFAULT CHARSET=utf8;
INSERT INTO `user`(`id`,`username`,`birthday`,`sex`,`address`) VALUES (1,'老王','2018-02-27 17:47:08','男','北京'),(2,'李四','2018-03-02 15:09:37','女','上海'),(3,'王五','2018-03-04 11:34:34','女','南京');
2)新建Maven工程,不使用模板,此处不展开了,需要回顾的可以看上一篇博文;
3)配置pom.xml文件,导入相关的jar包坐标:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.winter</groupId>
<artifactId>19.mybatis</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.5</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.6</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.12</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.10</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>
4)写一个User实体类,实现Serializable,数据库表对应
public class User implements Serializable {
private Integer id;
private String username;
private Date birthday;
private String sex;
private String address;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", username='" + username + '\'' +
", birthday=" + birthday +
", sex='" + sex + '\'' +
", address='" + address + '\'' +
'}';
}
}
5)写一个User的持久层接口
//User的持久层接口
public interface UserDao {
List<User> findAll();
}
至此,准备工作OK了,下面看下MyBatis的环境。
6)在resources包下新建SqlMapConfig.xml文件作为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">
<!--mybatis的主配置文件 -->
<configuration>
<!--配置环境 -->
<environments default="mysql">
<!--配置mysql环境 -->
<environment id="mysql">
<!--配置事务类型 -->
<transactionManager type="JDBC"></transactionManager>
<!--配置数据源(连接池) -->
<dataSource type="POOLED">
<!--配置连接数据库的四个基本信息 -->
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/db4"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<!--指定映射配置文件的位置,映射配置文件指的是每个dao独立的配置文件 -->
<mappers>
<mapper resource="com/winter/dao/UserDao.xml"></mapper>
</mappers>
</configuration>
7)新建每个dao的独立配置文件,注意三件事:
<?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.winter.dao.UserDao">
<!--配置查询所有 -->
<select id="findAll">
select * from user
</select>
</mapper>
映射配置文件中的限制很多,这么做的好处是什么呢?我们不需要再写dao的实现类了!(上述的独立配置文件还有点小问题,你发现了吗?没有的话继续阅读下文:))
完成以上后,工程目录结构如下:
在上一节环境搭建的基础上,我们看下如何使用MyBatis,使用的步骤是怎样的,可以总结为如下几个步骤:
在src.test.java.com.winter.test包下新建一个测试类MyBatisTest.java:
public class MyBatisTest {
//MyBatis入门案例
@Test
public void test() throws Exception{
//1、读取配置文件
InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml");
//2、创建SqlSessionFactory工厂
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
SqlSessionFactory factory = builder.build(in);
//3、使用工厂生产SqlSession对象
SqlSession session = factory.openSession();
//4、使用SqlSession创建Dao接口的代理对象
UserDao userDao = session.getMapper(UserDao.class);
//5、使用代理对象执行方法
List<User> users = userDao.findAll();
for (User user : users) {
System.out.println(user);
}
//6、释放资源
session.close();
in.close();
}
}
【运行测试】:发现如下异常问题出现:
### Error querying database. Cause: org.apache.ibatis.executor.ExecutorException: A query was run and no Result Maps were found for the Mapped Statement 'com.winter.dao.UserDao.findAll'. It's likely that neither a Result Type nor a Result Map was specified. |
---|
我们在UserDao.xml里面写了sql查询语句,但是MyBatis不知道查询结果要封装到哪里去,所以要在UserDao.xml中对应提供另一个指定的对象类型,修正后的UserDao.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.winter.dao.UserDao">
<!--配置查询所有 -->
<select id="findAll" resultType="com.winter.domain.User">
select * from user
</select>
</mapper>
再次运行测试OK:
【小插曲——调试问题】:开始MyBatisTest中使用public static void main(String[] args)方法测试,但是运行时始终报错:
Failed to execute goal org.codehaus.mojo:exec-maven-plugin:3.0.0:exec (default-cli) on project 19.mybatis: Command execution failed.
网上查找各种解决方法,如项目的java版本配置和JDK要一致等等,最后都没解决,怀疑是Maven支持的JDK版本问题,我的是14.0.1,最后通过junit解决,@Test注解运行就可以了。
基于上述案例,分析下设计模式。
1)读取配置文件
不建议使用绝对路径,或相对路径,不够灵活,实际项目中多使用以下两种:
2)创建SqlSessionFactory工厂
MyBatis使用了构建者模式,把对象的创建细节隐藏,使用者直接调用方法即可获取对象。像我们自己盖厂房一样,不是事事亲为,我们找个包工队,告诉需求,给钱即可:
3)创建SqlSession对象
使用了工厂模式,降低了类之间的依赖关系
4)创建dao接口的代理对象
使用了代理模式,不修改源码的基础上对已有方法增强;
以上基于xml的实现方式是不是感觉有些麻烦,映射配置文件有很多要对应的关系,下面来看下比较简单的方式,使用注解,相比于xml,主要改变在于:
【UserDao接口】:
public interface UserDao {
@Select("select * from user")
List<User> findAll();
}
【SqlMapConfig.xml中mapper配置】:
<!--指定映射配置文件的位置,映射配置文件指的是每个dao独立的配置文件
若使用注解配置,应该使用class属性指定被注解的dao全限定类名
-->
<mappers>
<mapper class="com.winter.dao.UserDao"></mapper>
</mappers>
【注意】:实际MyBatis也是支持写dao实现类的,但是实际开发中追求的理念就是越简单越好,无论是xml还是注解形式,一般都是不写dao实现类。
———————————————————————————————————
本文为博主原创文章,转载请注明出处!