mybatis使用（简单易上手）

一、mybatis介绍

1、mybatis是什么

MyBatis是一个开源的Java持久层框架，它通过简单的XML或注解配置，实现了对关系数据库的操作。MyBatis优点在于它可以自定义SQL语句，将程序代码与SQL语句分离，避免了在Java代码中写SQL语句的不便和繁琐，同时还能提供动态SQL的支持。

2、mybatis支持的数据库

MyBatis支持的数据库包括MySQL、Oracle、DB2、SQLServer、Sybase、PostgreSQL、H2等常见的关系型数据库，它提供了丰富的映射标签和查询标签，可以使开发人员使用MyBatis进行各种复杂的SQL操作。

3、mybatis插件机制

这一部分可直接跳过

MyBatis还提供了插件的扩展机制，可以通过插件来增强MyBatis的功能，比如实现分页查询、记录SQL语句执行时间等。
MyBatis的插件机制基于拦截器模式，开发人员可以通过实现Interceptor接口来创建自定义插件，并在MyBatis的配置文件中配置插件。
插件的核心是实现拦截器接口中的intercept方法。该方法接收一个Invocation对象作为参数，Invocation对象封装了要执行的SQL语句以及执行该语句的对象。通过拦截器可以对该SQL语句进行修改，或者在执行前后执行一些其他逻辑。
下面是一个简单的插件实现示例：

@Intercepts({
    @Signature(type = Executor.class, method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class})
})
public class ExamplePlugin implements Interceptor {

    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        // 获取原始的参数
        Object[] args = invocation.getArgs();
        // 执行原始的SQL语句
        Object result = invocation.proceed();
        // 对查询结果进行加工
        return result;
    }

    @Override
    public Object plugin(Object target) {
        // 使用MyBatis提供的Plugin.wrap方法来生成代理对象
        return Plugin.wrap(target, this);
    }

    @Override
    public void setProperties(Properties properties) {
        // 可以在这里读取配置文件中的参数
    }

}

在配置文件中配置插件非常简单，只需要将插件类的全限定名添加到标签中即可：

<configuration>
  <plugins>
    <plugin interceptor="com.example.ExamplePlugin">
      <!-- 配置插件需要的参数 -->
    </plugin>
  </plugins>
</configuration>

需要注意的是，插件的拦截器类型和方法需要和被拦截的对象对应。比如上面的示例中，@Signature注解中指定的是Executor类的query方法，那么该插件就只能拦截Executor对象的query方法。

二、springboot集成mybatis

springboot集成mybatis的过程很简单，如下简单的几步。

1、引入依赖

直接将下面的依赖引入springboot的pom文件中：

<!-- https://mvnrepository.com/artifact/org.mybatis.spring.boot/mybatis-spring-boot-starter -->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>3.0.1</version>
        </dependency>

注意我这个mybatis版本为3.0.1,如果需要选择合适自己的版本可以点击链接跳转选择合适版本，点击跳转
然后点击相应的版本，选择maven，复制依赖粘贴到pom文件即可。

2、配置mybatis

加入依赖之后需要在配置文件中配置数据源和mybatis，在yaml文件或者properties文件中添加如下模板：

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver  #mysql8的驱动
    url: jdbc:mysql://localhost:3306/database?useUnicode=true&characterEncoding=UTF-8&allowPublicKeyRetrieval=true&useSSL=false
    username: root
    password: root
  mybatis:
    mapper-locations: classpath:mapper/*.xml

然后需要在启动类添加一个注解@MapperScan("com.example.mapper")

@SpringBootApplication
@MapperScan(basePackages = "com.example.mapper")
public class GdFApplication {

    public static void main(String[] args) {
        SpringApplication.run(GdFApplication.class, args);
    }

}

到此基本的配置已经完成。

三、使用mybatis

对于在springboot中使用mybatis有以下几种方式：

• 注解方式：使用MyBatis提供的注解（如@Select、@Insert等）在Mapper接口中定义SQL语句，Spring Boot会自动扫描Mapper接口并注入实现类。

• XML方式：在MyBatis的XML文件中编写SQL语句，通过在Mapper接口中定义方法名和参数映射XML文件中的SQL语句。

• 注解和XML方式混合使用：可以在Mapper接口中同时使用注解和XML方式定义SQL语句，但需要注意方法名不能重复。

对于我个人来说，我是比较喜欢使用注解方式使用mybatis的，这里两种方式都简单的说一下吧。

1、注解方式使用mybatis

定义Mapper接口并使用注解定义SQL语句：

@Mapper
public interface UserMapper {
    @Select("SELECT * FROM user WHERE id=#{id}")
    User findById(Long id);

    @Insert("INSERT INTO user(name, age) VALUES(#{name}, #{age})")
    int insert(User user);

    @Update("UPDATE user SET name=#{name}, age=#{age} WHERE id=#{id}")
    int update(User user);

    @Delete("DELETE FROM user WHERE id=#{id}")
    int delete(Long id);
}

在应用程序中使用Mapper接口：

@Service
public class UserService {
  @Autowired
  private UserMapper userMapper;

  public User findById(Long id) {
    return userMapper.findById(id);
  }

  public int insert(User user) {
    return userMapper.insert(user);
  }

  public int update(User user) {
    return userMapper.update(user);
  }

  public int delete(Long id) {
    return userMapper.delete(id);
  }
}

• 以上就是在Spring Boot中使用注解方式使用MyBatis的基本步骤。
• 需要注意的是，在Mapper接口上需要添加@Mapper注解，以便Spring Boot能够扫描并注入Mapper接口的实现。
• 同时，需要在配置文件中指定mapper-locations属性，MyBatis会自动扫描指定路径下的Mapper接口。
• 另外，MyBatis还提供了其他注解，如@Results、@ResultMap、@Options等，可以用来定制查询结果的映射方式、设置自增主键等。

2、XML文件方式

这里推荐使用IDEA中的一款插件better-mybatis-generator，使用步骤如下：

1. 首先在IDEA插件中心下载better-mybatis-generator插件，如下图所示：
   
   注意下载后启用该插件。

2. 然后在IDEA的database中配置数据库，如下图所示
   
   按上图步骤点击MySQL之后，按下图所示操作：
   
   注意在点击Test Connection弹出success提示后再点击apply和OK。

3. 之后在打开IDEA的database，按下图所示操作
   
   前提是你选中的数据库中已有数据表，然后鼠标右键该表，在弹出的内容中，选择mabatis-generate。然后进入下一步。
   这里咱也不知道问什么mybatis-generator插件怎么变成了mabatis-generate了。

4. 在上一步之后进入了Toos页，配置生成的实体类的包、mapper的包和xml的包，如下图所示：
   
   在根据自己的需要之后，就可以点击ok进行代码生成，生成前可能会弹出输入数据库的账号密码，输入即可。
   注意：如果输入账号密码后出现Failed to connect…则检查一下配置的数据库中的url是否有时区设置，如下图所示。

若没有，则加上?serverTimezone=GMT&useSSL=false

之后重新按照以上步骤生成代码即可，生成成功的代码如下所示。