Mybatis基础-入门教程

平时我们都用JDBC访问数据库，除了需要自己写SQL之外，还必须操作Connection, Statment, ResultSet 这些其实只是手段的辅助类。 不仅如此，访问不同的表，还会写很多雷同的代码，显得繁琐和枯燥。 

那么用了Mybatis之后，只需要自己提供SQL语句，其他的工作，诸如建立连接，Statement， JDBC相关异常处理等等都交给Mybatis去做了，那些重复性的工作Mybatis也给做掉了，我们只需要关注在增删改查等操作层面上，而把技术细节都封装在了我们看不见的地方。 

必读： 基于框架的程序要成功运行，对于JAR包的版本，配置文件的正确性有着苛刻的要求，任何一个地方出错了，都会导致框架程序运行失败。

• 创建项目
  
  通过ecipse创建java project: mybatis
  项目目录必须是 e:\project\mybatis
  因为后续的学习都是基于这个位置，所以请务必使用这个项目目录，有助于在使用本教程的过程中提高相当的学习效率。
  用其他项目位置反而会带来不必要的困扰
  
• 导入jar包
  
  本项目用到了两个jar包，lib.rar下载。
  下载解压后，在项目目录e:/project/mybatis下新建目录lib,并复制过来
  然后通过ecipse在mybatis的项目上导入这两个jar包
  
• 创建实体类
  
  准备实体类Category，用于映射表category_
  

  package com.how2java.pojo;
   
  public class Category {
      private int id;
      private String name;
      public int getId() {
          return id;
      }
      public void setId(int id) {
          this.id = id;
      }
      public String getName() {
          return name;
      }
      public void setName(String name) {
          this.name = name;
      }
       
  }

• 配置文件mybatis-config.xml
  
  在src目录下创建mybatis的主配置文件mybatis-config.xml (相当于hibernate.cfg.xml，如果没有hibernate基础请忽略本句)。
  其作用主要是提供连接数据库用的驱动，数据库名称，编码方式，账号密码
  

  <property name="driver" value="com.mysql.jdbc.Driver"/>
  <property name="url" value="jdbc:mysql://localhost:3306/how2java?characterEncoding=UTF-8"/>
  <property name="username" value="root"/>
  <property name="password" value="admin"/>

  以及别名，自动扫描com.how2java.pojo下的类型，使得在后续配置文件Category.xml中使用resultType的时候，可以直接使用Category,而不比写全com.how2java.pojo.Category
  

  <typeAliases>
      <package name="com.how2java.pojo"/>
  </typeAliases>

  映射Category.xml
  

  <mappers>
      <mapper resource="com/how2java/pojo/Category.xml"/>
  </mappers>

  <?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>
      <typeAliases>
        <package name="com.how2java.pojo"/>
      </typeAliases>
      <environments default="development">
          <environment id="development">
              <transactionManager type="JDBC"/>
              <dataSource type="POOLED">
                  <property name="driver" value="com.mysql.jdbc.Driver"/>
                  <property name="url" value="jdbc:mysql://localhost:3306/how2java?characterEncoding=UTF-8"/>
                  <property name="username" value="root"/>
                  <property name="password" value="admin"/>
              </dataSource>
          </environment>
      </environments>
      <mappers>
          <mapper resource="com/how2java/pojo/Category.xml"/>
      </mappers>
  </configuration>

• 配置文件Category.xml
  
  在包com.how2java.pojo下，新建文件Category.xml
  

  namespace="com.how2java.pojo"

  表示命名空间是com.how2java.pojo，在后续调用sql语句的时候，会用到它
  里面定义了一条sql语句
  

  select * from   category_ 

  这条sql语句用id: listCategory 进行标示以供后续代码调用。resultType="Category" 表示返回的数据和Category关联起来，这里本应该使用的是 com.how2java.pojo.Category, 但是因为上一步配置了别名，所以直接使用Category就行了
  

  <?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">
   
      <mapper namespace="com.how2java.pojo">
          <select id="listCategory" resultType="Category">
              select * from   category_     
          </select>
      </mapper>

• 测试类TestMybatis
  
  运行并观察到如图所示的结果。
  根据配置文件mybatis-config.xml得到sqlSessionFactory 。
  

  String resource = "mybatis-config.xml";
  InputStream inputStream = Resources.getResourceAsStream(resource);
  SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

  
  然后再根据sqlSessionFactory 得到session
  

  SqlSession session=sqlSessionFactory.openSession();

  
  最后通过session的selectList方法，调用sql语句listCategory。listCategory这个就是在配置文件Category.xml中那条sql语句设置的id。
  执行完毕之后，得到一个Category集合，遍历即可看到数据。
  

  List<Category> cs = session.selectList("listCategory");
  for (Category c : cs) {
  	System.out.println(c.getName());
  }

  注： session.selectList("listCategory"); 也可以写成 session.selectList("com.how2java.pojo.listCategory"); 效果一样。 但是我嫌弃其臃肿，不愿采用这种方式
  
  

  package com.how2java;
   
  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 com.how2java.pojo.Category;
   
  public class TestMybatis {
   
      public static void main(String[] args) throws IOException {
          String resource = "mybatis-config.xml";
          InputStream inputStream = Resources.getResourceAsStream(resource);
          SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
          SqlSession session=sqlSessionFactory.openSession();
           
          List<Category> cs=session.selectList("listCategory");
          for (Category c : cs) {
              System.out.println(c.getName());
          }
           
      }
  }

• 基本原理图
  
  1. 应用程序找Mybatis要数据
  2. mbatis从数据库中找来数据
  2.1 通过mybatis-config.xml 定位哪个数据库
  2.2 通过Category.xml执行对应的select语句
  2.3 基于Catgory.xml把返回的数据库记录封装在Category对象中
  2.4 把多个Category对象装在一个Category集合中
  3. 返回一个Category集合