首先先了解一下mybatis的概念和架构
概念
先了解ORM(Object/Relational Mapping),即对象关系映射,它用来完成面向对象编程语言到关系数据库的映射。简单来说ORM的作用就是将持久化对象的增删改查操作转换成对关系数据库的操作。
ORM的基本映射关系:
- 数据表映射
- 数据表的行(一行单表一个数据)映射对象(实例)
- 数据表的列(字段)映射对象的属性
mybatis本来是apache的开源项目ibatis,后来移植到google code,并更名为现在的名字mybatis。
mybatis的优点:
- 支持定制化SQL,存储过程,以及高级映射。
- 避免JDBC代码,以及配置。
- 对结果集进行封装。
- 可以使用注解,将接口和java中的pojo映射成数据库中的记录。
mybatis的思想:将程序中大量的sql语句抽离出来,在配置文件中配置,以实现sql的灵活。
mybatis并不是一个完成的ORM框架,他可以通过编写sql,使得访问数据库更加灵活。准确的说是半自动化的ORM框架,是一种sql mapping框架。
架构
mybatis的架构分为三层:
接口层:提供给开发人员的API接口,通过这些API来操作数据库。
数据处理层:完成一次数据库请求,只要的流程是sql查找、sql解析、sql执行,以及对结果集的处理。
基础支撑层:负责最底层的东西,也是公用的东西,包括连接管理、事务管理、配置加载、缓存管理。
加载配置:mybatis根据配置来加载运行环境,创建SqlSessionFactory对象。配置来源于两个地方,xml配置文件和java注解。将配置信息转换成MappedStatement对象(包含传入参数映射配置,sql语句配置,结果集配置),存储在内存中。
sql解析:当调用API时,接受sql的id和传入对象(可以时map,javabean或基本类型)会根据sql的id找到对应MappedStatement对象,并解析MappedStatement对象。
sql执行:SqlSession 将sql和参数拿到数据库进行执行,得到数据库的操作结果。
结果集处理:将数据库的结果集转换成map、javabean或者基本数据类型。
开始创建mybatis项目。
完成项目源码:
wget http://labfile.oss.aliyuncs.com/courses/802/MybatisTest.zip
创建数据库和表:
create database mybatis;
use mybatis;
create table user(
id int primary key auto_increment,
username varchar(20),
password varchar(20),
sex varchar(10),
address varchar(20));
使用maven创建项目:
mvn archetype:generate -DgroupId=com.shiyanlou.mybatis -DartifactId=MyBatisTest -DarchetypeArtifactId=maven-archetype-quickstart
- groupId:项目的组织接够,也是项目的报结构。
- artifactId:项目的实际名称
- archetypeArtifactId:使用maven初始化项目
下载maven仓库,可以将里面的内容复制到自己的仓库中。
wget http://labfile.oss.aliyuncs.com/courses/802/m2.zip
打开pom.xml文件,将内容修改为一下:
<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/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.shiyanlou.mybatis</groupId>
<artifactId>MybatisTest</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>MybatisTest</name>
<url>http://maven.apache.org</url>
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.6</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>6.0.6</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
</dependencies>
<build>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.xml</include>
</includes>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.*</include>
</includes>
</resource>
</resources>
</build>
</project>
这里导入了三个东西,mybatis、mysql驱动、log4日志。另外实现maven的自动化构建操作。
在项目的src/main目录下创建resources文件夹,里面再创建mybatis.cfg.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">
<configuration>
<!-- 配置 mybatis 运行环境 -->
<environments default="development">
<environment id="development">
<!-- type="JDBC" 代表直接使用 JDBC 的提交和回滚设置 -->
<transactionManager type="JDBC" />
<!-- POOLED 表示支持 JDBC 数据源连接池 -->
<!-- 数据库连接池,由 Mybatis 管理,数据库名是 mybatis,MySQL 用户名 root,密码为空 -->
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver" />
<property name="url" value="jdbc:mysql://localhost:3306/mybatis" />
<property name="username" value="root" />
<property name="password" value="" />
</dataSource>
</environment>
</environments>
</configuration>
在包com.shiyanlou.mybatis.model下创建User.java,用户实体类:
package com.shiyanlou.mybatis.model;
public class User {
private Integer id;
private String username;
private String password;
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 String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
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;
}
}
在com.shiyanlou.mybatis.mapper包中创建接口UserMapper.java,实现简单的数据库的增删改查:
package com.shiyanlou.mybatis.mapper;
import java.util.List;
import com.shiyanlou.mybatis.model.User;
public interface UserMapper {
/*
* 新增用戶
* @param user
* @return
* @throws Exception
*/
public int insertUser(User user) throws Exception;
/*
* 修改用戶
* @param user
* @param id
* @return
* @throws Exception
*/
public int updateUser(User user) throws Exception;
/*
* 刪除用戶
* @param id
* @return
* @throws Exception
*/
public int deleteUser(Integer id) throws Exception;
/*
* 根据 id 查询用户信息
* @param id
* @return
* @throws Exception
*/
public User selectUserById(Integer id) throws Exception;
/*
* 查询所有的用户信息
* @return
* @throws Exception
*/
public List<User> selectAllUser() throws Exception;
}
在包 com.shiyanlou.mybatis.mapper 下新建映射文件 UserMapper.xml,用来定义各种sql语句和语句的参数,以及要返回的参数类型等:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org/DTD Mapper 3.0" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.shiyanlou.mybatis.mapper.UserMapper">
<!-- 自定义返回结果集 -->
<resultMap id="userMap" type="User">
<id property="id" column="id" javaType="int"></id>
<result property="username" column="username" javaType="String"></result>
<result property="password" column="password" javaType="String"></result>
<result property="sex" column="sex" javaType="String"></result>
<result property="address" column="address" javaType="String"></result>
</resultMap>
<!-- 定义 SQL 语句,其中 id 需要和接口中的方法名一致 -->
<!-- useGeneratedKeys:实现自动生成主键 -->
<!-- keyProperty: 唯一标记一个属性 -->
<!-- parameterType 指明查询时使用的参数类型,resultType 指明查询返回的结果集类型 -->
<insert id="insertUser" useGeneratedKeys="true" keyProperty="id">
insert into user (username,password,sex,address) values
(#{username},#{password},#{sex},#{address})
</insert>
<update id="updateUser" parameterType="User">
update user set
address=#{address} where
id=#{id}
</update>
<delete id="deleteUser" parameterType="int">
delete from user where
id=#{id}
</delete>
<!-- 如未为 Java Bean 起类别名,resultType="com.shiyanlou.mybatis.model.User" -->
<!-- 使用 resultType 时,一定要保证,你属性名与字段名相同;如果不相同,就使用 resultMap -->
<select id="selectUserById" parameterType="int" resultType="User">
select * from user where id=#{id}
</select>
<select id="selectAllUser" resultMap="userMap">
select * from user
</select>
</mapper>
UserMapping.xml映射文件加载后要在mybatis.xml文件中加载映射:
<mappers>
<!-- 通过 mapper 接口包加载整个包的映射文件 -->
<package name="com.shiyanlou.mybatis.mapper" />
</mappers>
同时为包其别名:
<!-- 为 JavaBean 起类别名 -->
<typeAliases>
<!-- 指定一个包名起别名,将包内的 Java 类的类名作为类的类别名 -->
<package name="com.shiyanlou.mybatis.model" />
</typeAliases>
在resources目录下新建log4j.properties文件:
# Global logging configuration
log4j.rootLogger=DEBUG, stdout
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n
在包 com.shiyanlou.mybatis.test 下新建测试类 UserTest.java , 用来测试数据的增删改查操作:
package com.shiyanlou.mybatis.test;
import java.io.IOException;
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;
import com.shiyanlou.mybatis.mapper.UserMapper;
import com.shiyanlou.mybatis.model.User;
public class UserTest {
private static SqlSessionFactory sqlSessionFactory;
public static void main(String[] args) {
// Mybatis 配置文件
String resource = "mybatis.cfg.xml";
// 得到配置文件流
InputStream inputStream = null;
try {
inputStream = Resources.getResourceAsStream(resource);
} catch (IOException e) {
e.printStackTrace();
}
// 创建会话工厂,传入 MyBatis 的配置文件信息
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
insertUser();
// updateUser();
// deleteUser();
// selectUserById();
// selectAllUser();
}
// 新增用戶
private static void insertUser() {
// 通过工厂得到 SqlSession
SqlSession session = sqlSessionFactory.openSession();
UserMapper mapper = session.getMapper(UserMapper.class);
User user = new User();
user.setUsername("Tom");
user.setPassword("123456");
user.setSex("male");
user.setAddress("chengdu");
try {
mapper.insertUser(user);
session.commit();
} catch (Exception e) {
e.printStackTrace();
session.rollback();
}
// 释放资源
session.close();
}
// 更新用戶
private static void updateUser() {
SqlSession session = sqlSessionFactory.openSession();
UserMapper mapper = session.getMapper(UserMapper.class);
User user = null;
try {
user = mapper.selectUserById(1);
} catch (Exception e1) {
e1.printStackTrace();
}
user.setAddress("chongqing");
try {
mapper.updateUser(user);
session.commit();
} catch (Exception e) {
e.printStackTrace();
session.rollback();
}
session.close();
}
// 删除用戶
private static void deleteUser() {
SqlSession session = sqlSessionFactory.openSession();
UserMapper mapper = session.getMapper(UserMapper.class);
try {
mapper.deleteUser(3);
session.commit();
} catch (Exception e) {
e.printStackTrace();
session.rollback();
}
session.close();
}
// 根据 id 查询用户信息
private static void selectUserById() {
SqlSession session = sqlSessionFactory.openSession();
UserMapper mapper = session.getMapper(UserMapper.class);
try {
User user = mapper.selectUserById(1);
session.commit();
System.out.println(user.getId() + " " + user.getUsername() + " "
+ user.getPassword() + " " + user.getSex() + " "
+ user.getAddress());
} catch (Exception e) {
e.printStackTrace();
session.rollback();
}
session.close();
}
// 查询所有的用户信息
private static void selectAllUser() {
SqlSession session = sqlSessionFactory.openSession();
UserMapper mapper = session.getMapper(UserMapper.class);
try {
List<User> userList = mapper.selectAllUser();
session.commit();
for (User user : userList) {
System.out.println(user.getId() + " " + user.getUsername() + " "
+ user.getPassword() + " " + user.getSex() + " "
+ user.getAddress());
}
} catch (Exception e) {
e.printStackTrace();
session.rollback();
}
session.close();
}
}
分别调用 UserTest 类中的增删改查方法。使用下面的命令就可以运行UserTest.java
mvn compile
mvn exec:java -Dexec.mainClass="com.shiyanlou.mybatis.test.UserTest" -Dexec.cleanupDaemonThreads=false
-end-