Mybatis-常见SQL语句示例

官方说明文档:http://www.mybatis.org/mybatis-3/zh/index.html#

resultType和resultMap区别

resultType:从这条语句中返回的期望类型的类的完全限定名或别名。注意如果是集合情形,那应该是集合可以包含的类型,而不能是集合本身。使用 resultType 或 resultMap,但不能同时使用。

也就是说,使用resultType直接表示的就是返回类型,可以是基本类型(int、string)、list、map这些,也可以是具体的pojo对象

  • 完全限定名,意思是例如返回Task对象,那么值填写的是该Task类的完整类路径;如果返回的是基础类型,就是类似java.util.Map
  • 别名,意思是例如返回map类型,我们不需要写完整的java.util.Map,可以用map替代
  • 不能是集合本身,这句话意思是例如接口需要返回List<Task>,那么直接写resultType="com.baidu.vo.Task",而不是写成resultType="List<com.baidu.vo.Task>"

resultMap:外部 resultMap 的命名引用。结果集的映射是 MyBatis 最强大的特性,对其有一个很好的理解的话,许多复杂映射的情形都能迎刃而解。使用 resultMap 或 resultType,但不能同时使用。

相对复杂一点,需要先定义一个外部标签<resultMap>,这里面一般定义了结果到pojo的映射关系,有id属性,在具体的查询语句中通过id寻找对应的resultMap

  • 外部 resultMap 的命名引用,意思是并不是直接的返回类型,只是一个引用标识,需要去找对应的该引用的定义地方

DEMO-resultType

  • select * from task where id = {id} 输出单个Task对象

TaskMapper.xml代码

<select id="select" parameterType="int" resultType="com.baidu.pojo.entity.Task">
        select * from task where id = #{id}
</select>

TaskMapper.java代码

Task select(int id);
  • select * from task 输出Task集合

TaskMapper.xml代码

<select id="select" resultType="com.baidu.pojo.entity.Task">
        select * from task 
</select>

TaskMapper.java代码

List<Task> select();

note:通过上面两个例子发现,无论输出单个对象还是一个列表,resultType的类型都是一样的。如果第二个例子中,TaskMapper.java里面方法返回值类型是Task而不是List<Task>的话,当查询的结果包含多条语句时,就会抛TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 10

  • select count(*) from task

TaskMapper.xml代码

<select id="select" resultType="int">
        select count(*) from task
</select>

TaskMapper.java代码

int select();
  • select name from task where id = {id} 输出单个name

TaskMapper.xml代码

<select id="select" parameterType="int" resultType="String">
        select name from task where id = #{id}
</select>

TaskMapper.java代码

String select(int id);
  • select distinct name from task 输出name集合

TaskMapper.xml代码

<select id="select" resultType="String">
        select distinct name from task
</select>

TaskMapper.java代码

List<String> select();

note:无论是单个name还是一个name集合,resultType都是String

  • select id, name from task where id = {id}

TaskMapper.xml代码

<select id="select" resultType="map">
        select id, name from task where id = #{id}
</select>

TaskMapper.java代码

Map select();

note:返回类型是map时,一条记录会映射为一个map对象,列名对应键,结果对应值,如果是多条结果,那么应该映射为类型的map的一个集合

  • select status, count(*) as num from task group by status desc 统计任务表里所有状态的个数

TaskMapper.xml代码

<select id="select" resultType="hashmap">
        select status, count(*) as num from task group by status desc
</select>

TaskMapper.java代码

List<HashMap> select();

note:注意这里的返回值是一个list,list中的元素是map对象,假如group之后有4组,那么就是包含4个map的数组

  • select * from task where id in (3, 4, 5) 参数是一个数组

TaskMapper.xml代码

<select id="select" resultType="com.baidu.pojo.entity.Task">
        select * from task where id in
        <foreach item="item" index="index" collection="list"
                 open="(" separator="," close=")">
            #{item}
        </foreach>
</select>

TaskMapper.java代码

List<Task> select(List ids);

note:item代表循环中的具体对象,如果collection属性是list,那item就表示list中的一个元素;collection是遍历的对象,可以是list、array,如果Mapper.java里传入参数时使用@param(“param”)来设置名字,那这里的collection属性就填写对应的参数名;separator是分隔符,例如sql中出现in语句时,就会设置separator=“,”分隔;open和close代表in语句里面的前后括号

  • insert into task (title, name) values ('标题', '名字') 参数是一个map

TaskMapper.xml代码

<insert id="insert" parameterType="map">
        insert into task
        <foreach collection="map.keys" item="key" open="(" close=")" separator=",">
            ${key}
        </foreach>
        values
        <foreach collection="map.keys" item="key" open="(" close=")" separator=",">
            #{map[${key}]}
        </foreach>
</insert>

TaskMapper.java代码

int test(@Param("map") Map map);

note:这里Mapper.java文件里面使用的@param注解,对应的collection就使用注解定义好的名字

DEMO-resultMap

定义一个Task类

public class Task {
    private Integer id;
    private String title;
    private String name;
    private Date createAt;

    public Integer getId() {return id;}
    public void setId(Integer id) {this.id = id;}
    public String getTitle() {return title;}
    public void setTitle(String title) {this.title = title;}
    public String getName() {return name;}
    public void setName(String name) {this.name = name;}
    public Date getCreateAt() {return createAt;}
    public void setCreateAt(Date createAt) {this.createAt = createAt;}
}

定义一个resultMap

<resultMap id="BaseResultMap" type="com.baidu.pojo.entity.Task">
        <id column="id" property="id" jdbcType="INTEGER"/>
        <result column="title" property="title" jdbcType="VARCHAR"/>
        <result column="name" property="name" jdbcType="VARCHAR"/>
        <result column="create_at" property="createAt" jdbcType="TIMESTAMP"/>
</resultMap>

note:column代表数据库表里面的属性,property代表赋值给实体对象的属性

定义一个sql

<sql id="Base_Column_List">
        id, title, name, create_at
</sql>

note:这个元素是用来定义可以重复使用的sql代码语句的,这里面把Task表的全部列名定义为了一个sql,是为了下面查询语句的重复使用

  • select * from task where create_at = '2017-07-07' 查询数据

TaskMapper.xml代码

<select id="select" resultMap="BaseResultMap" parameterType="com.baidu.pojo.entity.Task">
        select <include refid="Base_Column_List"/> from task
        <where>
            <if test="id != null">id=#{id}</if>
            <if test="title != null">and title=#{title}</if>
            <if test="name != null">and name=#{name}</if>
            <if test="createAt != null">and create_at=#{createAt}</if>
        </where>
</select>

TaskMapper.java代码

List<Task> select(Task task);

note:这里用到了resultMap属性,where元素知道只有在一个以上的if条件有值的情况下才去插入WHERE子句。而且,若最后的内容是AND或OR开头的,where元素也知道如何将他们去除。这里面的if语句很直观,就是代表如果传入的参数中,该属性不为空,那么就把该条件带上去

  • insert into task (title, name,create_at) values ('标题', '名字', '2017-07-07') 插入数据

TaskMapper.xml代码

<insert id="add" parameterType="com.baidu.pojo.entity.Task" useGeneratedKeys="true" keyProperty="id">
        insert into task (<include refid="Base_Column_List"/>) values (
        #{id,jdbcType=INTEGER}, 
        #{title,jdbcType=VARCHAR},
        #{name,jdbcType=VARCHAR},
        #{createAt,jdbcType=TIMESTAMP} )
</insert>

TaskMapper.java代码

int add(Task task);

note:useGeneratedKeys表示是否使用JDBC的getGenereatedKeys方法获取主键并赋值到keyProperty设置的属性中,这里就是id是自增长的主键,值可以通过getGenereatedKeys方法获取然后复制到task对象的属性上面

  • update task set name = '名字' where id = {id} 更新数据

TaskMapper.xml代码

<update id="update" parameterType="com.baidu.pojo.entity.Task">
        update task
        <set>
            <if test="title != null">title=#{title,jdbcType=VARCHAR},</if>
            <if test="name != null">name=#{name,jdbcType= VARCHAR},</if>
            <if test="createAt != null">create_at=#{createAt,jdbcType=TIMESTAMP}</if>
        </set>
</update>

TaskMapper.java代码

int update(Task task);

note:set 元素会动态前置SET关键字,同时也会消除无关的逗号

  • delete from task where create_at = '2017-07-07' 删除数据

TaskMapper.xml代码

<delete id="select" parameterType="com.baidu.pojo.entity.Task">
        delete from task
        <where>
            <if test="id != null">id=#{id}</if>
            <if test="title != null">and title=#{title}</if>
            <if test="name != null">and name=#{name}</if>
            <if test="createAt != null">and create_at=#{createAt}</if>
        </where>
</delete>

TaskMapper.java代码

int delete(Task task);
  • select * from task where title = {title} and name = {name} 利用索引传递多个参数

TaskMapper.xml代码

<select id="select" resultMap="baseResultMap">
        select <include refid="Base_Column_List"/> from task where title = #{0} and name = #{1}
</select>

TaskMapper.java代码

List<Task> select(String title, String name);

note:使用#{index}指定参数,索引从0开始

  • select * from task where title = {title} and name = {name} 利用@param注解传递多个参数

TaskMapper.xml代码

<select id="select" resultMap="baseResultMap">
        select <include refid="Base_Column_List"/> from task where title = #{title} and name = #{name}
   
</select>

TaskMapper.java代码

List<Task> select(@Param("title") String title, @Param("name") String name);

DEMO-关联查询

描述:一个计划有一个执行人,一个人只能执行一个计划

定义一个User类

public class User {
    private Integer id;
    private String name;
    
    public Integer getId() {return id;}
    public void setId(Integer id) {this.id = id;}
    public String getName() {return name;}
    public void setName(String name) {this.name = name;}
}

定义一个Plan类

public class Plan {
    private Integer id;
    private String name;
    private User user;

    public Integer getId() {return id;}
    public void setId(Integer id) {this.id = id;}
    public String getName() {return name;}
    public void setName(String name) {this.name = name;}
    public String getUser() {return user;}
    public void setUser(User user) {this. user = user;}
}
  • select * from plan, user where plan.uid = user.id and plan.id = #{id} 一对一关联查询(方式一)

定义一个resultMap

<resultMap id="PlanUserMap" type="com.baidu.pojo.entity.Plan">
        <id column="id" property="id" jdbcType="INTEGER"/>
        <result column="name" property="name" jdbcType="VARCHAR"/>
        <association property="user" javaType="com.baidu.pojo.entity.User">
            <id column="id" property="id" jdbcType="INTEGER"/>
            <result column="name" property="name" jdbcType="VARCHAR"/>
        </association>
</resultMap>

PlanMapper.xml代码

<select id="select" parameterType="int" resultMap="PlanUserMap">
        select * from plan, user where plan.uid = user.id and plan.id = #{id}       
</select>

PlanMapper.java代码

Plan select(int id);

note:uid是Task表的外键,这里面用的是association标签

  • select * from plan, user where plan.uid = user.id and plan.id = #{id} 一对一关联查询(方式二)

定义一个resultMap

<resultMap id="PlanUserMap" type="com.baidu.pojo.entity.Plan">
        <id column="id" property="id" jdbcType="INTEGER"/>
        <result column="name" property="name" jdbcType="VARCHAR"/>
        <association column="uid" property="user" select="getUser"/>
</resultMap>

PlanMapper.xml代码

<select id="select" parameterType="int" resultMap="PlanUserMap">
        select * from plan where id = #{id}       
</select>

<select id="getUser" parameterType="int" resultType="com.baidu.pojo.entity.User">
        select * from user where id = #{id}       
</select>

PlanMapper.java代码

Plan select(int id);

note:先查询出一条Plan记录,然后把该记录的uid值作为User表的id,查询对应的User记录


描述:一个计划可以执行多个任务,一个任务属于一个计划

定义一个Task类

public class Task {
    private Integer id;
    private String title;
    private String name;
    private Date createAt;

    public Integer getId() {return id;}
    public void setId(Integer id) {this.id = id;}
    public String getTitle() {return title;}
    public void setTitle(String title) {this.title = title;}
    public String getName() {return name;}
    public void setName(String name) {this.name = name;}
    public Date getCreateAt() {return createAt;}
    public void setCreateAt(Date createAt) {this.createAt = createAt;}
}

定义一个Plan类

public class Plan {
    private Integer id;
    private String name;
    private List<Task> tasks;

    public Integer getId() {return id;}
    public void setId(Integer id) {this.id = id;}
    public String getName() {return name;}
    public void setName(String name) {this.name = name;}
    public List<Task> getTasks() {return tasks;}
    public void setTasks(List<Task> tasks) {this. tasks = tasks;}
}
  • select * from plan, task where plan.id = task.pid and plan.id = #{id} 一对多关联查询(方式一)

定义一个resultMap

<resultMap id="PlanTaskMap" type="com.baidu.pojo.entity.Plan">
        <id column="id" property="id" jdbcType="INTEGER"/>
        <result column="name" property="name" jdbcType="VARCHAR"/>
        <collection property="tasks" ofType="com.baidu.pojo.entity.Task">
             <id column="id" property="id" jdbcType="INTEGER"/>
             <result column="title" property="title" jdbcType="VARCHAR"/>
             <result column="name" property="name" jdbcType="VARCHAR"/>
             <result column="create_at" property="createAt" jdbcType="TIMASTAMP"/>
        </collection>
</resultMap>

PlanMapper.xml代码

<select id="select" parameterType="int" resultMap="PlanTaskMap">
        select * from plan, task where plan.id = task.pid and plan.id = #{id}       
</select>

PlanMapper.java代码

Plan select(int id);

note:pid是Task表的外键,这里面用的是collection标签

  • select * from plan, task where plan.id = task.pid and plan.id = #{id} 一对多关联查询(方式二)

定义一个resultMap

<resultMap id="PlanTaskMap" type="com.baidu.pojo.entity.Plan">
        <id column="id" property="id" jdbcType="INTEGER"/>
        <result column="name" property="name" jdbcType="VARCHAR"/>
        <collection column="pid" property="tasks" ofType="com.baidu.pojo.entity.Task" select="getTask">
        </collection>
</resultMap>

PlanMapper.xml代码

<select id="select" parameterType="int" resultMap="PlanTaskMap">
        select * from plan where id = #{id}       
</select>

<select id="getTask" parameterType="int" resultType="com.baidu.pojo.entity.Task">
        select * from task where id = #{id}       
</select>

PlanMapper.java代码

Plan select(int id);

note:先查询出一条Plan记录,然后把该记录的id值作为Task表的pid,查询对应的多条Task记录

补充

我们发现,无论结果是返回一个值还是一个数组,resultType的返回类型都是单一的对象,但是Mapper.java里面有的是单一值,有的是list,MyBatis是如何知道我们想要的是一个结果还是多个结果。其实,无论返回一个还是多个,MyBatis都是按照多个结果查询,看一下selectOne源码:

public <T> T selectOne(String statement, Object parameter) {
    List<T> list = this.<T>selectList(statement, parameter);
    if (list.size() == 1) {
        return list.get(0);
    } else if (list.size() > 1) {
        throw new TooManyResultsException("Expected one result (or null) to be returned by selectOne(), but found: " + list.size());
    } else {
        return null;
    }
}

即使使用的是selectOne方法,里面调用的还是selectList方法,然后返回第一个值,代码中有一句大家可能会很熟悉。当返回值有多个,但是接口中的返回类型是单一的对象的时候,就会抛该错误

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,294评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,493评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,790评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,595评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,718评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,906评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,053评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,797评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,250评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,570评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,711评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,388评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,018评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,796评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,023评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,461评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,595评论 2 350

推荐阅读更多精彩内容