mybatis 是什么？

mybatis是一個持久層的框架，是Apache下的頂級項目。
mybatis可在GitHub上下載，https://github.com/mybatis/mybatis-3

mybatis讓程序員將主要精力放在sql上，通過mybatis提供的映射方式，靈活自由地生成（半自動化，大部分需要編寫sql）滿足需要的sql語句。

mybatis可以將向 preparedStatement 中的輸入參數自動進行輸入映射，將查詢結果集靈活映射出Java對象（輸出映射）。

簡單框架

入門程序

需求：

根據用戶id(主鍵)查詢用戶信息
根據用戶名稱模糊查詢用戶信息
添加用戶
刪除用戶
更新用戶

環境：

java/eclipse/mysql/

mybatis: 依賴包、核心包、mysql驅動包

工程結構

14949048328278.png

log4j.properties

# 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

配置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>
    <!-- 和spring整合后 environments 配置將廢除 -->
    <environments default="development">
        <environment id="development">
            <!-- 使用jdbc事務管理，事務控制由mybatis管理 -->
            <transactionManager type="JDBC" />
            <!-- 數據庫連接池，由mybatis管理 -->
            <dataSource type="POOLED">
                <property name="driver" value="${driver}" />
                <property name="url" value="${url}" />
                <property name="username" value="${username}" />
                <property name="password" value="${password}" />
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="sqlmap/User.xml" />
    </mappers>
</configuration>

根據用戶id（主鍵）查詢用戶信息

• 1.創建po類

  public class User {
  
     //屬性名和數據庫表的字段對應
     private int id;
     private String username;//用戶姓名
     private String sex;
     private Date birthday;
     private String address;
     //get set
  }
  

• 2.創建映射文件

映射文件命名：
比如：User.xml(原始 ibatis 命名方式), mapper代理開發映射文件名稱叫 xxxMapper.xml,比如：UserMapper.xml、ItemsMapper.xml

在映射文件中配置sql語句。

<?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="com.egintra.mybatis.user">
    <!-- 在映射文件中配置很多sql語句 -->
    <!-- 需求：通過id查詢用戶表的記錄 -->
    <!-- 通過select執行數據庫查詢操作
        id:標識映射文件中的sql,成為statement的id,用作將sql語句封裝到mappedStatement對象中
        parameterType:指定輸入參數的類型，這里指定了int型
        #{}表示一個占位符號
        #{id}:其中的id表示接收輸入的參數，參數名稱就是id,如果輸入參數是簡單類型，#{}中的參數名可以任意，可以是value或其他名稱
        resultType：指定sql輸出結果所映射的Java對象類型，select指定resultType表示將單條記錄映射成的Java對象
     -->
    <select id="findUserById" parameterType="int" resultType="com.egintra.mybatis.po.User">
        SELECT * FROM `user` where id=#{id};
    <\select>
</mapper>

• 3.在SqlMapConfig.xml中加載映射文件

在sqlMapConfig.xml中加載 User.xml

<!-- 加載映射文件 -->
    <mappers>
        <mapper resource="sqlmap/User.xml" />
    </mappers>
    

• 4.程序編寫

//根據id查詢用戶的信息，得到一條記錄結果
    @Test
    public void findUserWithId() {
        SqlSession sqlSession = null;
        try {
            //mybatis配置文件
            String resource = "SqlMapConfig.xml";
            
            //得到配置文件流
            InputStream 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("com.egintra.mybatis.user.findUserById", 1);
            
            System.out.println(user);
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            //釋放會話資源
            sqlSession.close();
        }
        
    }
       

根據用戶名稱模糊查詢用戶信息

• 映射文件

使用User.xml,添加根據用戶名稱模糊查詢用戶信息的sql語句：

<!-- 根據用戶名模糊查詢用戶，可能返回多條
        String也是簡單類型
        resultType：指定的就是單條記錄所映射的Java對象類型，不管查詢結果有單條還是多條
        ${}:表示拼接sql串，將接收到參數的內容不加任何修飾拼接在sql中。
        使用${}拼接sql，會引起sql注入
        ${value}:接收輸入參數的內容，如果傳入類型是簡單類型，${}中只能使用value
     -->
     <select id="findUsersByName" parameterType="java.lang.String" resultType="com.egintra.mybatis.po.User">
        SELECT * FROM `user` WHERE username LIKE '%${value}%'
     </select>

• 程序編寫

//根據用戶名稱模糊查詢用戶列表
    @Test
    public void findUsersByNameTest() {
        SqlSession sqlSession = null;
        try {
            
            InputStream inputStream = Resources.getResourceAsStream("SqlMapConfig.xml");
            
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            
            sqlSession = sqlSessionFactory.openSession();
            
            List<User> selectUsers = sqlSession.selectList("user.findUsersByName", "小明");
            System.out.println(selectUsers);
            
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            //釋放會話資源
            sqlSession.close();
        }
    }
    

添加用戶

• 映射文件

在User.xml 中配置添加用戶的statement

<!-- 添加用戶
        parameterType:指定輸入參數類型是pojo
        #{}中指定pojo的屬性名，從而接收到pojo對象的屬性值，mybatis通過OGNL獲取對象的屬性值
     id在數據庫中是主鍵，可以不寫。
      -->
     <insert id="insertUser" parameterType="com.egintra.mybatis.po.User">
        INSERT INTO `user`(id,username,birthday,sex,address) VALUE(#{id},#{username},#{birthday},#{sex},#{address})
     </insert>
     

• 程序代碼

//新增用戶
    @Test
    public void addUserTest() {
        SqlSession sqlSession = null;
        try {
            InputStream resourceAsStream = Resources.getResourceAsStream("SqlMapConfig.xml");
            SqlSessionFactory buildFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
            sqlSession = buildFactory.openSession();
            
            //要插入的用戶對象
            User user = new User();
            user.setUsername("王小紅");
            user.setBirthday(new Date());
            user.setSex("女");
            user.setAddress("山東青島");
            
            sqlSession.insert("user.insertUser", user);
            
            //提交事務
            sqlSession.commit();
        }catch(IOException e) {
            e.printStackTrace();
        }finally {
            sqlSession.close();
        }
    }
    

• 自增主鍵的返回

mysql自增主鍵，執行 insert 提交之前自動生成一個自增主鍵。

通過mysql函數獲取到剛插入記錄的自增主鍵：LAST_INSERT_ID() ,是在insert之后調用。

需要修改insertUser的定義：

自增主鍵

• 非自增主鍵的返回（使用uuid()）

使用mysql的uuid()函數生成主鍵，需要修改表中id字段類型為String，長度設置成35位。

執行思路：
先通過 uuid() 查詢到主鍵，然后將主鍵輸入到sql語句中。
-> 執行uuid()語句順序相對于insert語句為之前。

非自增主鍵

刪除用戶

• 映射文件

<!-- 刪除用戶  根據id-->
    <delete id="deleteUserById" parameterType="java.lang.Integer">
        DELETE FROM `user` WHERE id=#{id}
</delete>

• 程序代碼

  
  
  14949889174515.png

更新用戶

• 映射文件

<!-- 根據id更新用戶
        分析:
        需要傳入用戶的id
        需要傳入用戶的更新信息
        parameterType指定user對象,包括id和更新信息,注意:id必須存在
        #{id}:從輸入的user對象中獲取id屬性值
-->
<update id="updateUser" parameterType="com.egintra.mybatis.po.User">
        UPDATE `user` SET username=#{username},birthday=#{birthday},sex=#{sex},address=#{address} WHERE id=#{id}
</update>
      

• 程序代碼

  
  
  14949889438268.png

總結

• parameterType

在映射文件中通過 parameterType指定 輸入參數的類型

• resultType

在映射文件中通 resultType 指定輸出結果的類型

• #{} 和 ${}

#{}表示一個占位符號，可以接受輸入的參數，類型可以是簡單類型，POJO，hashmap。如果接收簡單類型，#{}中可任意寫，一般寫成value等。
#{}接受pojo對象值，是通過OGNL讀取對象中的屬性值。通過屬性.屬性.屬性...的方式獲取對象屬性值。

${}表示一個拼接符號，會引用sql注入，所以不建議使用${}
可以接受輸入的參數，類型可以是簡單類型，POJO，hashmap。
如果接收簡單類型，${}中只能寫成value。

• selectOne 和 selectList

selectOne查詢出一條記錄進行映射。如果使用selectOne可以實現使用selectList也可以實現（list中只有一個對象）

selectList查詢出一個列表（多條記錄）進行映射。如果使用selectList查詢多條記錄，不能使用selectOne。

報錯：org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 2