从mybatis基本原理到第一条sql的实现

一：JDBC存在哪些问题，所以我们使用mybatis

         我之前有篇博客提到JDBC连接数据库，这次我在这总结一下JDBC存在的问题，这也是我们选择其他方式的原因

       （1）jdbc的数据库连接在使用的时候创建，不使用的时候释放，就会存在频繁的对数据库链接开启关闭操作，造成数据库资源浪费，影响数据库性能。

       （2）sql语句，参数设置，结果遍历均存在硬编码，在有改动的情况下，需重新编译java代码，不利于系统的维护。

        针对上述问题，我们想到的可能实现的解决方案：一使用数据库连接池管理数据库连接。二使用配置xml文件对语句及参数进行管理，查询结果映射到java对象中

二：mybatis的基本原理

               个人觉得原理先过一遍，不用深究，等把示例看过再回来研究会比较容易理解一些。    

     （1）mybatis是个持久层的框架,程序员的主要精力放在sql上，通过映射的方式自由灵活的生产满足需求的sql。

     （2）mybatis可以对preparedstatement的输入参数进行自动映射，也可以将查询结果映射为java对象。

     （3）mybatis的下载地址：https://gist.github.com/mybatis/mybatis-3/releases

     框架结构图：

       简单解释一下，mybatis框架也是基于jdbc进行改善的，所以其本质也是需要通过连接数据库创建会话执行语句。不同的是，mybatis通过sqlMapConfig.xml配置文件来创建会话工厂SqlSessionFactory,然后通过会话工厂创建会话SqlSession，sqlSession就可以操作数据库了，需要注意的是虽然我们看到的是sqlSession操作数据库了，实际上是其内部的执行器Executor来操作的。

    既然有数据库的操作，就免不了输入输出，mybatis便通过一个底层的封装对象来控制。他可以封装sql语句，输入参数，输出结果类型。

三：mybatis的实战

          功能实现：根据主键查询记录

          环境要求：

                     Java的环境：jdk1.7、开发环境：eclipse：indigo、mybatis的环境：mybatis-3.2.7（下载地址见上文）

          开始搭建项目：

(1)创建一个java工程“mybatisTest”

                                   

 (2)导jar包：刚刚下载的mybatis中lib下的所有包+mybatis的驱动包+servlet依赖包+mysql的驱动包

                                           

                          包导入后右击buildpath然后add到运行环境中

（3）创建log4j.properties

                                   上述包中可以看见日志包，我们创建一个log4j.properties,内容可以在mybatis里中的pdf中拷贝。

# Global logging configuration# 在开发环境下中日志级别debug，正式环境用info或errorlog4j.rootLogger=DEBUG, stdout# MyBatis logging configuration...log4j.logger.org.mybatis.example.BlogMapper=TRACE# Console output...log4j.appender.stdout=org.apache.log4j.ConsoleAppenderlog4j.appender.stdout.layout=org.apache.log4j.PatternLayoutlog4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

（4）创建sqlMapConfig.xml（mybatis最核心的配置文件）

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE configurationPUBLIC "-//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管理事务 --><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="sqlMap/User.xml"/><!--<mapper resource="mapper/UserMapper.xml"/>--></mappers></configuration>

上述的配置文件中关于数据的连接我是放在db.properties中的，这里直接取得是取地址变量

jdbc.driver=com.mysql.jdbc.Driverjdbc.url=jdbc:mysql://localhost:3306/cj?useUnicode=true&characterEncoding=UTF-8jdbc.username=****jdbc.password=****

这里账号密码我隐去了，你们直接用自己的就好

（5）创建我们的示例文件夹com.test.mybatis.first，基本的结构图如下图。

（6）创建映射文件

       创建映射文件之前，我们需要在数据库建一个表，下面示例是用户表user有字段id,name等等，这个太简单自己建一下。

在目录sqlMap里面创建一个user.xml的映射文件。

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="test"><!-- 在映射文件中配置很多的SQL语句            通过ID查询数据     id：表示映射文件中的sql，将sql语句封装到mapping            resultType指定sql输出结果的所映射的java对象     #{}:表示占位符     ${}:表示拼接字符串 --><select id="findUserById" parameterType="int" resultType="com.test.mybatis.po.User">select * from user where id=#{id}</select><select id="findUserByName" parameterType="java.lang.String" resultType="com.test.mybatis.po.User">select * from user where username like '%${value}%' </select><!-- 插入用户信息 --><insert id="insertUser" parameterType="com.test.mybatis.po.User"><selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">select LAST_INSERT_ID()</selectKey>insert into user(id,username,password,userId,sex,age,creattime) values(#{id},#{username},#{password},#{userId},#{sex},#{age},#{creattime})</insert><!-- 删除用户信息 --><delete id="deleteUser" parameterType="java.lang.Integer" >delete from user where id=#{id}</delete>
        <!-- 更新用户信息 -->
  <update id="updateUser" parameterType="com.test.mybatis.po.User">update user set username=#{username},password=#{password},userId=#{userId},sex=#{sex},age=#{age},creattime=#{creattime} where id=#{id}</update></mapper>
需要注意的mapper的约束条件是：
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"
标签<mapper></mapper>里面的内容是根据自己的需要添加的，这里我们主要看里面的第一个select标签。
<1>mapper标签有个namespace属性，这是用来对sql分类管理的标识。
<2>select标签属性id，前面提到对数据进行存储封装的底层封装对象，这个id就可以看为这个mapperStatement的i
<3>select标签属性parameterType,在我们写的sql语句中有个占位符#{id}，用来表示我们将要输入的ID，parameterType便是指定我们输入的参数的类型。
<3>select标签属性resultType,指定sql输出结果所映射的java对象。
（7）创建表映射的java对象。
不管什么项目，我们在进行表数据查询的时候，结果都是存放在一个java对象中，所以我们可以专门建个文件夹放我们的映射对象
如表user的映射对象user.java
package com.test.mybatis.po;public class User {//属性名要和数据库表字段对应private int id;private String username;private String password;private int userId;private String sex;private int age;    private String creattime;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 getPassword() {return password;}public void setPassword(String password) {this.password = password;}public int getUserId() {return userId;}public void setUserId(int userId) {this.userId = userId;}public String getSex() {return sex;}public void setSex(String sex) {this.sex = sex;}public int getAge() {return age;}public void setAge(int age) {this.age = age;}public String getCreattime() {return creattime;}public void setCreattime(String creattime) {this.creattime = creattime;}@Overridepublic String toString() {return "User [id=" + id + ", username=" + username + ", password="+ password + ", userId=" + userId + ", sex=" + sex + ", age="+ age + ", creattime=" + creattime + "]";}}
(8)在sqlMapConfig中加载我们的映射文件mapper.xml
上面我们的sqlMapConfig.xml已经加载过了，加载语句是：
<mappers>
    <mapper resource="sqlMap/User.xml"/>
</mappers>
sqlMapConfig.xml可以加载多个mapper.xml文件

(9)基本设置与框架搭建好了，可以写我们的测试方法了
MybatisFirst.java编写测试方法的时候要把junit的包导入进去。
package com.test.mybatis.first;import java.io.IOException;import java.io.InputStream;import java.util.List;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 com.test.mybatis.po.User;public class MybatisFirst {//根据id查询用户信息，得到一条记录@Testpublic void findUserByIdTest() throws IOException{//mybatis配置文件String resource="sqlMapConfig.xml";//得到配置文件InputStream inputStream = Resources.getResourceAsStream(resource);//创建会话工厂SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);//通过工厂得到sqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();//通过sqlSession操作数据库//第一个参数:映射文件中statement的Id，等于namespace+"."+statement id User user = sqlSession.selectOne("test.findUserById", 1);System.out.println(user);//释放会话资源sqlSession.close();}@Testpublic void findUserByNameTest() throws IOException{//mybatis配置文件String resource="sqlMapConfig.xml";//得到配置文件InputStream inputStream = Resources.getResourceAsStream(resource);//创建会话工厂SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);//通过工厂得到sqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();//通过sqlSession操作数据库//用户名模糊查询List<User> user1 = sqlSession.selectList("test.findUserByName", "or where 1=1 or");System.out.println(user1);//释放会话资源sqlSession.close();}@Testpublic void insertUserTest() throws IOException{//mybatis配置文件String resource="sqlMapConfig.xml";//得到配置文件InputStream inputStream = Resources.getResourceAsStream(resource);//创建会话工厂SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);//通过工厂得到sqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();//通过sqlSession操作数据库//插入数据User iuser = new User();iuser.setUsername("chenjun");iuser.setPassword("123456");int num = sqlSession.insert("test.insertUser",iuser);sqlSession.commit();System.out.println(num);//释放会话资源sqlSession.close();}@Testpublic void deleteUserTest() throws IOException{//mybatis配置文件String resource="sqlMapConfig.xml";//得到配置文件InputStream inputStream = Resources.getResourceAsStream(resource);//创建会话工厂SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);//通过工厂得到sqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();//通过sqlSession操作数据库//第一个参数:映射文件中statement的Id，等于namespace+"."+statement id int num2 = sqlSession.delete("test.deleteUser", 3);sqlSession.commit();//释放会话资源sqlSession.close();}//更新用户信息@Testpublic void updateUserTest() throws IOException{//mybatis配置文件String resource="sqlMapConfig.xml";//得到配置文件InputStream inputStream = Resources.getResourceAsStream(resource);//创建会话工厂SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);//通过工厂得到sqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();//通过sqlSession操作数据库//插入数据User user = new User();user.setId(4);user.setUsername("jun");user.setPassword("456");int num = sqlSession.update("test.updateUser",user);sqlSession.commit();System.out.println(num);//释放会话资源sqlSession.close();}}
完成后我们就可以右击我们的方法进行测试了。


(10)测试常见异常原因
<1>数据库服务没起。
<2>sqlMapConfig中的mapper.xml的名字有错。
<3>sqlMapConfig加载的时候是全部加载，一定要保证每一个mapper.xml都是存在且正确的。
<4>mapper.xml中sql语句的属性类型要正确，java实体类与数据表要对应。