初识mybatis(二)

上篇博客我们介绍通过Java代码来创建mybatis的配置文件，港真，这种方式看起来有意思实际在开发中用的并不多，mybatis的配置还是以xml配置为主，本文我们就来看看如何通过xml文件来配置mybatis。关于mybatis的一些基础知识小伙伴们可以参考这篇博客 初识mybatis。另外，上篇博客中，小伙伴们也看到了通过添加jar包的方式来搭建mybatis环境太过于麻烦，so，本文我们还是回归到Maven上吧。OK，废话不多说，开始今天的coding之旅吧。

创建Project并添加Maven支持

我这里以IntelliJ为例来说明如何创建，先创建一个普通的java工程，创建成功之后，选中工程右键单击，选择Add Framework Support，然后选择Maven，点击OK就可以了。添加Maven支持src目录下多了几个文件夹，同时也多了一个pom.xml文件，如下：



然后在pom.xml文件中添加相关依赖，我们这里一共添加三个，一个mybatis、单元测试、mysql驱动，如下：

<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.2</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.40</version>
</dependency>

</dependencies>

OK，如此我的mybatis环境就搭建好了。接下来我们还是按照上文的顺序来看看要怎么做。

通过xml创建mybatis配置

在创建xml配置文件的时候，对于数据库的配置信息我们可以直接创建一个db.properties文件，然后将数据库的配置信息放入其中，如下：

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis
username=root
password=sang

注意，所有的配置文件我们都放在resources文件夹下(小伙伴如果放错了会出现文件找不到的情况，这个时候仔细检查下都很好解决的)，如下图：



有了数据库配置信息，接下来我们就可以创建mybatis的配置文件了，我这里配置文件取名为mybatis-conf.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>
<properties resource="db.properties"/>
<typeAliases>
<typeAlias type="org.sang.bean.User" alias="user"/>
</typeAliases>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="userMapper.xml"/>
</mappers>
</configuration>

关于这个配置文件我说如下几点：



有了这个XML文件，接下来我们就可以通过这个xml文件来获取一个SqlSession了，当然，如上篇博客所述，我们需要把SqlSessionFactory搞成单例模式，所以创建方式如下：

public class DBUtils {
private static SqlSessionFactory sqlSessionFactory = null;
private static final Class CLASS_LOCK = DBUtils.class;

public static SqlSessionFactory initSqlSessionFactory() {
InputStream is = null;
try {
is = Resources.getResourceAsStream("mybatis-conf.xml");
} catch (IOException e) {
e.printStackTrace();
}
synchronized (CLASS_LOCK) {
if (sqlSessionFactory == null) {
sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
}
}
return sqlSessionFactory;
}

public static SqlSession openSqlSession() {
if(sqlSessionFactory==null)
initSqlSessionFactory();
return sqlSessionFactory.openSession();
}
}

关于这个类我这里就不做过多说明了，小伙伴们有疑问可以参考上篇博客。

创建Mapper

上篇博客我们说过Mapper由两部分组成，Java接口+注解或者Java接口+XML配置，我们在上篇博客中使用Java接口+注解的方式来创建了Mapper，那么本文我们就来看看一种更常用的方式Java接口+XML配置的方式。

创建Java接口：

public interface UserMapper {
public User getUser(Long id);

public int insertUser(User user);

public int deleteUser(Long id);
}

小伙伴们注意，这里我并没有给getUser方法添加@Select注解，我们将在xml配置文件中通过xml来解决这个问题，同时我们还添加了两个方法，一个向数据库中添加数据，一个删除数据。

创建配置文件

在resources中创建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="org.sang.db.UserMapper">
<select id="getUser" resultType="user" parameterType="Long">
select * from user where id = #{id}
</select>
<insert id="insertUser" parameterType="user">
INSERT INTO user(username,password,address) VALUES (#{username},#{password},#{address})
</insert>
<delete id="deleteUser" parameterType="Long">
DELETE FROM user where id=#{id}
</delete>
</mapper>

关于这个配置文件我说两点：



OK ，最后再给小伙伴们看看我们的实体类，如下：

public class User {
private Long id;
private String username;
private String password;
private String address;

//省略getter/setter
}

OK，如此之后，我们就可以来测试代码啦。

测试

查询

@Test
public void test1() {
SqlSession sqlSession = null;
try {
sqlSession = DBUtils.openSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.getUser(1l);
System.out.println(user);
sqlSession.commit();
} catch (Exception e) {
e.printStackTrace();
sqlSession.rollback();
} finally {
if (sqlSession != null) {
sqlSession.close();
}
}

}

查询结果如下：

添加

@Test
public void test2() {
SqlSession sqlSession = null;
try {
sqlSession = DBUtils.openSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
for (int i = 0; i < 3; i++) {
userMapper.insertUser(new User(null, "u-" + i, "p-" + i, "a-" + i));
}
sqlSession.commit();
} catch (Exception e) {
e.printStackTrace();
sqlSession.rollback();
} finally {
if (sqlSession != null) {
sqlSession.close();
}
}
}

添加结果：

删除

@Test
public void test3() {
SqlSession sqlSession = null;
try {
sqlSession = DBUtils.openSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
int i = userMapper.deleteUser(5l);
System.out.println(i);
sqlSession.commit();
} catch (Exception e) {
e.printStackTrace();
sqlSession.rollback();
} finally {
if (sqlSession != null) {
sqlSession.close();
}
}
}

删除结果：



OK，以上就是我们通过xml配置文件来使用mybatis。

本文案例下载：

本文案例GitHub地址https://github.com/lenve/JavaEETest/tree/master/Test27-mybatis3。

以上。

参考资料:

1.http://www.mybatis.org/mybatis-3/zh/index.html

2.《深入浅出MyBatis 技术原理与实战》第二章