【SpringMVC快速使用】1.@RestController @RequestMapping 2.logback的使用

背景：为何从这个最简单的例子写起呢？

那是因为我们的管理后台之类的都是别人写的，我也听说了大家说：只用Post请求就足够了，但是却发现，在浏览器中测试时，默认是GET请求，如果直接写的@PostMapping，则提示此请求不支持。

有了SpringBoot，开发部署一个Web项目是非常加单的。对比ASP.Net Core 和go的繁琐(因为很多东西需要自己从头做)，SpringBoot是做到了开箱即用，我们引入需要的starter，使用依赖注入即可引入我们需要的service类，结合dubbo，我们可以轻松的实现微服务(也就是这个接口的实现是别的服务做的)。不管是同步还是异步，都是非常的简单的。

1)我们的游戏服务器是从"平台"账号注册开始的，那么我们就从这里开始：

package com.example.springbootdemo.controller;

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@Slf4j
@RestController
@RequestMapping("/account")
public class AccountController {

    /**
     * @param username
     * @param password
     */
    @RequestMapping("/register")
    public void register(String username, String password) {
        log.info("新用户注册,username={}, password={}", username, password);
    }
}

/*
2024-01-11T11:10:10.421+08:00  INFO 32040 --- [nio-8080-exec-5] c.e.s.controller.AccountController       : 新用户注册,username="xx", password="aa"
2024-01-11T11:10:10.647+08:00  INFO 32040 --- [nio-8080-exec-6] c.e.s.controller.AccountController       : 新用户注册,username="xx", password="aa"
2024-01-11T11:10:10.850+08:00  INFO 32040 --- [nio-8080-exec-7] c.e.s.controller.AccountController       : 新用户注册,username="xx", password="aa"
2024-01-11T11:10:11.014+08:00  INFO 32040 --- [nio-8080-exec-8] c.e.s.controller.AccountController       : 新用户注册,username="xx", password="aa"
2024-01-11T11:10:11.187+08:00  INFO 32040 --- [nio-8080-exec-2] c.e.s.controller.AccountController       : 新用户注册,username="xx", password="aa"
2024-01-11T11:10:11.362+08:00  INFO 32040 --- [io-8080-exec-10] c.e.s.controller.AccountController       : 新用户注册,username="xx", password="aa"
2024-01-11T11:10:13.562+08:00  INFO 32040 --- [nio-8080-exec-9] c.e.s.controller.AccountController       : 新用户注册,username="xx", password="aa"
2024-01-11T11:15:47.588+08:00  INFO 32040 --- [nio-8080-exec-5] c.e.s.controller.AccountController       : 新用户注册,username="xx", password="aa"
*/

2)日志肯定是少不了的

在pom.xml中引入下logback日志包 // 注意：不要带版本号，不然打包时就会提示logback版本号冲突了，我们使用继承过来的版本即可

    <!-- log -->
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-api</artifactId>
<!--      <version>1.7.25</version>-->
    </dependency>
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>jcl-over-slf4j</artifactId>
<!--      <version>1.7.7</version>-->
    </dependency>
    <dependency>
      <groupId>ch.qos.logback</groupId>
      <artifactId>logback-classic</artifactId>
<!--      <version>1.2.3</version>-->
    </dependency>
    <dependency>
      <groupId>ch.qos.logback</groupId>
      <artifactId>logback-core</artifactId>
<!--      <version>1.2.3</version>-->
    </dependency>

接着把zfoo的logback.xml粘贴过来放到resources下面即可:

<?xml version="1.0" encoding="UTF-8"?>

<configuration scan="false" debug="false">
  <property name="LOG_HOME" value="log/"/>
  <property name="PATTERN_FILE"
    value="%d{yyyy-MM-dd HH:mm:ss} [%-5level] [%thread] %logger.%M\\(%F:%line\\) - %msg%n"/>
  <property name="PATTERN_CONSOLE"
    value="%d{yyyy-MM-dd HH:mm:ss} [%highlight(%-5level)] [%thread] %logger.%M\\(%F:%line\\) - %msg%n"/>
  <!-- 负责写日志,控制台日志，会打印所有的包的所有级别日志 -->
  <appender name="zfoo_console" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>${PATTERN_CONSOLE}</pattern>
      <charset>UTF-8</charset>
    </encoder>
  </appender>

  <!-- debug日志，只有一个文件，只收集debug级别日志，每次启动会覆盖以前的debug日志 -->
  <appender name="zfoo_debug" class="ch.qos.logback.core.FileAppender">
    <file>${LOG_HOME}/debug.log</file>
    <!-- append: true,日志被追加到文件结尾; false,清空现存文件;默认是true -->
    <append>false</append>
    <encoder>
      <pattern>${PATTERN_FILE}</pattern>
      <charset>UTF-8</charset>
    </encoder>
    <filter class="ch.qos.logback.classic.filter.LevelFilter">
      <level>debug</level>
      <onMatch>ACCEPT</onMatch>
      <onMismatch>DENY</onMismatch>
    </filter>
  </appender>

  <!-- info，warn，error级别的日志都会添加在info.log日志中 -->
  <!-- 滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件 -->
  <appender name="zfoo_info" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${LOG_HOME}/info.log</file>

    <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
      <!-- rollover daily -->
      <fileNamePattern>${LOG_HOME}/info.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
      <!-- each file should be at most 100MB, keep 30 days worth of history, but at most 40GB -->
      <maxFileSize>100MB</maxFileSize>
      <maxHistory>30</maxHistory>
      <totalSizeCap>40GB</totalSizeCap>
    </rollingPolicy>

    <encoder>
      <Pattern>${PATTERN_FILE}</Pattern>
      <charset>UTF-8</charset>
    </encoder>

    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
      <level>info</level>
    </filter>
  </appender>

  <!-- 异步输出 -->
  <appender name="zfoo_async_info" class="ch.qos.logback.classic.AsyncAppender">
    <!-- 不丢失日志.默认的,如果队列的80%已满,则会丢弃TRACT、DEBUG、INFO级别的日志 -->
    <discardingThreshold>0</discardingThreshold>
    <!-- 更改默认的队列的深度,该值会影响性能.默认值为256 -->
    <queueSize>512</queueSize>
    <!-- 添加附加的appender,最多只能添加一个 -->
    <appender-ref ref="zfoo_info"/>
  </appender>

  <!-- 只收集error级别的日志 -->
  <appender name="zfoo_error" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${LOG_HOME}/error.log</file>

    <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
      <fileNamePattern>${LOG_HOME}/error.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
      <maxFileSize>100MB</maxFileSize>
      <maxHistory>30</maxHistory>
      <totalSizeCap>20GB</totalSizeCap>
    </rollingPolicy>

    <encoder>
      <Pattern>${PATTERN_FILE}</Pattern>
      <charset>UTF-8</charset>
    </encoder>

    <filter class="ch.qos.logback.classic.filter.LevelFilter">
      <level>error</level>
      <onMatch>ACCEPT</onMatch>
      <onMismatch>DENY</onMismatch>
    </filter>
  </appender>

  <!--step1:指定想要输出的类型-->
  <!-- 根logger -->
  <root level="info">
    <!--控制台-->
    <appender-ref ref="zfoo_console"/>
    <!--        <appender-ref ref="zfoo_debug"/>-->
    <appender-ref ref="zfoo_async_info"/>
    <!--        <appender-ref ref="zfoo_error"/>-->
  </root>

  <logger name="ch.qos.logback" level="info"/>
  <logger name="org.springframework" level="info"/>
  <logger name="io.netty" level="info"/>
</configuration>

3)结合lombok的@Slf4j注解，我们可以很轻松打印的日志(想想go或者asp.net core的话，自己不是太熟悉，还是得折腾半天)

4)测试

浏览器中发起下请求:

http://localhost:8080/account/register?username="xx"&password="aa"

注意从浏览器中粘贴下来可能不是这样子了，这是因为进行了编码

http://localhost:8080/account/register?username=%22xx%22&password=%22aa%22

观察下idea下的日志，可以看出来这个日志是非常清楚的

时间，日志级别，线程，日志是从哪个类打印出的，跳转，信息等非常清楚

5)打包也很容易了开箱即用。