【MyBatis框架】MyBatis入门程序第一部分

摘要: MyBiatis框架

我们通过写一个简单的MyBatis小项目来在实战中学习MyBatis

1.需求
根据用户id（主键）查询用户信息
根据用户名称模糊查询用户信息
添加用户
删除 用户
更新用户

mybatis运行环境（jar包）：
从https://github.com/mybatis/mybatis-3/releases下载，3.2.7版本
lib下：依赖包
mybatis-3.2.7.jar：核心 包
mybatis-3.2.7.pdf，操作指南
加入mysql的驱动包
加入的所有jar包如图(可以在这里下载:http://download.csdn.net/detail/u013517797/8781295)

2.创建log4j.properties
在src中放入日志配置文件
文件内容(拷贝自官方帮助文档)

# Global logging configuration
#在开发环境下日志级别要设成DEBUG，生产环境设为INFO或ERROR
log4j.rootLogger=DEBUG, stdout
# MyBatis logging configuration...
log4j.logger.org.mybatis.example.BlogMapper=TRACE
# 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

接下来创建SqlMapConfig.xml等文件
配置好之后的整个工程结构为图

3.SqlMapConfig.xml
SqlMapConfig.xml内容如下
(由于没有整合Spring，暂时在environments中配数据库连接池dataSource，整合Spring之后将这一块删除就行了)

<?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>
<!-- 和spring整合后 environments配置将废除-->
<environments default="development">
<environment id="development">
<!-- 使用jdbc事务管理-->
<transactionManager type="JDBC" />
<!-- 数据库连接池-->
<dataSource type="POOLED">
<property name="driver" value="org.gjt.mm.mysql.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8"/>
<property name="username" value="root"/>
<property name="password" value="1234"/>
</dataSource>
</environment>
</environments>
</configuration>

4.创建PO(persistant object持久对象)类
在数据库中创建mtbatis数据库，创建user表，表详细内容为
id<int>、username<vachar>、birthday<Date>、sex<int>、address<vachar>
在cn.edu.hpu.mybatis.PO包下创建PO对象User.java:

package cn.edu.hpu.mybatis.PO;
import java.util.Date;
public class User {
private int id;
private String username;// 用户姓名
private String sex;// 性别
private Date birthday;// 生日
private String address;// 地址

public int getId() {
return id;
}

public void setId(int id) {
this.id = id;
}

public String getUsername() {
return username;
}

public void setUsername(String username) {
this.username = username;
}

public String getSex() {
return sex;
}

public void setSex(String sex) {
this.sex = sex;
}

public Date getBirthday() {
return birthday;
}

public void setBirthday(Date birthday) {
this.birthday = birthday;
}

public String getAddress() {
return address;
}

public void setAddress(String address) {
this.address = address;
}

}

5.编写User.xml配置文件
我们来写User.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">

<!-- namespace命名空间，作用就是对sql进行分类化管理，理解sql隔离
注意:使用mapper代理方法开发，namespace有特殊重要的作用 -->

<mapper namespace="test">
<!-- 在映射文件中配置很多sql语句 -->
<!-- 需求:通过id查询用户表的记录 -->
<!-- 通过select执行数据库查询，
id:标示映射文件中的sql，成为Statement的id
将sql语句封装到mappedStatement对象中，所以将id称为statement的id,
parameterType:指定输入参数的类型，
#{}标示一个占位符,
#{id}其中id表示接收输入参数的名称，如果输入参数是简单类型，那么#{}中的值可以任意。
resultType：指定sql输出结果的映射的java对象类型，
select指定resultType表示将单条记录映射成java对象-->
<select id="findUserById" parameterType="int" resultType="cn.edu.hpu.mybatis.PO.User">
SELECT * FROM USER WHERE id=#{id}
</select>
</mapper>

6.在SqlMapConfig.xml中加载映射文件(User.xml)

<!-- 加载映射文件 -->
<mappers>
<mapper resource="sqlmap/User.xml"/>
</mappers>

7.编写程序
(1)同归id查询用户
在cn.edu.hpu.mybatis.first包下编写测试样例MyBatisfirst.java
这里我们查询id为1的用户

package cn.edu.hpu.mybatis.first;
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 org.junit.Test;
import cn.edu.hpu.mybatis.PO.User;

public class MyBatisfirst {
private SqlSession sqlSession=null;
//根据id查询用户信息，得到一条记录结果
@Test
public void findUserById(){
//mybatis配置文件
String resource="SqlMapConfig.xml";
//将配置文件加载成流
InputStream inputStream;
try {
inputStream = Resources.getResourceAsStream(resource);
//创建会话工厂，传入mybatis配置文件的信息
SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);
//通过工厂得到sqlSession
sqlSession=sqlSessionFactory.openSession();
//通过SqlSession操作数据库
//第一个参数:映射文件中的statement的Id，等于=namespace+"."+statement的Id
//第二个参数:指定和映射文件所匹配的parameterType类型的参数
//sqlSession.selectOne最终结果与你映射文件中所匹配的resultType类型
User user=sqlSession.selectOne("test.findUserById",1);//数据库id=1的字段username为"张三"
System.out.println(user.getUsername());
} catch (IOException e) {
e.printStackTrace();
}finally{
//释放资源
sqlSession.close();
}
}
}

测试结果:张三
查看控制台Console输出的日志记录:

DEBUG [main] - Logging initialized using 'class org.apache.ibatis.logging.slf4j.Slf4jImpl' adapter.
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.
DEBUG [main] - Opening JDBC Connection
DEBUG [main] - Created connection 29683960.
DEBUG [main] - Setting autocommit to false on JDBC Connection [com.mysql.jdbc.Connection@1c4f0f8]
DEBUG [main] - ==> Preparing: SELECT * FROM USER WHERE id=?
DEBUG [main] - ==> Parameters: 1(Integer)
DEBUG [main] - <== Total: 1
张三
DEBUG [main] - Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.Connection@1c4f0f8]
DEBUG [main] - Closing JDBC Connection [com.mysql.jdbc.Connection@1c4f0f8]
DEBUG [main] - Returned connection 29683960 to pool.
很清晰的看到整个执行过程

(2)通过用户名模糊查询用户id
使用User.xml，添加根据用户名称模糊查询用户信息的sql语句。

<!-- ${}:表示拼接sql串，将接收到的参数内容不加任何修饰拼接在sql中。
使用${}拼接sql，引起sql注入。
${}中只能使用value-->
<select id="findUserByUsername" parameterType="java.lang.String"
resultType="cn.edu.hpu.mybatis.PO.User">
select * from user where username like '%${value}%'
</select>

测试方法：
//根据用户姓名模糊查询用户id，得到一个记录集合

@Test
public void findUserByName(){
//mybatis配置文件
String resource="SqlMapConfig.xml";
//将配置文件加载成流
InputStream inputStream;
try {
inputStream = Resources.getResourceAsStream(resource);
//创建会话工厂，传入mybatis配置文件的信息
SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);
//通过工厂得到sqlSession
sqlSession=sqlSessionFactory.openSession();
//通过SqlSession操作数据库
//第一个参数:映射文件中的statement的Id，等于=namespace+"."+statement的Id
//第二个参数:指定和映射文件所匹配的parameterType类型的参数
//sqlSession.selectOne最终结果与你映射文件中所匹配的resultType类型
List<User> users=sqlSession.selectList("test.findUserByUsername","张三");
//数据库一共有两个相关数据，"张三"和"张三丰"
for (int i = 0; i < users.size(); i++) {
User u=users.get(i);
System.out.println(u.getId()+":"+u.getUsername());

}
} catch (IOException e) {
e.printStackTrace();
}finally{
//释放资源
sqlSession.close();
}

}

测试结果：
1:张三
4:张三丰
输出的日志信息：

DEBUG [main] - PooledDataSource forcefully closed/removed all connections.
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.
DEBUG [main] - Opening JDBC Connection
DEBUG [main] - Created connection 29945809.
DEBUG [main] - Setting autocommit to false on JDBC Connection [com.mysql.jdbc.Connection@1c8efd1]
DEBUG [main] - ==> Preparing: select * from user where username like '%张三%'
DEBUG [main] - ==> Parameters:
DEBUG [main] - <== Total: 2
1:张三
4:张三丰
DEBUG [main] - Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.Connection@1c8efd1]
DEBUG [main] - Closing JDBC Connection [com.mysql.jdbc.Connection@1c8efd1]
DEBUG [main] - Returned connection 29945809 to pool.

小结:
a.parameterType
在映射文件中通过parameterType指定输入参数的类型

b.resultType
在映射文件中通过resultType指定输出结果的类型

c.#{}和${}
#{}表示一个占位符号
${}表示一个拼接符号，会引起sql注入，所以不建议使用

d.selectOne和selectList
selectOne表示查询一条记录进行映射，使用selectList也可以使用，只不过只有一个对象
selectList表示查询出一个列表(参数记录)进行映射，不嗯能够使用selectOne查，不然会报下面的错:
org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 2