浅学MybatisDay01

MYBATIS

关于Mybatis框架

Mybatis框架解决了数据库编程相关的问题，主要是简化了数据库编程。

当使用Mybatis框架实现数据库编程时，只需要：

• 定义数据操作功能的抽象方法（此抽象方法必须在接口中）
• 配置以上抽象方法映射的SQL语句

Mybatis框架在实现过程中，会自动生成各接口的代理对象，所以，开发人员并不需要关注接口的实现问题。

使用Mybatis框架

在Spring Boot项目中，当需要使用Mybatis框架实现数据库编程时，需要添加：

• mybatis-spring-boot-starter
• 数据库的依赖，例如mysql-connector-java

所以，在pom.xml中添加：

<dependency>
    <groupId>org.mybatis.spring.bootgroupId>
    <artifactId>mybatis-spring-boot-starterartifactId>
    <version>2.2.2version>
dependency>

<dependency>
    <groupId>mysqlgroupId>
    <artifactId>mysql-connector-javaartifactId>
    <scope>runtimescope>
dependency>

由于添加以上依赖后，Spring Boot在启动时就会读取连接数据库的配置信息，如果未配置，则启动报错且失败，
需要在src/main/resources下的application.properties中添加必要的配置：

spring.datasource.url=jdbc:mysql://localhost:8888

提示：以上配置中，属性名称是固定，以上示例值是错误值，但是，启动Spring Boot只是加载以上配置，并不会执行连接，所以，配置值错误并不影响启动项目。

连接数据库的配置

在Spring Boot项目中，src/main/resources下的application.properties是默认的配置文件，项目在启动时，Spring Boot会自动从此文件中读取相关的配置信息。

在许多配置过程中，需要在application.properties中的配置的属性的名称是固定的！

在配置数据库的连接信息时，至少需要配置spring.datasource.url、spring.datasource.username、spring.datasource.password这3个属性，分别表示连接数据库的URL、登录数据库的用户名、登录数据库的密码

spring.datasource.url=jdbc:mysql://localhost:3306/xxx?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai

spring.datasource.username=root

spring.datasource.password=root

为了检验配置值是否正确，可以在src/test/java下默认的包下创建DatabaseConnectionTests测试类，在测试类中编写测试方法，以尝试连接数据库，即可检验：

package cn.tedu.csmall.server;

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

import javax.sql.DataSource;

// 测试类必须：
// 1. 在组件扫描的包下（默认的包及其子孙包）
// 2. 只有添加了@SpringBootTest注解才会加载整个项目的运行环境（包括Spring、读取配置等）
@SpringBootTest
public class DatabaseConnectionTests {

    // Spring Boot自动读取application.properties的配置，并创建了数据源对象
    @Autowired
    DataSource dataSource;

    // 连接数据库，可用于检查application.properties中的连接参数值是否正确
    @Test
    public void testConnection() throws Exception {
        // 获取与MySQL的连接，此方法的调用会实质的连接数据库
        dataSource.getConnection();
        System.out.println("当你看到这句话时，表示在application.properties中的数据库连接参数的值是正确的");
    }

}

关于设计数据表

关于id

阿里巴巴的建议是：每张表都应该有id字段，且是bigint unsigned类型，其中，bigint对应Java中的long类型，unsigned表示“无符号位”，
将使得此字段值不会出现负数，且取值区间是原正数的2倍……以tinyint为例，没有添加unsigned时，取值区间是[-128, 127]，
添加unsigned以后，取值区间是[0, 255]。

当把id的类型设置为bigint时，理论上id值足够使用，即使不添加unsigned也不会出现id值不够用的情况，但仍推荐添加，其目的是为了表现语义。

关于编码

应该在创建表时指定编码，创建库时可以不指定编码。

在MySQL / MariaDB强烈推荐使用utf8mb4。most byte 4 默认mb3

关于字符串的字段类型

如果某个字符串类型的字段的值的长度变化可能较大，应该使用varchar类型，例如用户名，如果某个字符串类型的字段的值的长度变化不大，应该使用char类型。

注意：某些数据可能是纯数字的，但并不具备算术运算含义，也应该使用字符串类型，不要使用数值类型。

在使用varchar时，指定的长度一定是“大于必要长度”的标准，例如，现行的标准是“用户名最多15个字符”，则建议设计为varchar(25)或比25更大的值，但是，也不要过于夸张，避免影响语义。

使用Mybatis时定义的抽象方法

使用Mybatis时，定义的抽象方法都必须在接口中，通常，接口会使用Mapper作为名称的最后一个单词，例如命令为BrandMapper等。

关于抽象方法的声明原则：

• 返回值类型：如果需要执行的SQL是增、删、改类型的，统一使用int作为返回值类型，表示“受影响的行数”，
  其实也可以使用void，但并不推荐，如果需要执行的SQL是查询类型的，如果查询最多只返回1个结果，
  则只需要保证返回值类型可以装得下所需的查询结果即可，如果查询返回的结果可能超过1条，则必须使用List集合进行封装，
  且集合的元素类型依然只需要保证可以装得下所需的查询结果即可
• 方法名称：自定义
  • 获取单个对象的方法用 get 做前缀
  • 获取多个对象的方法用 list 做前缀
  • 获取统计值的方法用 count 做前缀
  • 插入的方法用 save/insert 做前缀
  • 删除的方法用 remove/delete 做前缀
  • 修改的方法用 update 做前缀
• 参数列表：如果需要执行的SQL语句中的参数数量较多，推荐将多个参数封装到自定义类中

关于@Mapper和@MapperScan

Mybatis框架只要求开发人员编写接口和抽象方法，不需要开发人员编写实现类，是因为Mybatis会通过代理模式自动生成接口的实现对象，但是，它需要明确哪些接口是需要生成代理对象的。

可以在各接口上添加@Mapper注解，在启动项目时，Mybatis会对整个项目进行扫描，对于已经添加此注解的接口，就会生成代理对象。

也可以在配置类上添加@MapperScan注解，用于指定各接口所在的包，则Mybatis会扫描此包及其子孙包下的所有接口，并生成这些接口的代理对象。

关于@Mapper和@MapperScan这2种注解，只需要选择其中1种使用即可，通常推荐@MapperScan。

注意：使用@MapperScan时，一定只指向Mapper接口所在的包，并确保此包下无其它接口！

提示：Mybatis框架的@MapperScan，与Spring框架的@ComponentScan没有任何关系，且不会互相影响！