专栏首页CSDN技术头条【干货】从配置到实例:MyBatis 基础入门

【干货】从配置到实例:MyBatis 基础入门

前置说明

本质而言,ORM(Object-Relation Mapping),是一种编程技术,能够实现面向对象编程语言与关系型数据库之间的数据转换(映射)。

MyBatis 即为互联网行业流行的 ORM 框架。在正式开始 MyBatis 之前,我们列出本文涉及的工具和组件,并约定版本:

使用 Gradle,全部的包依赖:

dependencies {
    compile group: 'com.alibaba', name: 'fastjson', version: '1.2.47'
    compile group: 'org.projectlombok', name: 'lombok', version: '1.16.18'
    compile group: 'org.mybatis', name: 'mybatis', version: '3.4.6'
    compile group: 'org.mybatis', name: 'mybatis-spring', version: '1.3.2'
    compile group: 'org.springframework', name: 'spring-context', version: '5.0.5.RELEASE'
    compile group: 'org.springframework', name: 'spring-jdbc', version: '5.0.5.RELEASE'
    compile group: 'mysql', name: 'mysql-connector-java', version: '8.0.11'
    testCompile group: 'junit', name: 'junit', version: '4.12'}

其中:fastjson、lombok作为本文中的辅助工具。

本文中使用 MySQL 作为关系型数据库,基于数据表 keyword 构建案例,keyword 数据表的创建语句:

CREATE TABLE `keyword` (  `id` bigint(20) NOT NULL AUTO_INCREMENT,  `word` varchar(255) NOT NULL COMMENT '关键词',  `score` int(11) NOT NULL COMMENT '关键词分数',  `bid` bigint(20) NOT NULL COMMENT '关键词出价(分)',  `update_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '最后更新时间',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8

keyword 数据表映射为 Java 对象 com.gitchat.mybatis.Keyword

package com.gitchat.mybatis;import lombok.Getter;import lombok.Setter;@Getter@Setterpublic class Keyword {    private Long id;    private String word;    private Integer score;    private Long bid;
}

MyBatis 基础结构说明

1

MyBatis 核心组件

MyBatis 核心组件包括:

  • org.apache.ibatis.session.SqlSessionFactoryBuilderSqlSessionFactory 构建器,完成SqlSessionFactory 构建即应当销毁
  • org.apache.ibatis.session.SqlSessionFactory:创建 SqlSession 的 “工厂”,应用程序中,每一个数据库应当只维护 SqlSessionFactory 的单例
  • org.apache.ibatis.session.SqlSession:作为访问数据库的 “会话”,通常理解为应用程序和数据库的连接,此外,通过 SqlSession 能够获取映射器
  • 映射器:由 Java 接口和 XML 文件(或注解)构成,其负责定义参数、SQL、查询结果与对象的映射

1

入门案例

查询数据表 keyword 中,关键词出价等于 10 元(1000 分)的关键词 Id 集合。涉及的代码包括:

resources/mybatis-config.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>
    <properties>
        <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
        <property name="url" value="URL"/>
        <property name="username" value="USERNAME"/>
        <property name="password" value="PASSWORD"/>
    </properties>
    <settings>
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>
    <environments default="prod">
        <environment id="prod">
            <transactionManager type="JDBC"/>
            <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="com/gitchat/mybatis/KeywordMapper.xml"/>
    </mappers></configuration>

代码所示,通过 resources/mybatis-config.xml 文件进行 MyBatis 配置:

  • 定义了 MyBatis 日志形式:输出到控制台
  • 定义了事务管理类型、数据库连接信息(url、username、password)
  • 定义了映射器:KeywordMapper.xml

更多关于 MyBatis 配置,请参阅 《MyBatis 的配置、映射器以及动态 SQL》 章节。

resources/com/gitchat/mybatis/KeywordMapper.xml

<?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.gitchat.mybatis.KeywordMapper">
    <select id="selectKeywordIdsUsingBid" resultType="java.lang.Long">
        SELECT id FROM keyword WHERE bid = #{bid};    </select></mapper>

代码所示,resources/com/gitchat/mybatis/KeywordMapper.xml 即为映射器的 XML 文件:

  • 通过 namespace 与映射器的 Java 接口关联
  • 定义查询语句 selectKeywordIdsUsingBid,需要说明,resultType 定义的类型,既能够表示查询结果的类型,亦能够表示查询结果作为集合时,集合元素的类型

java/com/gitchat/mybatis/KeywordMapper.java

package com.gitchat.mybatis;import org.apache.ibatis.annotations.Select;import java.util.List;public interface KeywordMapper {    List<Long> selectKeywordIdsUsingBid(Long bid);    @Select("SELECT id FROM keyword WHERE bid = #{bid};")    List<Long> annotatedSelectKeywordIdsUsingBid(Long bid);
}

代码所示,java/com/gitchat/mybatis/KeywordMapper.java 即为映射器的 Java 接口:

  • selectKeywordIdsUsingBid 方法与映射器 XML 定义的查询语句名称一致
  • annotatedSelectKeywordIdsUsingBid 使用注解 org.apache.ibatis.annotations.Select 进行了查询语句定义

映射器的 Java 接口被调用时,XML(或注解)定义的 SQL,即 Prepared Statements 的形式,提交数据库执行(传递 1000L 作为 bid 参数):

==>  Preparing: SELECT id FROM keyword WHERE bid = ?;
==> Parameters: 1000(Long)

需要说明:

  • 通常,不建议使用注解的形式进行 SQL 定义
  • 映射器的 Java 接口,其实现由 MyBatis 基于 “动态代理” 机制,于运行时提供

关于映射器的更多内容,请参阅 《MyBatis 的配置、映射器以及动态 SQL》 章节。

java/com/gitchat/mybatis/Main.java

package com.gitchat.mybatis;import com.alibaba.fastjson.JSON;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 java.io.IOException;import java.io.InputStream;public class Main {    public static void main(String args[]) throws IOException {
        InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);        try (SqlSession session = sqlSessionFactory.openSession()) {
            KeywordMapper keywordMapper = session.getMapper(KeywordMapper.class);

            System.out.println(JSON.toJSONString(keywordMapper.selectKeywordIdsUsingBid(1000L)));

            System.out.println(JSON.toJSONString(keywordMapper.annotatedSelectKeywordIdsUsingBid(1000L)));
        }
    }
}

代码所示:

  • 通过 SqlSessionFactoryBuilder 使用配置文件 mybatis-config.xml 完成 SqlSessionFactory 创建
  • 通过 SqlSessionFactory 获得 SqlSession,由 try-with-resource 确保 SqlSessionFactory 释放

特别说明:SqlSessionFactory 提供了 selectselectOneselectList 等接口,能够直接进行数据库查询,然而,使用映射器既能够最大程度地使用 MyBatis 的 ORM,亦能确保良好的编程风格。

配置、映射器以及动态 SQL

1

配置

《MyBatis 基础结构》章节的 “入门案例”,通过 resources/mybatis-config.xml 进行 MyBatis 配置,本章节,我们重点讨论 MyBatis 的配置。

需要说明:MyBatis 的 XML 配置文件,必须符合 mybatis-3-config.dtd 约束。

**properties**

properties 能够用于承载属性的 “键” - “值”,并于配置文件的上下文中使用,使用方式即为${键}properties 支持 property 子元素和配置文件引入两种方式。

property 子元素

property 子元素的 name 和 value,即作为属性的 “键”、“值”。“入门案例” 中,即使用 properties 承载了数据库连接信息。

配置文件引入

使用配置文件,例如,数据库连接的配置文件 db.properties:

driver=com.mysql.cj.jdbc.Driverurl=URLusername=USERNAMEpassword=PASSWORD

引入方式:

<properties resource="db.properties" />

若出现 “键” 相同的属性,“配置文件” 的属性 “值” 具有更高优先级。

此外,MyBatis 支持以 “参数传递” 的方式设置属性的 “值”(最高优先级),但本文并不推荐使用,因此,不予展开讨论。

**settings**

settings 即为 MyBatis 配置,能够控制 MyBatis 行为。通常而言,settings 不需要关注,保持默认值即可正常运行。

关于 settings 中 “配置项” 的完整列表,请参阅:http://www.mybatis.org/mybatis-3/configuration.html#settings。

**typeAliases**

typeAliases 即为 “别名”:作为名称过长时的 “简单指代”。MyBatis “别名” 区分 “系统定义别名” 和 “自定义别名”。

本文分享自微信公众号 - GitChat精品课(CSDN_Tech),作者:阿福

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2018-05-08

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Otto开发初探——微服务依赖管理新利器

    【编者按】时下,Vagrant被DevOps软件开发商广泛作为开发阶段的本地软件开发环境,而在本文,CERT Division高级研究员介绍的Otto则是Vag...

    CSDN技术头条
  • 关于如何阅读源码的一点心得

    本文来自作者 追梦 在 GitChat 上分享 「关于为何以及如何阅读源码的一点心得」

    CSDN技术头条
  • Spring 框架之 AOP 原理剖析

    前言 AOP(Aspect Oriented Programming)面向切面编程是 Spring 框架最核心的组件之一,它通过对程序结构的另一种考虑,补充了...

    CSDN技术头条
  • iOS:KVO/KVC 的概述与使用

    用户1941540
  • django 学习笔记四

    onety码生
  • Hibernate的性能优化之 dynamic-update dynamic-insert

    public class Guestbook implements java.io.Serializable {

    Hongten
  • SSH2框架整合--实现登录

    先写上日志记录需要的属性文件,其他三个文件具体内容在编码时给出 log4j.properties

    xiaohejun
  • targetSdkVersion 更新到 28,出现的问题

    原来的是 targetSdkVersion = 25,因vivo应用市场提醒需要升级到 28,可能出现一系列问题,现记录如下:

    Jingbin
  • keras读取训练好的模型参数并把参数赋值给其它模型详解

    本博文中的代码,实现的是加载训练好的模型model_halcon_resenet.h5,并把该模型的参数赋值给两个不同的新的model。

    砸漏
  • jsp模板继承

    lin_zone

扫码关注云+社区

领取腾讯云代金券