2024-11-26-Tue-T-SSM

SSM

SSM三者的关系

1 Spring IoC容器

父子工程

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.learning.springmvc</groupId>
    <artifactId>ssm</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!--父工程定义了版本, 子模块不需要再定义版本-->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.4.0</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <!--父项目-->
    <!--父项目一般不写代码-->
    <!--适用场景：
        1. 组织和管理多个子模块的公共配置（如依赖、插件、构建配置）。
        2. 聚合子模块，使它们可以通过 mvn install 或 mvn package 一次性构建所有子模块。
        3. 父项目自身没有具体的功能实现，仅作为管理和继承的基础。-->

    <!--通常情况下，父项目的打包方式是 pom，这是最佳实践-->
    <!--当父项目的打包方式为 pom 时，父项目本身不会生成实际的可部署包（如 jar 或 war），而仅作为一个配置聚合的容器-->
    <packaging>pom</packaging>
    <modules>
        <module>ssm-spring-ioc</module>
    </modules>

    <!--当父工程要统一管理依赖时, 使用<dependencyManagement>进行管理, 子模块引用时, 不用再指定版本-->
    <!--<dependencyManagement>
        <dependencies>
            <dependency>
                <groupId></groupId>
                <artifactId></artifactId>
            </dependency>
        </dependencies>
    </dependencyManagement>-->

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

</project>

1.1 组件到容器

注册组件的方式:

1. 使用@Import注解标识启动类

@Import({Dog.class, Person.class})
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        //1. 跑起一个Spring的应用, 获取一个ApplicationContext, 即ioc容器
        ConfigurableApplicationContext ioc = SpringApplication.run(Application.class, args);
    }

2. 使用@Bean注解标识配置类方法

@Configuration
public class DogConfig {
    @Bean
    public Dog dog() {
        return new Dog();
    }
}

1.2 @Scope调整组件的作用域

四个作用域:

1. singleton: 默认值, 单例模式, 容器启动时创建对象, 并且只会创建一个实例, 无论调用多少次getBean方法, 都会返回同一个对象
2. prototype: 多例模式, 每次调用getBean方法, 都会创建一个新的对象
3. request: 同一个请求创建一个单实例
4. session: 同一个会话创建一个单实例

   @Configuration
   public class PersonConfig {
   
       @Scope("prototype")
       @Bean
       public Person person(){
           return new Person();
       }
   }

1.3 @Lazy懒加载

1. 默认情况下, 容器启动时, 会创建所有的单实例对象
2. @Lazy注解, 容器启动时不创建对象, 而是调用getBean方法时才创建对象
3. @Lazy注解, 只对单实例有效, 多实例无效

@Configuration
public class PersonConfig {
    @Lazy
    @Bean
    public Person person(){
        return new Person();
    }
}

1.4 FactoryBean

FactoryBean, 用于创建复杂对象, 并且返回对象, 而不是直接返回对象

@Component
public class BYD implements FactoryBean<Car>{

    /**
     * Spring调用此方法给ioc容器创建对象
     * @return
     * @throws Exception
     */
    @Override
    public Car getObject() throws Exception {
        Car car = new Car();
        return car;
    }

    @Override
    public Class<?> getObjectType() {
        return Car.class;
    }

    @Override
    public boolean isSingleton() {
        return FactoryBean.super.isSingleton();
    }
}

1.5 @Conditional条件注册

@Conditional注解, 用于判断条件是否成立, 如果成立, 则执行对应的配置
@Conditional使用范围:

• @Bean注解标注的方法上
• @Configuration注解标注的类上

场景:
判断当前电脑系统是否是windows系统还是Mac, 如果是windows, 则创建一个windowsMouse, 否则创建一个macMouse

1. 定义一个Mouse类

   @Data
   public class Mouse {
       private int id;
       private String name;
   
       public Mouse(int id, String name) {
           this.id = id;
           this.name = name;
       }
   }

2. 定义两个条件类, 实现Spring context的Condition接口

   public class WindowEnvCondition implements Condition {
       @Override
       public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
           String osEnv = context.getEnvironment().getProperty("OS");
           System.out.println(osEnv);
           if ("Windows".equals(osEnv)) {
               return true;
           }
           //返回true标识条件匹配
           return false;
       }
   }

   public class MacEnvCondition implements Condition {
       @Override
       public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
           String osEnv = context.getEnvironment().getProperty("OS");
           System.out.println(osEnv);
           if ("Mac".equals(osEnv)) {
               return true;
           }
           //返回true标识条件匹配
           return false;
       }
   }

3. 在配置类中, 使用@Conditional注解, 指定条件类, 如果条件成立, 则创建对应的Mouse对象

@Configuration
public class MouseConfig {

    @Bean("macMouse")
    @Conditional({MacEnvCondition.class})
    public Mouse macMouse() {
        return new Mouse(1,"mac's mouse");
    }

    @Bean("windowsMouse")
    @Conditional({WindowEnvCondition.class})
    public Mouse windowMouse() {
        return new Mouse(2,"window's mouse");
    }


}

4. 测试

   @SpringBootApplication
   public class Application {
       public static void main(String[] args) {
           //1. 跑起一个Spring的应用, 获取一个ApplicationContext, 即ioc容器
           ConfigurableApplicationContext ioc = SpringApplication.run(Application.class, args);
           System.out.println("=============================");
           System.out.println(ioc.getBean(Mouse.class));
       }
   }

Spring中也实现了一些条件类, 如:
@ConditionalOnBean(name = “”)
@ConditionalOnMissingBean(name = “”)
@ConditionalOnClass(name = “”)等等

1.6 注入

1. @Autowired注解: 依赖注入, 根据类型自动注入
2. @Qualifier注解: 依赖注入, 根据名称自动注入, 配合@Autowired注解使用
3. @Resource注解: 依赖注入, 根据名称自动注入, 不属于Spring官方注解
4. @Value注解: 注入普通值
   1. @Value(“hello”): 注入普通值
   2. @Value(“${name}”): 注入配置文件中的值
   3. @Value(“#{SpEL}”): 注入SpEL表达式, 可以结合2使用 @Value("#{'${app.name}'.toUpperCase()}")
5. @Profile注解: 根据环境变量, 注入不同的配置, 比如开发环境: @Profile(“dev”), 对应的配置文件中的内容为: spring.profiles.active=dev
6. @PropertiesSource注解: 注入配置文件, 不使用此注解的默认配置文件是application.properties
7. @Primary注解: 默认注入的组件, 如果有多个同类型的组件, 则会报错, 需要使用@Primary注解指定一个默认的组件

1.7 组件生命周期

1. @Bean注解标注的方法, 在Bean初始化完成后调用

2. InitializingBean: 在Bean初始化完成后调用

3. DisposableBean: 在Bean销毁前调用

4. @PostConstruct: 在Bean初始化完成后调用, 可以在构造方法之后调用

5. @PreDestroy: 在Bean销毁前调用

6. BeanPostProcessor: 在Bean初始化前后调用, 可以在Bean初始化前后进行操作(很强大, 可以修改Bean的任何内容)

7. @Bean注解标注的方法, 在Bean初始化完成后调用

   //定义一个User类
   @Data
   public class User {
       private String name;
       private int age;
   
       public void initMethod() {
           System.out.println("User initMethod ......");
       }
   
       public void destroyMethod() {
           System.out.println("User destroyMethod ......");
       }
   }

   //定义一个UserConfig类
   @Configuration
   public class UserConfig {
   
       @Bean(initMethod = "initMethod", destroyMethod = "destroyMethod")
       public User user() {
           User user = new User();
           user.setName("tom");
           user.setAge(18);
           return user;
   
       }
   }

   测试

   @SpringBootApplication
   public class Application {
       public static void main(String[] args) {
           ConfigurableApplicationContext ioc = SpringApplication.run(Application.class, args);
           System.out.println(ioc.getBean(User.class));
       }
   }

   结果

   User initMethod ......
   User(name=tom, age=18)
   User destroyMethod ......

8. InitializingBean: 在Bean初始化前调用

9. DisposableBean: 在Bean销毁前调用

   @Data
   public class User implements InitializingBean, DisposableBean {
       
       //在Bean销毁前调用
       @Override
       public void destroy() throws Exception {
           System.out.println("[DisposableBean] ======= User destroy");
       }
   
       //在属性设置之后调用
       @Override
       public void afterPropertiesSet() throws Exception {
           System.out.println("[initialization]======User afterPropertiesSet ......");
       }
   }

10. @PostConstruct: 在构造方法之后调用

11. @PreDestroy: 在Bean销毁前调用

//User类中
    @PreDestroy
    public void preDestroy() {
        System.out.println("[preDestroy]======User preDestroy");
    }

    @PostConstruct
    public void postConstruct() {
        System.out.println("[postConstruct]======User postConstruct");
    }

6. BeanPostProcessor: 后置处理器, 需要编写继承类并注解@Component

package com.learning.ssm.spring.ioc.processor;

import com.learning.ssm.spring.ioc.bean.User;
import org.springframework.beans.BeansException;
import org.springframework.beans.factory.config.BeanPostProcessor;
import org.springframework.stereotype.Component;

/**
 * Author fei
 * Version 1.0
 * Description TODO
 * DATA 2024/11/26  21:04
 */
@Component
public class MyBeanPostProcessor implements BeanPostProcessor {
    @Override
    public Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException {
        if(!(bean instanceof User)){
            return bean;
        }
        System.out.println("初始化后置处理器=================  " + beanName);
        return BeanPostProcessor.super.postProcessAfterInitialization(bean, beanName);
    }

    @Override
    public Object postProcessBeforeInitialization(Object bean, String beanName) throws BeansException {
        if(!(bean instanceof User)){
            return bean;
        }
        System.out.println("初始化前置处理器==================   " + beanName);
        return BeanPostProcessor.super.postProcessBeforeInitialization(bean, beanName);
    }
}

2. 单元测试

3. Spring AOP

1. 添加aop依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>

@Component
@Aspect
public class LogAspect {

    @Pointcut("execution(public * com.learning.ssm.ssmspringaop.calculator.MathCalculator.*(..))")
    public void pointCut(){}
    
    @Before("execution(public * com.learning.ssm.ssmspringaop.calculator.MathCalculator.add(int, *))")
    public void aspectBefore(JoinPoint joinPoint) throws Throwable {
        System.out.println(joinPoint.getSignature().getDeclaringTypeName() + "====.====" + joinPoint.getSignature().getName());
        System.out.println("before ..... ");
    }

    @After("pointCut()")
    public void aspectAfter() throws Throwable {
        System.out.println("after ..... ");
    }
}

切入点表达式

3.1 切入点执行顺序

通过@Order注解指定执行顺序
数字越小, 优先级越高

@Component
@Aspect
@Order(1) // 
public class LogAspect {

    @Before("execution(public * com.learning.ssm.ssmspringaop.calculator.MathCalculator.add(int, *))")
    public void aspectBefore(JoinPoint joinPoint) throws Throwable {
        System.out.println(joinPoint.getSignature().getDeclaringTypeName() + "====.====" + joinPoint.getSignature().getName());
        System.out.println("before ..... ");
    }
}

3.2 环绕通知

@Aspect
@Component
public class AroundAspect {

    @Around("execution(public int com.learning..calculator.*.add(int,int))")
    public Object around(ProceedingJoinPoint joinPoint) throws Throwable {
        System.out.println("[环绕] ----- 前置通知");
        Object result = null;

        try {
            result = joinPoint.proceed();
            System.out.println("[环绕] ----- 返回通知");
            
        }catch (Throwable throwable){
            System.out.println("[环绕] --- 异常通知");
        }finally {
            System.out.println("[环绕] ----- 后置通知");
        }
        return result;
    }
}

4. Spring 声明式事务

通过注解等方式配置事务管理器

@SpringBootApplication
@EnableTransactionManagement //开启基于事务的自动化事务管理
public class TxApplication {

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

}

@Transactional // 对方法进行事务管理    
@Override
public void checkout(String username, Integer bookId, Integer buyBum) {
    //1. 查询书本信息
    Book bookById = bookDao.getBookById(bookId);

    // 1.1 计算扣减额度
    BigDecimal multiply = new BigDecimal(buyBum).multiply(bookById.getPrice());

    //2. 修改账户金额
    accountDao.updateBalanceByUsername(username,multiply);

    //3. 修改库存
    bookDao.updateBookStock(bookId,buyBum);
}

4.1 隔离级别

• 读未提交: 事务可以读取其他事务未被提交到数据, 易产生脏读和幻读等问题
• 读已提交: 事务只能读取到其他事务已经提交的数据, 不能读取到未提交的数据, 读取期间可以修改添加
• 可重复读: 事务可以读取到其他事务已经提交的数据, 且读取期间不能修改, 可以添加
• 串行化: 事务只能读取到其他事务已经提交的数据, 且读取期间不能修改, 不能添加

前三种隔离级别导致的问题：

• 脏读：读取到未提交的数据。
• 不可重复读：两次读取同一数据，结果不一致（数据被修改）。
• 幻读：两次读取同样条件的记录，结果集条数发生变化（记录被插入或删除）。

4.2 事务的传播行为

事务的传播行为，即一个事务方法被另一个事务方法调用时，该调用事务方法的事务行为。

• REQUIRED(默认): 如果当前没有事务，就新建一个事务，如果已经存在一个事务中，加入到这个事务中，这是最常见的选择。 (常用)
• SUPPORTS: 支持当前事务，如果当前没有事务，就以非事务方式执行。
• MANDATORY: 必须存在事务，如果当前没有事务，就抛出异常。
• REQUIRES_NEW: 无论是否有事务, 都新建一个事务。 (常用)
• NOT_SUPPORTED: 以非事务方式执行，如果当前存在事务，就把当前事务挂起。
• NEVER: 以非事务方式执行，如果当前存在事务，则抛出异常。 (常用)
• NESTED: 新建事务，如果当前存在事务，则把当前事务挂起。

子事务会继承父事务的隔离级别，以及除了传播行为的外的其他属性。

5. SpringMVC

Web应用的核心就是处理HTTP请求和HTTP响应。

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-web</artifactId>
</dependency>

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-tomcat</artifactId>
	<scope>provided</scope>
</dependency>

如果是前后分离的开发方式, 对于Controller, 统一使用@RestController注解

/**
 * consumes代表服务器接收的数据类型
 * 
 */
@RequestMapping(value = "/consume", consumes = "application/json")
public String consume(){
    return "hello world! --- Consume";
}
// produces代表服务器返回的数据类型
@RequestMapping(value = "/produce", produces = "application/json")
public String produce(){
    return "hello world! --- Produce";
}

@RequestMapping(value = "/html", produces = "text/html;charset=UTF-8")
public String html(){
    return "<h1>这是HTML页面内容</h1>";
}

5.1 HTTP请求与响应

HTTP请求会携带各种数据:

1. 请求首行: (请求方式、请求路径、 请求协议)
2. 请求头: 键值对信息 K:V (请求头信息、请求参数、Cookie、Session等)
3. 请求体: 特定格式的请求数据

而响应会携带响应头和响应体。

5.2 三种请求的处理

1. 普通参数请求

// localhost:8080/user/pojo?name=zhangsan&age=18
@RequestMapping(value = "/pojo")
public String pojo(User user){
    System.out.println(user);
    return "hello world! --- File";
}

2. Json参数请求

@RequestMapping(value = "/pojoJson")
public String pojoJson(@RequestBody Person person){
    System.out.println(person);
    return "hello world! --- File";
}

2. 文件请求

@RequestMapping(value = "/file")
public String file(MultipartFile file) throws IOException {
    System.out.println(file.getOriginalFilename());

    file.transferTo(new File( file.getOriginalFilename()));

    return "hello world! --- File";
}

server:
  port: 8081  # 配置端口号
  tomcat:
    basedir: your directory # 配置Tomcat的basedir属性，指定Tomcat的根目录。  

spring:
  servlet:
    multipart:
      max-file-size: 100MB # 设置上传文件的最大大小
      max-request-size: 200MB # 设置上传请求的总大小
      resolve-lazily: true # 设置是否立即解析请求参数，默认为false，即在请求参数解析之前就进行文件上传
      location: /tmp # 设置上传文件的临时目录
      file-size-threshold: 10KB # 设置上传文件的大小阈值，超过该值则使用临时文件存储，默认为0，即不启用
      enabled: true # 设置是否启用文件上传功能，默认为true

5.3 两种返回数据格式

1. 返回JSON数据

@RequestMapping(value = "/person")
public Person person(){
    Person person = new Person();
    person.setName("zhangsan");
    person.setAge(18);
    person.setAddress(new String[]{"China","Japan"});
    return person;
}

2. 下载文件
   因为是文件，需要设置响应头，告诉浏览器下载文件. 所以既要修改响应头,还需要修改响应体
   Spring框架因此提供了ResponseEntity对象，用来封装响应头和响应体, 多用于文件的下载操作

@RequestMapping(value = "/download")
public ResponseEntity<InputStreamResource> download(String fileName) throws IOException {
    FileInputStream fileInputStream = new FileInputStream("/Users/fei/JavaCode/Java_basic/ssm/springmvc-01-helloworld/src/main/resources/static/dev.yaml");

    // 1. 解决文件名中文乱码
    String encode = URLEncoder.encode("中文dev.yaml", StandardCharsets.UTF_8);

    // 2. 解决文件内容过大(文件太大,如果读取byte[]结束再传输会导致oom内存溢出)
    InputStreamResource inputStreamResource = new InputStreamResource(fileInputStream);

    return ResponseEntity
            .ok()
            .header("Content-Disposition","attachment;filename=" + encode)
            .contentType(MediaType.APPLICATION_OCTET_STREAM)
            .contentLength(fileInputStream.available()) // 内容大小
            .body(inputStreamResource);
}

5.4 RestFul

调用别人的功能的方式:

1. API: 给第三方发送请求, 获取响应数据
2. SDK: 导入jar包

5.5 后端允许前端跨域

原理: 服务器给浏览器的响应头中添加字段, Access-Control-Allow-Origin: *
跨域访问过程:

1. 浏览器发送OPTIONS预检请求–> 请求到服务器
2. 服务器返回响应头Access-Control-Allow-Origin: *
3. 浏览器收到响应头后, 允许跨域访问, 发送真正的请求

@CrossOrigin // 默认允许所有源跨域访问, value 指定允许的源, 例如 "http://localhost:80"
@RequestMapping(value = "/person")
public Person person(){
    Person person = new Person();
}

5.4 @PathVariable 路径变量

1. /resource/{id}: {}中的值封装到id变量中
   1. /resource/1
2. /resource/{*path}: {}中的值封装到path变量中, {}中可以是多重路径
   1. /resource/a.png
   2. /resource/a/b/c.png
3. /resource/{filename:\\w+}.png: {}中的值封装到filename变量中, 正则表达式匹配
   1. /resource/a.png
   2. /resource/a_b.png

@RequestMapping(value = "/resource/{id}")
public String resource(@PathVariable("id") Integer id){
    return "hello world! --- Resource";
}

5.5 拦截器

过滤器（Filter）：它的作用范围更广，通常用于处理整个请求和响应流。它不仅可以作用于 Spring MVC 的请求，也可以处理其他非 Spring 的请求（例如：静态资源、外部 API 请求等）。因此，如果你的需求是对整个应用层面的请求进行处理，应该选择过滤器。

拦截器（Interceptor）：拦截器是 Spring MVC 专用的，主要用于控制器方法的调用过程。如果你只需要在控制器级别进行操作（例如：权限校验、日志记录、方法执行的前后处理），那么拦截器更加合适。

一般情况, 只要使用Spring, 优先使用拦截器。

1. 创建拦截器

   @Component
   public class MyInterceptor implements HandlerInterceptor {
   
       @Override
       public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
           System.out.println("preHandle.......");
           return HandlerInterceptor.super.preHandle(request, response, handler);
       }
   
       @Override
       public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
           System.out.println("postHandle.......");
           HandlerInterceptor.super.postHandle(request, response, handler, modelAndView);
       }
   }

2. 配置拦截器

@Configuration
public class MyMVCConfig implements WebMvcConfigurer {

    @Autowired
    MyInterceptor myInterceptor;
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(myInterceptor)
                .addPathPatterns("/interceptor"); //拦截interceptor请求
    }
}

5.6 异常处理

两种异常处理方式:

1. 编程式异常处理: try-catch、throw exception
2. 声明式异常处理: @ControllerAdvice + @ExceptionHandler

测试

@RestControllerAdvice
public class GlobalExceptionController { // 此类一般放到advice中

    @ExceptionHandler(ArithmeticException.class)
    public R arithmeticError(ArithmeticException e) {
        System.out.println(e.getMessage());
        return R.error(e, "算数异常" + e.getMessage());
    }
}

5.7 数据校验

后端的简单数据校验可以使用JSR303规范, JSR303是java为Bean数据合法性提供的标准框架, 它已经包含在JavaEE6标准中.
JSR303通过Bean属性上标注类似于@NotBlank/@NotNull/@Size/@Min/@Max/@Pattern等注解, 来声明属性的合法性.

校验流程:

1. 引入校验依赖: spring-boot-starter-validation
2. 定义封装的数据Bean
3. 给Bean的字段添加校验注解, 并指定校验错误的消息提示
4. 在Controller上添加@Valid注解,@Validated 激活校验
5. 编写一个全局异常处理器, 拦截MethodArgumentNotValidException异常, 返回校验失败的错误信息
6. 使用自定义校验注解 + 校验器(implements ConstraintValidator)完成自定义校验
7. 结合校验注解message属性于i18n文件, 实现错误消息国际化

编写校验规则

@Data
public class User {

    @NotNull(message = "id 不能为空")
    private Integer id;

    @NotNull(message = "名字不能为空")
    private String name;

    @NotBlank(message = "密码不能为空")
    private String password;
}

激活校验

@RequestMapping("/validateGlobalException")
public R VE(@RequestBody @Validated User user) {
    return R.ok(user);
}

校验失败的异常处理

@ExceptionHandler(MethodArgumentNotValidException.class)
public R methodArgumentNotValidException(MethodArgumentNotValidException e){

    Map<String,String> errorsMap = new HashMap<>();
    e.getBindingResult().getFieldErrors().forEach(fieldError -> {
        //获取属性名
        String field = fieldError.getField();
        //获取校验失败后的错误消息
        String message = fieldError.getDefaultMessage();
        errorsMap.put(field,message);
    });
    return R.error( 400, "校验失败" ,errorsMap);
}

使用正则表达式

@Pattern(regexp = "^男|女$", message = "性别只能为: “男” 或 “女” ")
@NotBlank
private String gender;

自定义校验

1. 定义自定义验证器

public class GenderValidator implements ConstraintValidator<Gender, String> {

    /**
     *
     * @param s 用户侧提交的还未校验的属性值
     * @param constraintValidatorContext 校验上下文
     * @return
     */
    @Override
    public boolean isValid(String s, ConstraintValidatorContext constraintValidatorContext) {
        return "male".equals(s) || "female".equals(s);
    }
}

2. 定义校验注解

@Documented
@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = {GenderValidator.class}) // 校验器完成真正的校验功能
public @interface Gender {
    String message() default "{validator.gender}";

    Class<?>[] groups() default {};

    Class<? extends Payload>[] payload() default {};


}

3. 定义国际化文件

   # messages.properties
   validator.gender=只能为男性或女性
   
   # messages_en_US.properties
   validator.gender=only can be male or female!
   
   # messages_zh_CN.properties
   validator.gender=只能为男性或女性

4. 测试-Controller

   @RequestMapping("/validateGlobalException")
   public R VE(@RequestBody @Validated User user) {
       return R.ok(user);
   }

5. 测试-Postman

   curl --location --request GET 'http://localhost:8080/validateGlobalException' \
   --header 'Accept-Language: en-US' \
   --header 'Content-Type: application/json' \
   --data '{
       "name": "jack",
       "id": 32,
       "password": "",
       "gender": "mafle"
   
   }'

6. 结果

   {
       "code": 400,
       "msg": "校验失败",
       "data": {
           "password": "密码不能为空",
           "gender": "only can be male or female!"
       }
   }

虽然通过以上方式可以实现数据的校验, 但是实际在生产当中, 为了准守单一职责的设计模式, 我们不会使用上述方式进行数据校验
各种xxO:

1. DAO: Data Access Object, 数据访问对象
2. TO: Transfer Object, 传输对象
3. BO: Business Object, 业务对象
4. VO: View Object, 视图对象(用于与前端数据交互)
5. DTO: Data Transfer Object, 数据传输对象

5.8 接口文档Swagger

Swagger可以快速生成接口文档，方便前后端开发人员协调沟通
Knife4j –> Swagger –> OpenAPI

1. 添加依赖

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
    <version>4.4.0</version>
</dependency>

2. 配置

# springdoc-openapi项目配置
springdoc:
  swagger-ui:
    path: /swagger-ui.html
    tags-sorter: alpha
    operations-sorter: alpha
  api-docs:
    path: /v3/api-docs
  group-configs:
    - group: 'default'
      paths-to-match: '/**'
      packages-to-scan: com.learning.ssm.springmvc02validation_exception.controller
# knife4j的增强配置，不需要增强可以不配
knife4j:
  enable: true
  setting:
    language: zh_cn

3. 访问
   地址: http://localhost:8080/doc.html

5.9 SpringMVC运行流程

6. MyBatis

MyBatis 是一款优秀的持久层框架

开发工具准备: 在IDEA中安装插件MyBatisX
使用MyBatis流程:

1. 配置数据库连接池

   spring:
     application:
       name: mybatis-01-helloworld
     datasource:
       url: jdbc:mysql://localhost:3306/mybatis-example
       username: root
       password: root
       driver-class-name: com.mysql.jdbc.Driver

2. 编写Dao层接口(Mapper)

   @Mapper //告诉Spring, 这是Mybatis操作的接口
   public interface empMapper {
       Emp getEmpById(int id);
   }

3. 编写Mapper.xml文件(位于resource/mapper文件夹下)
   可以通过MyBatisX插件生成

   <?xml version="1.0" encoding="UTF-8" ?>
   <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
   <mapper namespace="com.learning.ssm.mybatis.dao.empMapper">
       <!--namespace代表这个mapper接口和此xml文件进行绑定-->
       <!-- select标签代表查询, id绑定方法名 -->
       <select id="getEmpById" resultType="com.learning.ssm.mybatis.bean.Emp">
           select id, emp_name empName, age, emp_salary empSalary from t_tmp where id = #{id};
       </select>
   </mapper>

4. 通知MyBatis各个Mapper接口对应的Mapper.xml文件地址

   spring:
     application:
       name: mybatis-01-helloworld
     datasource:
       url: jdbc:mysql://localhost:3306/mybatis-example
       username: root
       password: root
       driver-class-name: com.mysql.jdbc.Driver
   
   mybatis:
     mapper-locations: classpath:mapper/**.xml # 配置mapper.xml文件的位置
     configuration:
       map-underscore-to-camel-case: true # 开启下划线自动转驼峰命名规则
   logging:
     level:
       com.learning.ssm.mybatis.mapper: debug # 开启mybatis的日志级别为debug

6.1 两种取值方式的区别

1. #{id}: 占位符, 占位符的值是运行时从参数对象中取出对应的值
2. ${id}: 拼串, 拼串的值是运行时从参数对象中取出对应的值, 但是拼串的值会被直接拼在sql中, 有sql注入的风险

对于表名, 可以使用${tableName}传入表名, 但是不能使用#{tableName}

6.2 自定义返回结果集

• id标签: id标签用于定义主键
• result标签: result标签用于定义普通值
• association标签: association标签用于定义对象
• collection标签: collection标签用于定义集合

<resultMap id="resultRM" type="com.learning.ssm.mybatis.bean.Emp">
    <id column="id" property="id"></id>  <!--定义组件映射关系-->
    <result column="emp_name" property="empName" javaType="java.lang.String" jdbcType="VARCHAR"></result> <!--定义普通值映射关系-->
    <result column="emp_salary" property="empSalary"></result>
    <result column="age" property="age"></result>
</resultMap>

<select id="getEmpById_" resultMap="resultRM">
select *
from t_tmp
where id = #{id}
</select>