MyBatis快速入门
MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code,并且改名为MyBatis,是一个基于Java的持久层框架。
下载 MyBatis
官网下载太慢了
中文官网下载地址
mybatis-3.5.1.zip下载(我使用的版本)
下载好 MyBatis 的包解压后,可以得到以下的文件目录:
其中 mybatis-3.5.1.jar 包就是 MyBatis 的项目工程包,【lib】文件夹下就是 MyBatis 项目需要依赖的第三方包,pdf 文件是它英文版的说明。
第一个MyBatis程序
第一步 创建数据库
我使用是MySQL数据库
create database mybates_demo01;
use mybates_demo01;
CREATE TABLE `user` (
`id` int(11) PRIMARY KEY AUTO_INCREMENT,
`name` varchar(10) NOT NULL,
`gender` char(2)
);
//插入一条一条数据方便后面使用
insert user(`name`,`gender`) values('哈哈','男');
第二步 创建项目
创建一个名为myBates_01的项目,然后导入 必要的jar包:
- mybatis-3.5.1.jar
- mysql-connector-java-8.0.13.jar
第三步 创建实体类
package com.ll.bean;
public class User {
private int id;
private String name;
private String gender;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getGender() {
return gender;
}
public void setGender(String gender) {
this.gender = gender;
}
@Override
public String toString() {
// TODO Auto-generated method stub
return "id:"+id+",name:"+name+",gender:"+gender;
}
}
第四步 创建映射配置文件
在com.ll.mapper下创建名为UserMapper.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 namespace="UserMapper">
<!--
id:唯一标识,随便写,在同一个命名空间下保持唯一
resultType:sql语句查询结果集的封装类型,
resultType的值为要映射的实体类的全路径,这里实体类为User
-->
<select id="queryUserById" resultType="com.ll.bean.User">
<!-- #{id}中的id即为需要替换的值 -->
select * from user where id = #{id}
</select>
</mapper>
第五步 创建核心配置文件 mybatis-config.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="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis_demo01?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true"/>
<property name="username" value="dataname"/>
<property name="password" value="password"/>
</dataSource>
</environment>
</environments>
<!-- 映射文件全路径 -->
<mappers>
<mapper resource="com/ll/mapper/UserMapper.xml"/>
</mappers>
</configuration>
第六步:编写测试类
package com.ll.test;
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;
import com.ll.bean.User;
public class Test {
public static void main(String[] args) {
try {
// 指定全局配置文件
String resource = "mybatis-config.xml";
// 读取配置文件
InputStream inputStream = Resources.getResourceAsStream(resource);
// 构建sqlSessionFactory
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
// 获取sqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 第一个参数:指定statement,规则:命名空间+“.”+CRUD的ID
// 第二个参数:指定传入sql的参数:这里是用户ID
User user = sqlSession.selectOne("UserMapper.queryUserById", 1);
System.out.println(user);
//记得关闭sqlSession
sqlSession.close();
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
运行测试类结果:
查询是毫无毛病了,再看下增、删、改
配置UserMapper.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 namespace="UserMapper" -->
<mapper namespace="UserMapper">
<!--
id:唯一标识,随便写,在同一个命名空间下保持唯一
resultType:sql语句查询结果集的封装类型
-->
<select id="queryUserById" resultType="com.ll.bean.User">
select * from user where id = #{id}
</select>
<update id="upUserById">
update `user` set `name` = #{name} where id = #{id}
</update>
<delete id="deleteUserById">
delete from `user` where id =#{id}
</delete>
<insert id="addUser">
insert `user`(`name`,`gender`) value(#{name},#{gender})
</insert>
</mapper>
修改测试类
package com.ll.test;
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;
import com.ll.bean.User;
public class Test {
public static void main(String[] args) {
try {
// 指定全局配置文件
String resource = "mybatis-config.xml";
// 读取配置文件
InputStream inputStream = Resources.getResourceAsStream(resource);
// 构建sqlSessionFactory
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
// 获取sqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 操作CRUD,第一个参数:指定statement,规则:命名空间+“.”+CRUD的ID
// 第二个参数:指定传入sql的参数:这里是用户ID
User user = new User();
user.setName("嘿嘿");
user.setGender("男");
//此处传入的是user对象,因此UserMapper中需要替换的地方应与User类对应的属性名保持一致
sqlSession.insert("UserMapper.addUser", user);
sqlSession.commit();
user = sqlSession.selectOne("UserMapper.queryUserById", 2);
System.out.println("添加:"+user);
user.setId(2);
user.setName("呵呵");
sqlSession.update("UserMapper.upUserById", user);
sqlSession.commit();
user = sqlSession.selectOne("UserMapper.queryUserById", user);
System.out.println("修改后:"+user);
sqlSession.delete("UserMapper.deleteUserById",user);
sqlSession.commit();
user = sqlSession.selectOne("UserMapper.queryUserById", user);
System.out.println("删除后:"+user);
sqlSession.close();
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
运行测试类结果:
到此,简单的增删改查就做好了,但是有没有发现这样很low,每次操作都需要写很多重复的代码,尤其是在不同的类中,想想就可怕!下面用一种简单一点的方法:动态代理Mapper实现类(这也是官方推荐的)
创建接口类(UserDao)
- 接口类中方法名需要和映射文件(mapper.xml)中CRUD的ID保持一致
- mapper.xml中的namespace(命名空间)需要设置为对应接口类的全路径,这里为com.ll.dao.UserDao
package com.ll.dao;
import com.ll.bean.User;
public interface UserDao {
//增加
void addUser(User user);
//删除
void delUserById(int id);
//修改
void upUser(User user);
//查询
User queryUserById(int id);
}
修改测试类
package com.ll.test;
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;
import com.ll.bean.User;
import com.ll.dao.UserDao;
public class Test {
public static void main(String[] args) {
try {
// 指定全局配置文件
String resource = "mybatis-config.xml";
// 读取配置文件
InputStream inputStream = Resources.getResourceAsStream(resource);
// 构建sqlSessionFactory
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
// 获取sqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
UserDao userDao = sqlSession.getMapper(UserDao.class);
User user = new User();
user.setName("哈哈");
user.setGender("男");
userDao.addUser(user);
//执行数据操纵后记得提交事务
sqlSession.commit();
user = userDao.queryUserById(3);
System.out.println("添加:"+user);
user.setId(3);
user.setName("呵呵");
userDao.upUserById(user);
sqlSession.commit();
user = userDao.queryUserById(user.getId());
System.out.println("修改后:"+user);
userDao.delUserById(user.getId());
sqlSession.commit();
user = userDao.queryUserById(user.getId());
System.out.println("删除后:"+user);
sqlSession.close();
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
开启日志
导入引入日志依赖包:
- log4j-1.2.17.jar
在src目录下创建log4j.properties日志文件
log4j.rootLogger=OFF,E
log4j.logger.com=DEBUG
# Console output...
log4j.appender.E=org.apache.log4j.ConsoleAppender
log4j.appender.E.layout=org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern=%5p [%t] - %m%n
log4j.appender.E.Threshold = DEBUG
运行测试类结果:
欲知后事如何,且听下回分解