MyBatis（1）：MyBatis入门

一、MyBatis的定义

MyBatis的官方文档给的定义：MyBatis是一款支持普通SQL查询、存储过程和高级映射的持久层框架。MyBatis消除了几乎所有的JDBC代码、参数的设置和结果集的检索。MyBatis可以使用简单的XML或注解用于参数配置和原始映射，将接口和Java POJO（普通Java对象或者是实体）映射成数据库中的记录。

下面开始结合（Spring+Spring MVC+Mybatis）框架进行详细的代码介绍，包括创建表、建立实体类、写基础的配置文件、写简单的Java类，简单的查询(数据库为oracl)

二、建表

create table user_table
(
  userId          int     not null,
  userName        varchar(20) not null,
  userAge         int    not null,
  userPhone       varchar(20) not null,
  constraint userId primary key ( userId  )
);
 
insert into  user_table values(null, 'Jack', 20, '000000');
insert into user_table values(null, 'Mark', 21, '111111');
insert into user_table values(null, 'Lily', 22, '222222');
insert into user_table values(null, 'Lucy', 23, '333333');

三、有了表之后就该写表对应的实体类

package com.mybatis.VO;
public class UserVO
{
   private int userId;

    private String userName;

    private int userAge;

    private String userPhone;

    public UserVO()
    {
        super();
    }

    public int getUserId() {
        return userId;
    }

    public void setUserId(int userId) {
        this.userId = userId;
    }

    public String getUserName() {
        return userName;
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }

    public int getUserAge() {
        return userAge;
    }

    public void setUserAge(int userAge) {
        this.userAge = userAge;
    }

    public String getUserPhone() {
        return userPhone;
    }

    public void setUserPhone(String userPhone) {
        this.userPhone = userPhone;
    }
}

四、添加mybatis配置文件mybatis.cfg.xml

<?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>

  <!-- 引入外部配置文件 oracle的配置百度 不再阐述-->
  <properties resource="jdbc.properties"></properties>
  
  
   <!-- 为JAVA Bean起类别名 -->
   <typeAliases >
        <!-- 别名方式1，一个一个的配置 type中放置的是类的全路径，alias中放置的是类别名
        <typeAliase type="com.mybatis.VO.UserVO" alias="UserVO"/> -->
        <!-- 别名方式2，自动扫描，将JAVA类的类名作为类的类别名 -->
        <package name="com.mybatis.VO"/>
   </typeAliases>
   
   
   <!-- 配置mybatis运行环境 -->
     <environments default="cybatis">
        <environment id="cybatis">
            <!-- type="JDBC" 代表使用JDBC的提交和回滚来管理事务 -->
            <transactionManager type="JDBC" />
            
            <!-- mybatis提供了3种数据源类型，分别是：POOLED,UNPOOLED,JNDI -->
            <!-- POOLED 表示支持JDBC数据源连接池 -->
            <!-- UNPOOLED 表示不支持数据源连接池 -->
            <!-- JNDI 表示支持外部数据源连接池 -->
            <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>
        <!-- 告知映射文件方式1，一个一个的配置
        <mapper resource="com/mybatis/mapper/UserMapper.xml"/>-->
        <!-- 告知映射文件方式2，自动扫描包内的Mapper接口与配置文件 -->
        <package name="com/mybatis/mapper"/>
    </mappers>
</configuration>

五、 创建方法接口 UserMapper.java 和定义操作 user_table 表的 sql 映射文件 UserMapper.xml( 建议：文件名最好相同 )

1.接口Mapper

package com.mybatis.mapper;
import java.util.List;

import com.mybatis.VO.UserVO;

public interface UserMapper {
    /**
     * 新增用戶
     * @param user
     * @return
     * @throws Exception
     */
    public int insertUser(UserVO user) throws Exception;
    /**
     * 修改用戶
     * @param user
     * @param id
     * @return
     * @throws Exception
     */
    public int updateUser (UserVO user,int id) throws Exception;
     /**
      * 刪除用戶
      * @param id
      * @return
      * @throws Exception
      */
    public int deleteUser(int id) throws Exception;
    /**
     * 根据id查询用户信息
     * @param id
     * @return
     * @throws Exception
     */
    public UserVO selectUserById(int id) throws Exception;
     /**
      * 查询所有的用户信息
      * @return
      * @throws Exception
      */
    public List<UserVO> selectAllUser() throws Exception;
}

2. UserMapper.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org/DTD Mapper 3.0" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.mybatis.mapper.UserMapper">
<!-- 自定义返回结果集 -->
   <resultMap id="UserVO" type="com.mybatis.VO.UserVO">
        <id property="userId" column="userId" javaType="java.lang.Integer"></id>
        <result property="userName" column="userName" javaType="java.lang.String"></result>
        <result property="userAge" column="userAge" javaType="java.lang.String"></result>
        <result property="userPhone" column="userPhone" javaType="java.lang.String"></result>
    </resultMap>
<!-- 在各种标签中的id属性必须和接口中的方法名相同 ， id属性值必须是唯一的，不能够重复使用。parameterType属性指明查询时使用的参数类型，resultType属性指明查询返回的结果集类型-->    
<!-- useGeneratedKeys：（ 仅 对 insert 有 用 ） 这 会 告 诉 MyBatis 使 用 JDBC 的getGeneratedKeys 
            方法来取出由数据（比如：像 MySQL 和 SQLServer 这样的数据库管理系统的自动递增字段）内部生成的主键。默认值： false。 -->    
<!--keyProperty： （仅对 insert有用）标记一个属性， MyBatis 会通过 getGeneratedKeys或者通过 insert 语句的 selectKey 子元素设置它的值。默认：不设置。 -->
<!--#{}中的内容，为占位符，当参数为某个JavaBean时，表示放置该Bean对象的属性值  -->


    <insert id="insertUser" useGeneratedKeys="true" keyProperty="userId">
        insert into user_table (userId,userName,userAge,userPhone) values ((#{userId},#{userName},#{userAge},#{userPhone})
    </insert>
    
    <update id="updateUser" >
      update user_table set userName=#{userName},userAge=#{userAge},userPhone=#{userPhone} where userId=#{id}
    </update>
    
    <delete id="deleteUser" parameterType="int">
     delete from user_table where id=#{id}  
    </delete>
    
    <select id="selectUserById" parameterType="int" resultMap="UserVO">
     select * from user_table where userId=#{id}
    </select>
    
    <select id="selectAllUser" resultMap="UserVO">
     select * from user_table
    </select>
</mapper>

六、连接数据库的工具类

package com.mybatis.tools;


import java.io.Reader;


import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;


public class DBTools {
    public static SqlSessionFactory sessionFactory;
    
    static{
        try {
            //使用MyBatis提供的Resources类加载mybatis的配置文件
            Reader reader = Resources.getResourceAsReader("mybatis.cfg.xml");
            //构建sqlSession的工厂
            sessionFactory = new SqlSessionFactoryBuilder().build(reader);
        } catch (Exception e) {
            e.printStackTrace();
        }
        
    }
    //创建能执行映射文件中sql的sqlSession
    public static SqlSession getSession(){
        return sessionFactory.openSession();
    }
    
}

七、测试类

package com.mybatis.service;


import java.util.List;
import org.apache.ibatis.session.SqlSession;
import com.mybatis.beans.UserVO;
import com.mybatis.tools.DBTools;
import com.mybatis.mapper.UserMapper;

public class UserService {
      
    public static void main(String[] args) {
          insertUser();
//        deleteUser();
//        selectUserById();
//        selectAllUser();
    }


    
    /**
     * 新增用户
     */
    private static void insertUser() {
        SqlSession session = DBTools.getSession();
        UserMapper mapper = session.getMapper(UserMapper.class);
        UserVO user = new UserVO("懿", "1314520", "123456");
        try {
            mapper.insertUser(user);
            System.out.println(user.toString());
             session.commit();
        } catch (Exception e) {
            e.printStackTrace();
            session.rollback();
        }
    }
    
    
    /**
     * 删除用户
     */
    private static void deleteUser(){
        SqlSession session=DBTools.getSession();
        UserMapper mapper=session.getMapper(UserMapper.class);
        try {
            mapper.deleteUser(1);
            session.commit();
        } catch (Exception e) {
            e.printStackTrace();
            session.rollback();
        }
    }
    
    
    /**
     * 根据id查询用户
     */
    private static void selectUserById(){
        SqlSession session=DBTools.getSession();
        UserMapper mapper=session.getMapper(UserMapper.class);
        try {
        UserVO user=    mapper.selectUserById(2);
        System.out.println(user.toString());
            
            session.commit();
        } catch (Exception e) {
            e.printStackTrace();
            session.rollback();
        }
    }
    
    /**
     * 查询所有的用户
     */
    private static void selectAllUser(){
        SqlSession session=DBTools.getSession();
        UserMapper mapper=session.getMapper(UserMapper.class);
        try {
        List<UserVO> user=mapper.selectAllUser();
        System.out.println(user.toString());
        session.commit();
        } catch (Exception e) {
            e.printStackTrace();
            session.rollback();
        }
    }
}

以上就是MyBatis的基本知识。如有不同意见，请指正！大家一起进步！

耐心之树，结黄金之果。