实际开发中并没有完整使用过mybatis持久层框架,只在搞培训的时候简单接触过,也记得不是很清晰了,趁着新公司新项目的开始阶段,抽个时间把mybatis完整的过一遍。
一个基础的mybatis示例
<?xml version="1.0" encoding="UTF-8"?>
<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/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>tk.mybatis</groupId>
<artifactId>simple</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<build>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
</plugins>
</build>
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.3.0</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.38</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.12</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
<dependency>
<groupId>org.testng</groupId>
<artifactId>testng</artifactId>
<version>RELEASE</version>
</dependency>
</dependencies>
</project> 复制代码
这里是基础的maven配置项。引入了mybatis、mysql、log4j、test等包。
第一个基础demo使用xml形式进行配置。(数据库内容忽略)
在src/main/resource下创建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>
<settings>
<setting name="logImpl" value="LOG4J"/>
<!--是否自动安装驼峰规则将数据库下划线字段转换为java字段,默认为false
<setting name="mapUnderscoreToCamelCase" value="true"/>-->
</settings>
<!--<typeAliases>-->
<!--类型别名,给包取别名,若有此配置项,则在mapper.xml不用写完整类路径,否则需完整路径-->
<!--<package name="tk.mybatis.simple.model"/>-->
<!--</typeAliases>-->
<environments default="development">
<environment id="development">
<transactionManager type="JDBC">
<property name="" value=""/>
</transactionManager>
<dataSource type="UNPOOLED">
<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="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<!--也支持扫包的形式-->
<!--<package name="tk.mybatis.simple.mapper"/>-->
<mapper resource="tk/mybatis/simple/mapper/CountryMapper.xml"/>
</mappers>
</configuration>复制代码
新建一个Country实体类在src/main/java下的tk.mybatis.simple.model包里:
public class Country {
private Long id;
private String countryname;
private String countrycode;
//getset方法略
@Override
public String toString() {
return this.getId()+"==="+this.getCountrycode()+"==="+this.getCountryname();
}
}复制代码
为Country实体类创建对应的xml配置文件,在src/main/resource下 新建tk/mybatis/simple/mapper文件夹,新建CountryMapper.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="tk.mybatis.simple.mapper.CountryMapper">
<!--这里的resultType由于mybatis-config中配置了typeAliases别名,所以直接引用类名,否则需要全路径-->
<select id="selectAll" resultType="Country">
select id,countryname,countrycode from country
</select>
</mapper>复制代码
这里有一个namespace的配置项,这个配置项的值可以是任意值,但是当它是任意值的时候,在调用该mapper下的方法时,需要额外进行注册。即:SqlSessionFactory sqlSessionFactory = MyBatisUtil.getSessionFactory();
SqlSession session = sqlSessionFactory.openSession();
session.getConfiguration().addMapper(XXXMapper.class);进行注册,若mapper.xml中的namespace是对应mapper的实体类的类路径,则无需进行注册。
XXXMapper mapper = session.getMapper(XXXMapper.class);
在使用基于注解的方式的时候,由于没有了mapper.xml,也就没有了namespace,所以必须进行注册,当然也可以添加一个空的mapper.xml。
编写测试类进行代码测试:
public class CountryMapperTest {
private static SqlSessionFactory sqlSessionFactory;
@BeforeClass
public static void init(){
try {
Reader reader = Resources.getResourceAsReader("mybatis-config.xml");
sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
reader.close();
}catch (Exception e){
e.printStackTrace();
}
}
@Test
public void testSelectAll(){
SqlSession sqlSession = sqlSessionFactory.openSession();
try {
List<Country> list = sqlSession.selectList("tk.mybatis.simple.mapper.CountryMapper.selectAll");
//这里使用的全路径+方法对应ID,避免方法名重复,若确定只有一个方法名存在,可以直接使用方法名,忽略前面的包路径
for (int i = 0; i<list.size();i++){
System.out.println(list.get(i));
}
}catch (Exception e){
e.printStackTrace();
}finally {
sqlSession.close();
}
}
}复制代码
到这里一个简单的查询功能就通过mybatis框架实现了。