从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或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

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

<?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>
<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.Driver
jdbc.url=jdbc:mysql://localhost:3306/cj?useUnicode=true&characterEncoding=UTF-8
jdbc.username=****
jdbc.password=****

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

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



（6）创建映射文件

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

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

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN
cdd0
"
"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;
}
@Override
public 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查询用户信息，得到一条记录
@Test
public void findUserByIdTest() throws IOException{
//mybatis配置文件
String resource="sqlMapConfig.xml";
//得到配置文件
InputStream inputStream = Resources.getResourceAsStream(resource);
//创建会话工厂
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
//通过工厂得到sqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();

//通过sqlSession操作数据库
//第一个参数:映射文件中statement的Id，等于namespace+"."+statement id
User user = sqlSession.selectOne("test.findUserById", 1);
System.out.println(user);
//释放会话资源
sqlSession.close();
}
@Test
public void findUserByNameTest() throws IOException{
//mybatis配置文件
String resource="sqlMapConfig.xml";
//得到配置文件
InputStream inputStream = Resources.getResourceAsStream(resource);
//创建会话工厂
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
//通过工厂得到sqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();

//通过sqlSession操作数据库
//用户名模糊查询
List<User> user1 = sqlSession.selectList("test.findUserByName", "or where 1=1 or");
System.out.println(user1);
//释放会话资源
sqlSession.close();
}
@Test
public void insertUserTest() throws IOException{
//mybatis配置文件
String resource="sqlMapConfig.xml";
//得到配置文件
InputStream inputStream = Resources.getResourceAsStream(resource);
//创建会话工厂
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
//通过工厂得到sqlSession
SqlSession 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();
}
@Test
public void deleteUserTest() throws IOException{
//mybatis配置文件
String resource="sqlMapConfig.xml";
//得到配置文件
InputStream inputStream = Resources.getResourceAsStream(resource);
//创建会话工厂
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
//通过工厂得到sqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();

//通过sqlSession操作数据库
//第一个参数:映射文件中statement的Id，等于namespace+"."+statement id
int num2 = sqlSession.delete("test.deleteUser", 3);
sqlSession.commit();
//释放会话资源
sqlSession.close();
}
//更新用户信息
@Test
public void updateUserTest() throws IOException{
//mybatis配置文件
String resource="sqlMapConfig.xml";
//得到配置文件
InputStream inputStream = Resources.getResourceAsStream(resource);
//创建会话工厂
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
//通过工厂得到sqlSession
SqlSession 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实体类与数据表要对应。