mybatis作为一个持久层的框架,依据上一篇mybatis框架结构
(1)SqlMapConfig.xml,它的配置结构中,当没有和spring整合之前,由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>
<properties resource="jdbc.properties">
</properties>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="config/UserMapper.xml"/>
<mapper resource="config/User.xml"/>
</mappers>
</configuration>
其中用到了一个资源,jdbc.properties
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis
jdbc.username=root
jdbc.password=admin
映射文件的配置一般如下:针对基于dao开发和基于mapper接口开发,他们的配置文件分别时
User.xml
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="test">
<!-- 第一种方式,基于dao的方式-->
<select id="selectUser" parameterType="int" resultType="com.ajin.mybatis.model.User">
select * from userinfo where id = #{id}
</select>
</mapper>
<?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.ajin.mybatis.mapper.UserMapper">
<!-- 第二种方式,基于mapper接口的方式-->
<!-- 查询用户 -->
<select id="selectUser" parameterType="int" resultType="com.ajin.mybatis.model.User">
select * from userinfo where id = #{id}
</select>
</mapper>
可以看出第二种方式命名空间指定的位置为我们放置mapper接口定义的位置
上述返回类型中User对应的java对象定义如下:
package com.ajin.mybatis.model;
/**
* Created by ajin on 16-12-14.
*/
public class User {
private int id;
private String name;
private String password;
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 getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
}
(2)SqlSessionFactory的获取方法,通过SqlSessionFactoryBuilder来从SqlMapConfig.xm文件文件来创建,代码如下
String resource = "org/mybatis/example/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
(3)在Usermapper.xml中命名空间对应的mapper类定义如下:
这里就涉及到开发的两种方式:基于dao方式,那么我们编写dao的类的方法如下:
package com.ajin.mybatis.dao;
import com.ajin.mybatis.model.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
/**
* Created by ajin on 16-12-14.
*/
public class UserDao {
//使用dao方式,可以看出里面需要写很多代码
private SqlSessionFactory sqlSessionFactory;
public UserDao(SqlSessionFactory sqlSessionFactory) {
this.sqlSessionFactory = sqlSessionFactory;
}
public User selectUser(int id){
SqlSession sqlSession= sqlSessionFactory.openSession();
User user =sqlSession.selectOne("test.selectUser",id);
return user;
}
}
然后来编写这个dao的单元测试用例:
package com.ajin.mybatis.dao;
import com.ajin.mybatis.mapper.UserMapper;
import com.ajin.mybatis.model.User;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Before;
import org.junit.Test;
import java.io.InputStream;
import static org.junit.Assert.*;
/**
* Created by ajin on 16-12-14.
*/
public class UserDaoTest {
//第一种使用dao方式对应的单元测试
//配置log4j.properties文件用来打印执行的日志记录,如果不不配值,虽然能够执行成功,但是会报没有log的warning,建议配置
private SqlSessionFactory sqlSessionFactory;
@Before
public void setUp() throws Exception {
String resource = "config/SqlMapConfig.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
this.sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
}
@Test
public void selectUser() throws Exception {
UserDao userDao = new UserDao(sqlSessionFactory);
User user =userDao.selectUser(2);
System.out.print("!!!!!!!!!"+user.getName());
}
}
因为UserDao需要初始化一个sqlsessionFactory,因此在执行我们单元测试的方法之前需要首先初始化这个对象
如果使用的时mapper接口的方式,那么我们使用junit来编写UserMapper接口的查询用户的方法定义如下:
package com.ajin.mybatis.mapper;
import com.ajin.mybatis.model.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
/**
* Created by ajin on 16-12-14.
*/
public interface UserMapper {
//使用mapper接口的方式,可以看出仅仅定义一个方法即可 接口中默认的时public的方法,所以不用修饰
//需要注意的是使用这种方式时,需要对应的UserMapper.xml文件的namespace即为这个接口的全限定名称
//对应的方法名称和映射文件中的statement的id需要一致
User selectUser(int id);
void insertUser(User user);
void deleteUser(int id);
void updateUser(User user);
}
对应的mapper中的单元测试方法如下:
package com.ajin.mybatis.mapper;
import com.ajin.mybatis.model.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.Before;
import org.junit.Test;
import javax.jws.soap.SOAPBinding;
import java.io.InputStream;
import static org.junit.Assert.*;
/**
* Created by ajin on 16-12-14.
*/
public class UserMapperTest {
//第二种使用dao方式对应的单元测试
//配置log4j.properties文件用来打印执行的日志记录,如果不不配值,虽然能够执行成功,但是会报没有log的warning,建议配置
private SqlSessionFactory sqlSessionFactory;
@Before
public void setUp() throws Exception {
String resource = "config/SqlMapConfig.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
}
@Test
public void selectUser() throws Exception {
SqlSession session = sqlSessionFactory.openSession();
try {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectUser(2);
System.out.print("!!!"+user.getName());
} finally {
session.close();
}
}
@Test
public void insertUser() throws Exception {
User user= new User();
user.setName("zcj");
user.setPassword("zcj");
SqlSession sqlSession= sqlSessionFactory.openSession();
try{
UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
userMapper.insertUser(user);
//对于插入,需要执行commit提交一下
sqlSession.commit();
System.out.println(user.getId());
}finally {
sqlSession.close();
}
}
@Test
public void deleteUser() throws Exception {
SqlSession sqlSession= sqlSessionFactory.openSession();
try{
UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
userMapper.deleteUser(9);
sqlSession.commit();
}finally {
sqlSession.close();
}
}
@Test
public void updateUser() throws Exception {
User user =new User();
user.setId(12);
user.setName("qqx");
user.setPassword("qqx");
SqlSession sqlSession= sqlSessionFactory.openSession();
try{
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
userMapper.updateUser(user);
sqlSession.commit();
}finally {
sqlSession.close();
}
}
}
从我后来添加的添加,删除,修改用户的代码可以看出,数据库的每次操作都需要sqlsession,而创建它的sqlsessionfactory就可以用一个单利模式来管理,将来和spring整合之后,就用单例模式来管理sqlsessionfactory。sqlsession是线程不安全的,在sqlsession实现类中有接口中的方法还有数据域属性。因此它的最佳应用场景应该放在方法体内。
上述主要讲了通过xml的方式来完成mybatis单独操作数据库进行数据库读写的整个操作和文件配置方式,当然也可以使用注解的方式来开发,这部分内容可以参照官方的文档来学
上面讲述了两种开发方法:
(1)通过分析原始dao开发方法,我们会发现随着dao类中方法的不断增多,会出现新建sqlsession ,sqlsession提交和sqlsession释放等大量的模板方法存在重复,第二点就是将statement的id给硬编码了,第三就是调用sqlsession的方法时传入的变量,由于sqlsession方法使用泛型,即使变量参数错误,在编译阶段不报错,不利于程序员的开发
(2)基于mapper接口开发:需要遵循一定的开发规范 1。namespace等于mapper接口的全限定名2。方法名称和statement的id要一样3。输入参数类型parameterType和方法的参数类型一致4。输出参数返回类型resultType类型和方法的返回类型一致。mybatis依据上述规则就可以生成mapper接口的代理对象
注意:在建立单元测试的时候,很多实用eclipse的用户,直接在类方法上右键就可以看到生成junit测试类,但是在intel idea中,需要按照如下操作
右键---选择Go to ---选择Test ---选择create new test ...
然后就会弹出面板,里面可以设置选择junit的版本,测试类的名称,目的包和所要测试的方法,然后ok之后会弹出选择生成测试类的位置,是在main源码目录下,还是单独穿件test source root目录下,然后选中ok即可
demo的源码可以参考:
https://github.com/zcjwhu/mybatis_demo