MyBatis-框架简单介绍和入门程序

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

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
平台声明：文章内容（如有图片或视频亦包括在内）由作者上传并发布，文章内容仅代表作者本人观点，简书系信息发布平台，仅提供信息存储服务。

推荐阅读更多精彩内容