目录
今天,让我们一起从零开始,创建一个mybatis的小项目吧。
1.一点常识(创建项目)
首先,让我们打开idea(关于idea的一些讲解可以看我的另一篇博客),点击新建项目,如下图所示
点击之后,我们会进入到下面的界面
然后我们点击maven,可以看到下面的界面
因为这里我们是要创建mybatis项目,所以这里的模板都用不到,直接点击下一步,看到如下界面
然后我们点击“完成”,就到如下界面
至此,我们的mybatis项目的框架就搭建好了,下面让我们来配置它。
2.配置Mybatis(Mybatis的准备工作)
截止到上面,我们所拥有的只是一个简单的框架,里面没有任何jar包,实现不了任何功能。现在,为了能够实现mybatis的一些功能,我们引入一些jar包,主要包括以下几种:
1.引入MyBatis的3.4.5的版本的坐标
2.引入MySQL驱动的jar包,5.1.6版本
3.引入Junit单元测试的jar包
4.引入log4j的jar包,1.2.12版本(需要引入log4j.properties的配置文件)
我们在pom文件中引入它们,粘贴下面的内容:
<dependencies>
<!--mybatis核心包-->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.5</version>
</dependency>
<!--mysql驱动包-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.6</version>
</dependency>
<!-- 单元测试 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.10</version>
</dependency>
<!-- 日志 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
</dependencies>
当然,如果你是第一次引入,一些东西可能会报红,不用着急,我们点击右上方的“m”符号,idea会自动帮我们加载这些东西的,结果就如下图所示:
到了这一步,我们就引入好了相关的jar包了,这样我们在后面就可以用这些包里的东西了
3.创建数据库
Mybatis就是用编辑器实现对数据库的增删改查的,所以我们得有一个数据库。
现在,打开我们的数据库,建库
操作如下图:
然后,我们来建表,操作如下图:
建表的代码:
CREATE TABLE `user` (
`id` int(11) NOT NULL auto_increment,
`username` varchar(32) NOT NULL COMMENT '用户名称',
`birthday` datetime default NULL COMMENT '生日',
`sex` char(1) default NULL COMMENT '性别',
`address` varchar(256) default NULL COMMENT '地址',
PRIMARY KEY (`id`)
) 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','女','深圳'),(4,'光头强','2018-03-04 12:04:06','男','广州');
然后,我们刷新一下表,就完成了(我这里是用原来的,和上面的数据不一样)
至此,我们的准备工作全部完成,下面就开始真正的书写运行Mybatis了
4.配置xml文件
对数据库实现增删改查肯定要用到sql语句,那么在哪写sql语句?我们写了这些语句,idea如何加载它?这里,我们就需要创建并配置相关的xml语句,以此实现上述功能。
在此之前,我们先做一些目录的说明:
我们知道,我们的代码一般放在src—main下面,在这里,main下面的java包,放我们的java代码,main下面的resource包,放我们的一些配置文件,我们的mapper就放在这里,我们的xml文件也放在这里。
首先,我们创建一个目录,命名为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="">
</mapper>
然后,我们在我们的xml目录下,创建我们的xml文件,如下图所示
创建完成就如下图所示:
当然,你可能会遇到第4行报红的错误,显示什么url的问题,我们可以右键它,点解决方法,选择“获取外部资源”,然后让idea加载一会儿就好了
然后,我们来创建我们的sqlMapConfig.xml文件,操作如下图:
创建完成之后就是下面的这幅景象:
至此,我们的xml配置文件都创建好了(注意:第20行要引入mapper里面的xml文件)
现在,我们来解决没有sqlMapConfig.xml文件的问题,和上面创建mybatis-mapper.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>
<environments default="mysql">
<environment id="mysql">
<!--配置事务的类型,使用本地事务策略-->
<transactionManager type="JDBC"></transactionManager>
<!--是否使用连接池 POOLED表示使用链接池,UNPOOLED表示不使用连接池-->
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/具体的库"/>
<property name="username" value="用户名"/>
<property name="password" value="密码"/>
</dataSource>
</environment>
</environments>
<mappers>
</mappers>
</configuration>
5.书写java代码
前面,我们说了相关的目录知识,下面,我们就来在java里面书写java代码。
首先,我们在java下面创建一个包,命名为你所在的工作组
然后,我们再创建一个包,命名为entity,这里放的就是javaBean类,即实体类
然后,我们在entity包里创建我们的Javabean类,即我们的实体类
(根据我们数据库的表,我们将其命名为User)
然后,我们根据数据库里面的字段,在User类中创建全局变量,并生成get与set和toString方法
当然,你也可以直接粘贴下面的代码:
package com.qcby.entity;
import java.io.Serializable;
import java.util.Date;
public class User {
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 + '\'' +
'}';
}
}
提示:快捷键alt+enter: 导入类; alt+insert: 添加Getter、Setter、toString方法;Ctrl+a: 全选
然后,我们再创建一个包,命名为dao,里面放我们所写的接口,如下图所示:
然后,我们更加接口类中的内容,在mapper下的UserDao文件里面写相关的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.qcby.dao.UserDao">
<select id="findAll" resultType="com.qcby.entity.User">
select * from user
</select>
</mapper>
至此,我们的所有工作都做好了,下面进行测试。
6.书写测试代码
我们在test下的java下面创建UserTest文件,用来专门测试User,如下图所示:
当然,你可以直接粘贴代码:
import com.qcby.dao.UserDao;
import com.qcby.entity.User;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
public class UserTest {
private InputStream in = null;
private SqlSession session = null;
private UserDao mapper = null;
@Before //前置通知, 在方法执行之前执行
public void init() throws IOException {
//加载主配置文件,目的是为了构建SqlSessionFactory对象
in = Resources.getResourceAsStream("SqlMapConfig.xml");
//创建SqlSessionFactory对象
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(in);
//通过SqlSessionFactory工厂对象创建SqlSesssion对象
session = factory.openSession();
//通过Session创建UserDao接口代理对象
mapper = session.getMapper(UserDao.class);
}
@After //@After: 后置通知, 在方法执行之后执行 。
public void destory() throws IOException {
//释放资源
session.close();
in.close();
}
/**
* 测试查询所有的方法
*/
@Test
public void findAll() throws IOException {
List<User> users = mapper.findAll();
for (User user:users) {
System.out.println(user.toString());
}
}
}
然后,我们点击这里的运行符号,选择“运行......”
下面,让我们一起来看一看结果:
至此,我们的第一个mybatis小程序终于写完了。
下面再附赠一张Mybatis入门流程总结的图(里面有些不懂的没关系,后面会说)
当然,对于一些新手而言,还有许多不懂的地方,不用着急,这里我们只是先建了一个项目,然后让他跑起来,至于原理与细节,我们后面讲(可以看我的另一篇博客)
如果有什么问题,敬请各位大佬指出。