Mybatis框架
入门程序
通过一个入门程序来更好的理解Mybatis框架
1. 环境
java环境:jdk1.7
mysql: 5.1
mybatis的运行环境(jar包):3.2.7 (在lib下有log4j的包,那还需要创建一个log4j的文件)
mysql的驱动包
2.log4j.properties
log4j.rootLogger=DEBUG, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layut.ConversionPattern=%5p [%t] - %m%n
3.入门程序工程结构
根据Mybatis的框架来看,第一步需要sqlmapconfig.xml文件,然后还需要配置mapper.xml文件,我将mapper.xml映射文件放在了config\slqmap中。别忘了加上log4j。properties文件。在src下还需要建立一个first包,用来放入门程序。下面就是大概的架构
4.SqlMapConfig.xml
在这个文件中需要配置mybatis的运行环境。
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<properties resource="db.properties"></properties>
<!-- 和spring整合后environments配置将会废除 -->
<environments default="development">
<environment id="development">
<!-- 使用jdbc事务管理,事务有mybatis 管理 -->
<transactionManager type="JDBC" />
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}" />
<property name="url" value="${jdbc.url}" />
<property name="username" value="${jdbc.name}" />
<property name="password" value="${jdbc.password}" />
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="sqlmap/User.xml"/>
<mapper resource="mapper/UserMapper.xml"/>
</mappers>
</configuration>
下面一步就是加载我们写好的映射文件。
<mappers>
<mapper resource="sqlmap/User.xml"/>
</mappers>
5.User.xml
在写入门程序之前需要创建映射文件(User.xml)
注意:mybatis的mapper代理开发的映射文件不是这样命名的,应该是xxxMapper.xml。User.xml这种命名方式是原始的ibatis的命名方式。
在sqlmapconfig.xml里面有个约束叫做config的dtd,在User.xml文件中它的约束叫做mapper的dtd。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
>
<!-- namespace命名空间,作用就是对sql进行分类化管理,理解sql隔离 -->
<mapper namespace="test">
<!-- 在映射文件中配置很多sql语句 -->
<!-- 通过select进行查询,id用来标识映射文件中的sql,
称为statementid,将sql语句封装到statement对象当中
#{}表示一个占位符
parameterType:指定输入参数的类型
#{id}:表示接入输入的参数,参数名称为id,如果输入参数是简单类型,#{}中的参数名可以任意,可以使value或者其他名称
resultType:输出sql结果所映射的的java对象类型,select指定resultType表示将 单条 记录所映射的java对象
-->
<select id="findUserById" parameterType="int" resultType="com.mybatis.po.User">
SELECT * FROM USER WHERE id=#{id}
</select>
<!-- 根据用户名称进行模糊查询
根据用户名模糊查询可能返回多条记录
resultType:指定的就是单条记录所映射的java对象类型
${}:表示拼接字符串。使用该方法拼接sql,会引起sql注入 -->
<select id="findUserByName" parameterType="java.lang.String" resultType="com.mybatis.po.User">
SELECT * FROM USER WHERE username LIKE '%${value}%'
</select>
<!-- 添加用户 -->
<insert id="insertUser" parameterType="com.mybatis.po.User">
<selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
SELECT LAST_INSERT_ID()
</selectKey>
INSERT INTO USER(username,birthday,sex,address) values(#{username},#{birthday},#{sex},#{address})
</insert>
<!-- 删除用户 -->
<delete id="deleteUser" parameterType="java.lang.Integer">
delete from user where id=#{id}
</delete>
<!-- 更新用户 -->
<update id="updateUser" parameterType="com.mybatis.po.User">
update user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address} where id=#{id}
</update>
</mapper>
到这里我们已经完成了框架的第一步,配置sqlmapconfig.xml文件和mapper.xml文件,接下来应该编写入门程序。
6.编写入门程序
以根据id查询用户信息为例子。首先我们要创建会话工厂,然后通过工厂得到SQLSession,最后通过SQLSession操作数据库。
6.1 创建会话工厂
会话工厂通过builder得到,需要传入一个流,这个流是要传入mybatis配置文件的信息。
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
这个配置文件的信息通过Resource类得到,选用getResourceAsStream是因为该方法返回的是一个流。这个方法又需要传入一个resource参数。
InputStream inputStream = Resources.getResourceAsStream(resource);
将sqlmap的配置文件定义一下,传入getResourceAsStream方法中
String resource = "SqlMapConfig.xml";
到此创建会话工厂也完成了。
//mybatis配置文件
String resource = "SqlMapConfig.xml";
//得到一个配置文件流
InputStream inputStream = Resources.getResourceAsStream(resource);
//创建会话工厂,传入mybatis配置文件信息
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
6.2 得到SQLSession
//创建回话
SqlSession sqlSession = sqlSessionFactory.openSession();
6.3 通过SQLSession操作数据库
在查询方法中使用了selectOne,顾名思义查询单条记录,该方法中有两个参数,第一个参数为statement,也就是映射文件当中的statement的id,这个id等于命名空间.statement的id。第二个参数是parameter,是输入参数,在映射文件中有个parameterType是输入参数的类型,需要输入和该类型匹配的具体的值。然后sqlSession.selectOne的结果就是和映射文件中和resultType类型所匹配的对象。
User user = sqlSession.selectOne("test.findUserById", 1);
6.4 输出和释放
最后可以通过输出user查看结果,最重要的是别忘了释放会话资源。sqlSession.close();