Mybatis - 动态sql

时间：2023-11-20 17:53:08

learn from：http://www.mybatis.org/mybatis-3/dynamic-sql.html

mybatis支持动态拼接sql语句。主要有：

  • if
  • choose (when, otherwise)
  • trim (where, set)
  • foreach

1.if

首先看基本实例：

<select id="findActiveBlogWithNameLike"  resultType="Blog">

        SELECT * FROM blog

        WHERE state = 'active'

        <if test="name != null">

            AND name LIKE #{name}

        </if>

</select>
List<Blog> findActiveBlogWithNameLike(String name);

这里遇到一个问题：

 There is no getter for property named 'name' in 'class java.lang.String'### 
Cause: org.apache.ibatis.reflection.ReflectionException: There is no getter for property named 'name' in 'class java.lang.String'

也就是说，mybatis将name当做输入参数的一个属性，并且期望通过getter方法来获取它的值。很容易想到，将输入参数改成Blog就可以了。

然而，这并不符合我们的查询习惯，比如，如果是Blog就必须这样查询：

@Test

    public void testFindActiveBlogWithNameLike() throws Exception{

        Blog key = new Blog();

        key.setName("test%");

        List<Blog> blogs = mapper.findActiveBlogWithNameLike(key);

        System.out.println(blogs);

        return;

    }

为了一个String字段而创建一个类，看着要多别扭有多别扭。当然，前提是我们仅仅是查询name条件，所以会觉得其他属性冗余。如果是多条件查询，那么Blog必然是最好的选择。那么，仅仅传入String的话应该也是可以的。参考1,参考2。

第一种做法是简单类型都是使用_parameter来代替。

<select id="findActiveBlogWithNameLikeByString" parameterType="java.lang.String" resultType="Blog">

        SELECT * FROM blog

        WHERE name LIKE '%${_parameter}%'

</select>

第二种做法比较容易理解,在方法参数前添加@Param(value="xxx")注解来使用xxx作为传入参数。

<select id="findActiveBlogWithNameLikeByString" parameterType="java.lang.String" resultType="Blog">

        SELECT * FROM blog

        WHERE name LIKE '%${key}%'

</select>

List<Blog> findActiveBlogWithNameLikeByString(@Param(value = "key") String key);

两种做法均可，所以，看你喜欢了，是想要省事简洁还是通俗易读。在这里，还是选择第0种方案，即传入Blog对象来作为查询条件。

下面简单介绍if的语法：

  • if节点中，属性test是一个boolean值，为true的时候将拼接if里的sql语句。
  • 参数值是可以包含一些掩码或通配符的.比如通配符%和占位符_

所以，很简单很容易理解。

场景一： 查询blog的名字name  like %Insert and 作者author的username like Ryan%.

首先看期望的结果，blog表中有三条满足name like:

mysql> select * from blog;

+----+------------+-----------+--------------+--------+

| id | name       | author_id | co_author_id | state  |

+----+------------+-----------+--------------+--------+

|  1 | test       |         3 |            4 | active |

|  8 | testInsert |         4 |            5 | active |

|  9 | testInsert |         5 |            6 | active |

| 10 | testInsert |         6 |            7 | active |

| 12 | testA      |        50 | NULL         | active |

| 13 | testA      |        51 | NULL         | active |

| 14 | testInsert | NULL      | NULL         | active |

+----+------------+-----------+--------------+--------+

7 rows in set

这三条中，满足author的username like的有两条：

mysql> select author.id, author.username from author where id in (4,5,6);

+----+----------+

| id | username |

+----+----------+

|  4 | Ryan     |

|  5 | Ryan0    |

|  6 | Leslie   |

+----+----------+

3 rows in set

也就是我们最终希望结果是blog id为8 和 9。

mybatis的sql语句如下：

<select id="findActiveBlogLike" resultType="Blog">

        SELECT * FROM blog b, author a

        WHERE state = 'active'

        <if test="name != null">

            AND name LIKE #{name}

        </if>

        AND b.author_id = a.id

        <if test="author != null and author.name != null">

            AND a.username  LIKE #{author.username}

        </if>

</select>

当blog的name不为null的时候查询name匹配，当author的username不为null的时候，查询author的username匹配。

  • 第一个if节点的test为name，这个会查找Blog的name字段，如果传入参数Blog没有name字段，那么就会像我们开始那样报错。所以，name必须是blog的一个字段。同理，#{name}这个也要和blog字段字面量的值匹配。
  • 第二个if节点的test里看到了and，and就是并且。首先判断author是否为null，就是判断Blog对象的author属性是否为null。接着判断author.name是否为null，这里就有点问题了。因为我的Author类中并没有name字段，对应的字段字面量是username。也就是说这里应该是author.username。但我粗心写成了author.name（所以为每段代码编写unit test是多么的重要）。更奇葩的是，这条test通过了判断为真，这里先不讲，后面测试的时候再分析原因。不过这里一定要改成author.username才是正确的做法。

对应的java接口：

List<Blog> findActiveBlogLike(Blog blog);

下面开始测试：

    @Test

    public void testFindActiveBlogLike() throws Exception{

        Blog blog = new Blog();

        blog.setName("%Insert");

        Author author = new Author();

        author.setUsername("Ryan%");

        blog.setAuthor(author);

        List<Blog> blogs = mapper.findActiveBlogLike(blog);

        System.out.println(blogs);

        assertTrue(blogs.size()==2);

        return;

    }

先看结果对不对：

2016-08-06 16:20:19,264 DEBUG [org.apache.ibatis.transaction.jdbc.JdbcTransaction] - Opening JDBC Connection

2016-08-06 16:20:19,740 DEBUG [org.apache.ibatis.datasource.pooled.PooledDataSource] - Created connection 1150284200.

2016-08-06 16:20:19,742 DEBUG [org.apache.ibatis.transaction.jdbc.JdbcTransaction] - Setting autocommit to false on JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@448ff1a8]

2016-08-06 16:20:19,745 DEBUG [com.test.mapper.dao.BlogMapper.findActiveBlogLike] - ==>  Preparing: SELECT * FROM blog b, author a WHERE state = 'active' AND name LIKE ? AND b.author_id = a.id AND a.username LIKE ?

2016-08-06 16:20:19,888 DEBUG [com.test.mapper.dao.BlogMapper.findActiveBlogLike] - ==> Parameters: %Insert(String), Ryan%(String)

2016-08-06 16:20:19,978 DEBUG [com.test.mapper.dao.BlogMapper.findActiveBlogLike] - <==      Total: 2

[Blog{id=8, name='testInsert', author=null, coAuthor=null, posts=null, state='active'}, Blog{id=9, name='testInsert', author=null, coAuthor=null, posts=null, state='active'}]

test通过了，blog也确实是我们想要的两条。但仔细观察结果就会发现几个问题。第一个问题是author为null，这个我们等下再解决。第二问题是sql查询语句查询了author.username like，也就是说我们第二个if节点的test 为true。难道出了问题？我们的Author类明明没有name字段。所以，这里要跟踪下代码。

好吧，跟踪了半天一直到ognl内部，还是没追踪到为什么name翻译成username了。下面还是搞定第一个问题，author为null。

查询的结果映射到Blog，但blog的author字段并没有初始化。很容易就猜测到结果集的字段和blog的author不匹配。这个就用到resultMap而不是resultType。在上一遍博文中记录了下来。

<select id="findBlogMap" resultMap="findBlogResultMap">

        SELECT b.id AS id,

                b.name AS name,

                b.state AS state,

                a.id        as author_id,

                a.username  as author_username,

                a.password  as author_password,

                a.email     as author_email,

                a.bio       as author_bio

        FROM blog b, author a

        WHERE state = 'active'

        <if test="name != null">

            AND name LIKE #{name}

        </if>

        AND b.author_id = a.id

        <if test="author != null and author.username != null">

            AND a.username  LIKE #{author.username}

        </if>

    </select>

    <resultMap id="findBlogResultMap" type="Blog">

        <id property="id" column="id"/>

        <result property="name" column="name"/>

        <result property="state" column="state"/>

        <association property="author" column="author_id" javaType="Author">

            <id property="id" column="author_id"/>

            <result property="username" column="author_username"/>

            <result property="password" column="author_password"/>

            <result property="email" column="author_email"/>

            <result property="bio" column="author_bio"/>

        </association>

    </resultMap>

这样测试结果：

-- ::, DEBUG [org.apache.ibatis.transaction.jdbc.JdbcTransaction] - Opening JDBC Connection

-- ::, DEBUG [org.apache.ibatis.datasource.pooled.PooledDataSource] - Created connection .

-- ::, DEBUG [org.apache.ibatis.transaction.jdbc.JdbcTransaction] - Setting autocommit to false on JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@]

-- ::, DEBUG [com.test.mapper.dao.BlogMapper.findBlogMap] - ==>  Preparing: SELECT b.id AS id, b.name AS name, b.state AS state, a.id as author_id, a.username as author_username, a.password as author_password, a.email as author_email, a.bio as author_bio FROM blog b, author a WHERE state = 'active' AND name LIKE ? AND b.author_id = a.id AND a.username LIKE ?

-- ::, DEBUG [com.test.mapper.dao.BlogMapper.findBlogMap] - ==> Parameters: %Insert(String), Ryan%(String)

-- ::, DEBUG [com.test.mapper.dao.BlogMapper.findBlogMap] - <==      Total:

[Blog{id=8, name='testInsert', author=Author{id=4, username='Ryan', password='123456', email='qweqwe@qq.com', bio='this is a blog'}, coAuthor=null, posts=null, state='active'}, Blog{id=9, name='testInsert', author=Author{id=5, username='Ryan0', password='123456', email='qweqwe@qq.com', bio='this is a blog'}, coAuthor=null, posts=null, state='active'}]

2.choose

相关文章