mybatis 3中增加了使用注解来配置Mapper的新特性,其中@Provider的使用方式较为复杂。@provide主要分为四种:@InsertProvider、@DeleteProvider、@UpdateProvider和@SelectProvider,分别对应着sql中的增删改查四种操作。本文主要介绍一下mybatis 3 中@SelectProvider的使用技巧。

1、@SelectProvider源码

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface SelectProvider
{
    Class<?> type();

    String method();
}

2、@SelectProvider的使用

@SelectProvider是声明在方法上的,这个方法定义在Mapper对应的的interface上。如下所示:

public interface UserMapper 
{
    @SelectProvider(type = SqlProvider.class, method = "selectUser")
    @ResultMap("userMap")
    public User getUser(long userId);
}

上例中是个很简单的Mapper接口,其中定义了一个方法:getUser,这个方法根据提供的用户id来查询用户信息,并返回一个User实体bean。这是一个很简单很常用的查询场景:根据key来查询记录并将结果封装成实体bean。其中:
(1)@SelectProvider注解用于生成查询用的sql语句,有别于@Select注解,@SelectProvide指定一个Class及其方法,并且通过调用Class上的这个方法来获得sql语句。在我们这个例子中,获取查询sql的方法是SqlProvider.selectUser。
(2)@ResultMap注解用于从查询结果集RecordSet中取数据然后拼装实体bean。

3、定义拼装sql的类

@SelectProvide中type参数指定的Class类,必须要能够通过无参的构造函数来初始化。

@SelectProvide中method参数指定的方法,必须是public的,返回值必须为String。

public class SqlProvider 
{
    public String selectUser(long userId) 
    {
      return "select * from user where userId=" + userId;
    }
}

4、无参数@SelectProvide方法

在Mapper接口方法上和@SelectProvide指定类方法上,均无参数:

UserMapper.java:

@SelectProvider(type = SqlProvider.class, method = "selectAllUser")
@ResultMap("userMap")
public List<User> getAllUser();

SqlProvider.java:

public String selectAllUser() 
{
    return "select * from user";
}

5、一个参数的@SelectProvide方法

对于只有一个参数的情况,可以直接使用,参见前面的getUser和selectUser。

但是,如果在getUser方法中,对userId方法使用了@Param注解的话,那么相应selectUser方法必须接受Map<String, Object>做为参数:

UserMapper.java:

@SelectProvider(type = SqlProvider.class, method = "selectUser2")
@ResultMap("userMap")
public User getUser2(@Param("userId") long userId);

SqlProvider.java:

public String selectUser2(Map<String, Object> para) 
{
    return "select * from user where userId=" + para.get("userId");
}

6、更多参数的@SelectProvide方法

在超过一个参数的情况下,@SelectProvide方法必须接受Map<String, Object>做为参数。

如果参数使用了@Param注解,那么参数在Map中以@Param的值为key,如下例中的userId。

如果参数没有使用@Param注解,那么参数在Map中以参数的顺序为key,如下例中的password。

UserMapper.java:

@SelectProvider(type = SqlProvider.class, method = "selectUserCheck")
@ResultMap("userMap")
public User getUserCheck(@Param("userId") long userId, String password);

SqlProvider.java:

public String selectUserCheck(Map<String, Object> para) 
{
    return "select * from user where userId=" + para.get("userId") + " and password='" + para.get("1") + "'";
}

7、注意事项

在Mapper接口和@SelectProvide方法类中,不要使用重载,也就是说,不要使用方法名相同参数不同的方法,以避免发生诡异问题。

标签: none

仅有一条评论

  1. 哮天狗 哮天狗

    好诡异的问题,哈哈哈

添加新评论