springboot中使用mybatis注解配置詳解

一:傳參方式

1.使用參數順序

// 接口
public interface UserMapper {
    List<User> select(String name,Integer age);
}

xml文件時：

<select id="select" resultType="model.User">
    select * from `user` where name = #{arg0} and age =#{arg1}
</select>
// or
<select id="select" resultType="model.User">
    select * from `user` where name = #{param1} and age =#{param2}
</select>

2.使用@Param

@Insert("INSERT INTO USER(NAME, AGE) VALUES(#{name}, #{age})")
int insert(@Param("name") String name, @Param("age") Integer age);

@Param中定義的name對應了SQL中的#{name}，age對應了SQL中的#{age}。

3.使用Map

對於insert語句中需要的參數只需要在map中添加同名的key值就可以：

Map<String, Object> map = new HashMap<>();
map.put("name", "CCC");
map.put("age", 40);
userMapper.insertByMap(map);

通過Map<String, Object>對象來作為傳遞參數的容器：

@Insert("INSERT INTO USER(NAME, AGE) VALUES(#{name,jdbcType=VARCHAR}, #{age,jdbcType=INTEGER})")
int insertByMap(Map<String, Object> map);

由於map的value為Object，即insert語句中需指定參數的數據類型：jdbcType=INTEGER等。

4.使用javaBean

@Insert("INSERT INTO USER(NAME, AGE) VALUES(#{name}, #{age})")
int insertByUser(User user);

#{name}、#{age} 就分別對應了User對象中的name和age屬性。

5.總結：

xml或注解形式：

當只有一個參數時：使用arg0,param1獲得參數是一直有效的。
參數是基本類型：變量名可以隨便寫，#{id}，#{ids}，#{123}，#{xxgdsgdg},等都可以獲得到參數。
參數是javabean：填寫Javabean中的屬性名
參數是數組：使用array獲得參數，再用foreach循環
參數是List：使用list或collection獲得參數，再用foreach循環
參數是Set：使用collection獲得參數，再用foreach循環

當有多個參數時：
使用argN、paramN或@param定位到某個參數，再靈活使用ognl就ok了。比如#{user.name}、#{users[0].name}

6.注意

void deleteUserRole(long userId,long[] roleIds);

多個參數時：roleIds是數組，但foreach不能用array。使用參數順序或@Param。

<foreach collection="arg1" open="(" close=")" separator=" or " item="value">
    #{value}
</foreach>

二:映射語句

1.insert

<insert id="insert"  parameterType="User" useGeneratedKeys="true" keyProperty="id">
    <!-- 將插入數據的主鍵返回，返回到user對象中 -->
    insert into user (username,address,email) values (#{username},#{address},#{email})
</insert>

@Insert("insert into user (username,address,email) values (#{username},#{address},#{email})")
@Options(useGeneratedKeys = true, keyProperty = "id") 
public int insert(User user) throws Exception;

使用@Options注解的userGeneratedKeys 和keyProperty屬性，讓數據庫auto_increment生成的主鍵值，賦值到keyProperty標記的屬性id中;

還有另外一種方法可以獲取主鍵：

<insert id="insert"  parameterType="User" >
    <!-- 將插入數據的主鍵返回，返回到user對象中 -->
    <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
           select last_insert_id()
    </selectKey>
    insert into user (username,address,email) values (#{username},#{address},#{email})
</insert>

@Insert("insert into user (username,address,email) values (#{username},#{address},#{email})")
@SelectKey(statement="select last_insert_id()",keyProperty="id", resultType=int.class, before=true)
public int insert(User user) throws Exception;

2.select、update、delete

@Select("select * from user where id=#{id}")
public User selectById(int id) throws Exception;

@Update("update user set username=#{username},address=#{address},email=#{email} where id=#{id}")
public int update(User user) throws Exception;

@Delete("delete from user where id=#{id}")
public int delete(int id) throws Exception;

三:結果映射

Mybatis主要提供這些映射注解：
@Results 用於填寫結果集的多個字段的映射關系.
@Result 用於填寫結果集的單個字段的映射關系.
@ResultMap 根據ID關聯XML里面 .

在xml配置文件中，將查詢結果和JavaBean屬性映射起來的標簽是 。對應的 是@Results注解。

@Results({ @Result(id = true, column = "id", property = "id"),
        @Result(column = "username", property = "user_name"),
        @Result(column = "city", property = "city") })
@Select("select * from user")
public List<User> selectAll() throws Exception;

@Results({ @Result(id = true, column = "id", property = "id"),
        @Result(column = "username", property = "user_name"),
        @Result(column = "city", property = "city") })
@Select("select * from user where id=#{id}")
public User selectById(int id) throws Exception;

上面的@Results注解重復使用了。要想使用可以復用的映射器，那么就使用@ResultMap注解。該注解依賴一個xml配置文件。 在接口文件同目錄下新建一個userMapper.xml文件，並定義一個名為userMap的resultMap。

<mapper namespace="mapper.UserMapper">
    <!-- 自定義返回結果集 -->
    <resultMap id="userMap" type="pojo.User">
        <id column="id" property="id" jdbcType="INTEGER" />
        <result property="user_name" column="username"></result>
        <result property="city" column="city"></result>
    </resultMap>
</mapper>

在userMapper.java中，使用@ResultMap引用名為userMap的resultMap，實現復用。

@ResultMap("mapper.UserMapper.userMap") 
@Select("select * from user where id=#{id}")  
public User selectById(int id) throws Exception;

@Select("select * from user")  
@ResultMap("mapper.UserMapper.userMap")  
public List<User> selectAll() throws Exception;

為了方便演示和免除手工編寫映射關系的煩惱，這里提供了一個快速生成映射結果集的方法，具體內容如下：

	/**
     * 1.用於獲取結果集的映射關系
     */
    public static String getResultsStr(Class origin) {
        StringBuilder stringBuilder = new StringBuilder();
        stringBuilder.append("@Results({\n");
        for (Field field : origin.getDeclaredFields()) {
            String property = field.getName();
            //映射關系：對象屬性(駝峰)->數據庫字段(下划線)
            String column = new PropertyNamingStrategy.SnakeCaseStrategy().translate(field.getName()).toUpperCase();
            stringBuilder.append(String.format("@Result(property = \"%s\", column = \"%s\"),\n", property, column));
        }
        stringBuilder.append("})");
        return stringBuilder.toString();
    }

四:關聯關系

1.一對一關系

MyBatis提供了@One注解來配合@Result注解，從而實現一對一關聯查詢數據的加載。
如：一個用戶對應一個賬戶，User對象中聲明Account屬性；

@Results({ @Result(id = true, column = "id", property = "id"),
        @Result(column = "username", property = "user_name"),
        @Result(column = "city", property = "city"),
        @Result(column = "account_id", property = "account",one = @One(select = "mapper.AccountMapper.selectById")) })
@Select("select * from user")
public List<User> selectAll() throws Exception;

在這里column = "account_id"是mapper.AccountMapper.selectById方法傳遞的參數，property = "account"是User對象的account屬性。如果@One中SELECT查詢返回了多行結果，則會拋出TooManyResultsException異常。

如果結果映射使用的是xml文件,那么可以association 來配置映射：

<mapper namespace="mapper.UserMapper">
    <!-- 自定義返回結果集 -->
    <resultMap id="userMapWithAccount" type="pojo.User">
        <id column="id" property="id" jdbcType="INTEGER" />
        <result property="user_name" column="username"></result>
        <result property="city" column="city"></result>
        <association property="account" javaType="Account" column="account_id" 
            select="mapper.AccountMapper.selectById" />
    </resultMap>
</mapper>

接口如下：

@Select("select * from user")
@ResultMap("mapper.UserMapper.userMapWithAccount")
public List<User> selectAll() throws Exception;

2.一對多關系

MyBatis提供了@Many注解來配合@Result注解，從而實現一對多關聯查詢數據的加載。
如：一個講師對應多個課程，在Tutor里聲明courseList屬性。

public interface TutorMapper
{
	@Results({
	        @Result(id = true, column = "course_id", property = "courseId"),
	        @Result(column = "name", property = "name"),
	        @Result(column = "description", property = "description"),
	        @Result(column = "start_date" property = "startDate"),
	        @Result(column = "end_date" property = "endDate")
	    })
    @Select("select * from courses where tutor_id=#{tutorId}")
    List<Course> findCoursesByTutorId(int tutorId);

    @Results({
        @Result(id = true, column = "tutor_id", property = "tutorId"),
        @Result(column = "tutor_name", property = "name"),
        @Result(column = "email", property = "email"),
        @Result(property = "courses", column = "tutor_id",
        many = @Many(select = "mappers.TutorMapper.findCoursesByTutorId"))
    })
    @Select("SELECT tutor_id, name as tutor_name, email, addr_id FROM tutors where tutor_id=#{tutorId}")
    Tutor findTutorById(int tutorId);
}

采用配置xml中配置resultMaps的方式，可以用collection來配置映射：

<mapper namespace="mappers.TutorMapper">
    <resultMap type="Course" id="CourseResult">
        <id column="course_id" property="courseId" />
        <result column="name" property="name" />
        <result column="description" property="description" />
        <result column="start_date" property="startDate" />
        <result column="end_date" property="endDate" />
    </resultMap>
    <resultMap type="Tutor" id="TutorResult">
        <id column="tutor_id" property="tutorId" />
        <result column="tutor_name" property="name" />
        <result column="email" property="email" />
        <collection property="courses" resultMap="CourseResult" />
    </resultMap>
</mapper>

接口可寫成下面：

public interface TutorMapper
{
    @Select("SELECT * FROM TUTORS T LEFT JOIN ADDRESSES A ON T.ADDR_ID=A.ADDR_ID LEFT OUTER JOIN COURSES C ON T.TUTOR_ID=C.TUTOR_ID WHERE T.TUTOR_ID=#{tutorId}")
    @ResultMap("mappers.TutorMapper.TutorResult")
    Tutor selectTutorById(int tutorId);
}

五:動態SQL

MyBatis提供了各種注解如@InsertProvider,@UpdateProvider,@DeleteProvider和@SelectProvider，來幫助構建動態SQL語句，然后讓MyBatis執行這些SQL語句。

以@SelectProvider 為例，主要包含兩個注解屬性，其中type表示工具類，method 表示工具類的某個方法，用於返回具體的SQL。

@Mapper
public interface UserMapper {
    @SelectProvider(type = UserSqlProvider.class, method = "list222")
    List<User> list2();
}

工具類代碼：

public class UserSqlProvider {
    public String list222() {
        return "select * from t_user ;
    }

六:案例

1.引入依賴

<dependencies>
        <dependency> <!--添加Web依賴 -->
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency> <!--添加Mybatis依賴 -->
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>1.3.1</version>
        </dependency>
        <dependency><!--添加MySQL驅動依賴 -->
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency><!--添加Test依賴 -->
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

2.添加配置

spring:
  datasource:
    #連接MySQL
    url: jdbc:mysql://localhost:3306/socks?useSSL=false
    username: root
    password: root
    driver-class-name: com.mysql.jdbc.Driver

mybatis:
  configuration:
   #配置項：開啟下划線到駝峰的自動轉換. 作用：將數據庫字段根據駝峰規則自動注入到對象屬性。
   map-underscore-to-camel-case: true

logging:
  level:
   #打印SQL信息
   com.hehe.mapper: debug

3.數據層代碼

3.1 UserMapper接口:用於數據查詢

@Mapper
public interface UserMapper {
    /**
     * 方式1：使用注解編寫SQL。
     */
    @Select("select * from t_user")
    List<User> list();

    /**
     * 方式2：使用注解指定某個工具類的方法來動態編寫SQL.
     */
    @SelectProvider(type = UserSqlProvider.class, method = "listByUsername")
    List<User> listByUsername(String username);

    /**
     * 延伸：上述兩種方式都可以附加@Results注解來指定結果集的映射關系.
     *
     * PS：如果符合下划線轉駝峰的匹配項可以直接省略不寫。
     */
    @Results({
            @Result(property = "userId", column = "USER_ID"),
            @Result(property = "username", column = "USERNAME"),
            @Result(property = "password", column = "PASSWORD"),
            @Result(property = "mobileNum", column = "PHONE_NUM")
    })
    @Select("select * from t_user")
    List<User> listSample();

    /**
     * 延伸：無論什么方式,如果涉及多個參數,則必須加上@Param注解,否則無法使用EL表達式獲取參數。
     */
    @Select("select * from t_user where username like #{username} and password like #{password}")
    User get(@Param("username") String username, @Param("password") String password);

    @SelectProvider(type = UserSqlProvider.class, method = "getBadUser")
    User getBadUser(@Param("username") String username, @Param("password") String password);

}

3.2 UserSqlProvider類:用於生成SQL的工具類

/**
 * 主要用途：根據復雜的業務需求來動態生成SQL.
 * <p>
 * 目標：使用Java工具類來替代傳統的XML文件.(例如：UserSqlProvider.java <-- UserMapper.xml)
 */
public class UserSqlProvider {
    /**
     * 方式1：在工具類的方法里,可以自己手工編寫SQL。
     */
    public String listByUsername(String username) {
        return "select * from t_user where username =#{username}";
    }

    /**
     * 方式2：也可以根據官方提供的API來編寫動態SQL。
     */
    public String getBadUser(@Param("username") String username, @Param("password") String password) {
        return new SQL() {{
            SELECT("*");
            FROM("t_user");
            if (username != null && password != null) {
                WHERE("username like #{username} and password like #{password}");
            } else {
                WHERE("1=2");
            }
        }}.toString();
    }
}

4.實體類User

public class User {
    private String userId;
    private String username;
    private String password;
    private String mobileNum;
    //Getters & Setters
}

后記

官方文檔：http://www.mybatis.org/mybatis-3/zh/java-api.html
使用注解配置Mapper：https://blog.csdn.net/soonfly/article/details/67640653
SpringBoot 快速整合Mybatis：https://zhuanlan.zhihu.com/p/31015559
Spring Boot中使用MyBatis注解配置詳解：http://blog.didispace.com/mybatisinfo/