springboot入门（三）-- springboot集成mybatis及mybatis generator工具使用

前言

mybatis是一个半自动化的orm框架，所谓半自动化就是mybaitis只支持数据库查出的数据映射到pojo类上，而实体到数据库的映射需要自己编写sql语句实现，相较于hibernate这种完全自动化的框架我更喜欢mybatis，mybatis非常灵活，可以随心所欲的编写自己的sql语句来实现复杂的数据库操作，还会有一种畅酣淋漓的编写sql语句的潇洒感，但是以前的mybaits需要一大堆的配置文件，以及各种mapper和dao和实体的关联，导致使用mybatis还是不够简洁，后来mybatis也发现了这个弊端，开发了mybatis generator工具来自动化生成实体类、mapper配置文件、dao层代码来减轻开发工作量，在后期也是实现了抛弃mapper配置文件基于注解的开发模式，直到现在，mybatis看spring boot这么火热，也开发了一套基于spring boot的模式：mybatis-spring-boot-starter。
spring boot简约轻巧的风格正在逐渐被越来越多的厂商及开发者所认可，包括阿里的开源RPC框架dubbo也准备开发一套对spring boot应用的支持（dubbo-spring-boot-starter启动配置模块）

正文

springboot与mybatis集成

首先还是从http://start.spring.io/ 上初始化一个项目下来，然后在pom.xml文件中加入mybatis启动项（由于mybatis-spring-boot-starter依赖了spring-boot-starter，所以可以不用再添加spring-boot-starter了）以及mysql及web依赖

<dependencies>
    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-webartifactId>
    dependency>
    <dependency>
        <groupId>mysqlgroupId>
        <artifactId>mysql-connector-javaartifactId>
    dependency>
    <dependency>
        <groupId>org.mybatis.spring.bootgroupId>
        <artifactId>mybatis-spring-boot-starterartifactId>
        <version>1.3.1version>
    dependency>

    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-testartifactId>
        <scope>testscope>
    dependency>
dependencies>

在application.properties中配置数据源及mybatis配置：

spring.application.name=spring-boot-config
server.port=8080
server.context-path=/

#mybatis.config-location=classpath:mybatis-config.xml
#mybatis mapper文件的位置
mybatis.mapper-locations=classpath*:mapper/**/*.xml
#扫描pojo类的位置,在此处指明扫描实体类的包，在mapper中就可以不用写pojo类的全路径名了
mybatis.type-aliases-package=com.cuit

jdbc.type=mysql
spring.datasource.url=jdbc:mysql://localhost:3306/demo
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

可以通过mybatis.config-location属性来指定mybatis的配置文件的位置，简单起见这里使用默认配置就不用指定了，接下来分别在数据库中创建user表，并插入一些数据

分别创建pojo类和dao接口对应mapper文件

public class User{
    private String id;

    private String name;

    private String sex;

    private int age;

}

@Mapper//加上该注解才能使用@MapperScan扫描到
public interface UserDao {

    User getUserById(@Param("id") int id);

    int updateUser(@Param("user") User user);

    int insertUser(@Param("user") User user);

    int deleteUserById(@Param("id") int id);
}

对应的mapper文件：

<mapper namespace="com.cuit.springboot.dao.UserDao">

    <select id="getUserById" resultType="User">
        SELECT
              ID as id,
              NAME as name,
              SEX as sex,
              AGE as age
        FROM user
        WHERE ID = #{id}
    select>
    <update id="updateUser">
        UPDATE user
        SET NAME = #{user.name},
            SEX = #{user.sex},
            AGE = #{user.age}
        WHERE ID = #{user.id}
    update>
    <insert id="insertUser">
        INSERT INTO
            user(id, name, sex, age)
            VALUES (
                #{user.id},
                #{user.name},
                #{user.sex},
                #{user.age}
            )
    insert>
    <delete id="deleteUserById">
        DELETE user WHERE ID = #{id}
    delete>

mapper>

在启动类上加上@MapperScan注解,扫描指定包下的dao类：

@ComponentScan("com.cuit")
@MapperScan("com.cuit")
public class SpringBootApplicationStarter {
    ...
}

最后写个Controller方法用于测试：

@RestController
public class HelloController {

    @Autowired
    private UserDao userDao;

    @RequestMapping("/hello")
    public User hello(){
        User user = userDao.getUserById(1);
        System.out.println(user);
        return user;
    }

}

在浏览器中输入http://localhost:8080/hello 可以看到已经查到数据了，sprigboot与mybatis简单集成就完成了。

使用注解方式

当我们需要一个很简单的DML功能时，如果去创建mapper文件并编写一堆语句的时候也许会显得很麻烦，这个时候就可以通过注解的方式简化配置，新建一个UserAnnotationDao通过注解的方式来实现增删改查:

@Mapper
public interface UserAnnotationDao {

    @Select("SELECT * FROM user WHERE id = #{id}")
    @Results({
            @Result(property = "id", column = "id"),
            @Result(property = "name", column = "name"),
            @Result(property = "sex", column = "sex"),
            @Result(property = "age", column = "age")
    })
    User getUserById(int id);

    @Select("SELECT * FROM user")
    @Results({
            @Result(property = "id", column = "id"),
            @Result(property = "name", column = "name"),
            @Result(property = "sex", column = "sex"),
            @Result(property = "age", column = "age")
    })
    List<User> queryAll();

    @Update("UPDATE user SET NAME = #{user.name}, SEX = #{user.sex}, AGE = #{user.age} WHERE ID = #{user.id}")
    int updateUser(User user);

    @Insert("INSERT INTO user(id, name, sex, age) VALUES (#{user.id}, #{user.name}, #{user.sex}, #{user.age})")
    int insertUser(User user);

    @Delete("DELETE user WHERE ID = #{id}")
    int deleteUserById(int id);
}

使用注解自后就不需要mapper文件了，分别测试这几个方法均能正确执行，使用注解和使用xml的方式都差不多，通常情况下，如果没有复杂的连接查询，我们可以使用注解的方式，当设计到复杂的sql还是使用xml的方式更好掌控一些，所以通常情况下两种方式都会使用，根据sql的复杂程度选择不同的方式来提高开发效率。

mybatis generator工具的使用

在前言中说到，mybatis也发现了我们需要重复的去创建pojo类、mapper文件以及dao类并且需要配置它们之间的依赖关系可能会很麻烦，所以mybtis提供了一个mybatis generator工具来帮我们自动创建pojo类、mapper文件以及dao类并且会帮我们配置好它们的依赖关系，而我们只需要关系我们的业务逻辑直接使用就行了。
要使用mybatis generator工具需要在pom.xml文件中添加一个generator的maven工具：

 <build>
      <plugins>
           <plugin>
               <groupId>org.mybatis.generatorgroupId>
               <artifactId>mybatis-generator-maven-pluginartifactId>
               <version>1.3.2version>
               <executions>
                   <execution>
                       <id>Generate MyBatis Artifactsid>
                       <phase>deployphase>
                       <goals>
                           <goal>generategoal>
                       goals>
                   execution>
               executions>
               <configuration>
                   
                   <configurationFile>src/main/resources/mybatis-generator/generatorConfig.xmlconfigurationFile>
                   <verbose>trueverbose>
                   <overwrite>trueoverwrite>
               configuration>
               <dependencies>
                    <dependency>
                        <groupId>mysqlgroupId>
                        <artifactId>mysql-connector-javaartifactId>
                        <version>5.1.34version>
                    dependency>
                    <dependency>
                        <groupId>org.mybatis.generatorgroupId>
                        <artifactId>mybatis-generator-coreartifactId>
                        <version>1.3.2version>
                    dependency>
               dependencies>
           plugin>
           <plugin>
               <groupId>org.springframework.bootgroupId>
               <artifactId>spring-boot-maven-pluginartifactId>
               <configuration>
                   <classifier>execclassifier>
               configuration>
           plugin>
       plugins>
   build>

上面指定了mybatis generator工具配置文件的位置，在这个位置创建一个xml文件，并做如下配置：

<generatorConfiguration>
    
    
    <properties resource="mybatis-generator/mybatisGeneratorinit.properties"/>
    
    

    
    
    <context id="MysqlTables" targetRuntime="MyBatis3Simple" defaultModelType="flat">
        
        <property name="autoDelimitKeywords" value="true" />
        
        <property name="javaFileEncoding" value="utf-8" />
        
        <property name="beginningDelimiter" value="`" />
        <property name="endingDelimiter" value="`" />

        
        <property name="javaFormatter" value="org.mybatis.generator.api.dom.DefaultJavaFormatter"/>
        
        <property name="xmlFormatter" value="org.mybatis.generator.api.dom.DefaultXmlFormatter"/>
        <plugin type="org.mybatis.generator.plugins.SerializablePlugin" />

        <plugin type="org.mybatis.generator.plugins.ToStringPlugin" />

        
        <commentGenerator >
            <property name="suppressAllComments" value="false"/>
            <property name="suppressDate" value="true" /> 
        commentGenerator>

        
        <jdbcConnection driverClass="${jdbc_driver}" connectionURL="${jdbc_url}" userId="${jdbc_user}" password="${jdbc_password}" />
        
        <javaTypeResolver>
            
            <property name="forceBigDecimals" value="false"/>
        javaTypeResolver>

        
        <javaModelGenerator targetPackage="com.cuit.springboot.gentry" targetProject="${project}" >
            <property name="enableSubPackages" value="false"/>
            <property name="trimStrings" value="true"/>
        javaModelGenerator>
        
        <sqlMapGenerator targetPackage="mappers" targetProject="${resources}" >
            <property name="enableSubPackages" value="false" />
        sqlMapGenerator>
        
        <javaClientGenerator targetPackage="com.cuit.springboot.gdao" targetProject="${project}" type="XMLMAPPER" >
            <property name="enableSubPackages" value="false" />
        javaClientGenerator>
        
        <table tableName="user" enableCountByExample="true" enableUpdateByExample="true" enableDeleteByExample="true" enableSelectByExample="true" selectByExampleQueryId="true">
            <property name="useActualColumnNames" value="false" />
            
            <generatedKey column="id" sqlStatement="Mysql" identity="true" />
        table>
    context>
generatorConfiguration>

在同目录下创建mybatisGeneratorinit.properties文件：

#Mybatis Generator configuration
#dao类和实体类的位置
project =src/main/java
#mapper文件的位置
resources=src/main/resources
#根据数据库中的表生成对应的pojo类、dao、mapper
jdbc_driver =com.mysql.jdbc.Driver
jdbc_url=jdbc:mysql://localhost:3306/demo
jdbc_user=root
jdbc_password=123456

到此，整个配置就完成了，既然该工具的作用是将数据库中的表生成对应的实体、dao类和mapper文件，那么首先需要建立数据库表，当数据库表建立好后在pom.xml文件所在的目录执行如下命令：

mvn mybatis-generator:generate

然后就可以看到在指定目录下已经生成了对应的文件，关于mybatis generator的更多详细的配置可以参考这篇文章：Mybatis Generator最完整配置详解