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

我们通过写一个简单的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

转载请注明出处：http://blog.csdn.net/acmman/article/details/46400145