<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.9.RELEASE</version>
    </parent>

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

        <!--Hutool是一個小而全的Java工具類庫-->
        <dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-all</artifactId>
            <version>5.6.3</version>
        </dependency>
        <!--lombok-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.30</version>
        </dependency>
        <!--fastjson-->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.6</version>
        </dependency>
    </dependencies>

method: [DELETE], uri: [/test_query/requestparam_1], param type: [Query]  ---> SUCCESS! requestParam1 name = wangwu-delete, age = 18

{
    "code": 0,
    "data": "method: [DELETE], uri: [/test_query/requestparam_1], param type: [Query]  ---> SUCCESS! requestParam1 name = wangwu-delete, age = 18",
    "msg": "操作成功",
    "timestamp": 1704766444205
}

package com.su.demo.controller.param_type;

import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.web.bind.annotation.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.util.Date;


@RestController
@RequestMapping(value = "/param_type/query")
public class TestQueryController {

    /**
     * <ul>
     *     <li><b>入參類別</b>：Query參數
     *     <li><b>定義方式</b>: 在方法形參的位置,把每個參數都平鋪開來</li>
     *     <li><b>調用方式</b>: 入參拼接在接口的uri后面,如 /test_get/requestparam_1?name=wangwu&age=18</li>
     *     <li><b>兼容的請求方式</b>：GET POST PUT DELETE</li>
     *     <li><b>適用場景</b>：雖然這種傳參方式,適用于GET POST PUT DELETE等請求方式,但是一般偏向于應用在 入參個數少(一般少于5個)的<b>GET</b>請求方式中</li>
     *     <li><b>優(yōu)點</b>:方便簡單</li>
     *     <li><b>缺點</b>:1) 入參直接顯示在uri中，不太安全 2）參數個數如果過多,方法體結構會顯得很臃腫; 3）沒有入參校驗</li>
     * </ul>
     * <p><b>注意</b>:根據自己的需求決定是否在形參中加上HttpServletRequest,我這里是為了從request中獲取method,所以加上了</p>
     */
    @RequestMapping(value = "/test1")
    public String test1(String name, Integer age, HttpServletRequest request) {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        return requestMetaInfo + " ---> SUCCESS! name = " + name + ", age = " + age;
    }

}

package com.su.demo.controller.param_type;

import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.web.bind.annotation.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.util.Date;

@RestController
@RequestMapping(value = "/param_type/query")
public class TestQueryController {

    /**
     * <ul>
     *     <li><b>入參類別</b>：Query參數
     *     <li><b>定義方式</b>: 在方法形參的位置,把每個參數都平鋪開來.并且相較于前一種定義方式,這種方式使用 {@link RequestParam}綁定請求參數到方法形參， 且需要注意該注解中的各個屬性的作用！</li>
     *     <li><b>調用方式</b>: 入參拼接在接口的uri后面,如 /test_get/requestparam_1?name=wangwu&age=18</li>
     *     <li><b>兼容的請求方式</b>：GET POST PUT DELETE</li>
     *     <li><b>適用場景</b>：雖然這種傳參方式,適用于GET POST PUT DELETE等請求方式,但是一般偏向于應用在 入參個數少(一般少于5個)的<b>GET</b>請求方式中</li>
     *     <li><b>優(yōu)點</b>:方便簡單;且結合{@link RequestParam},可實現入參的必填校驗/重命名/默認值等簡單的功能</li>
     *     <li><b>缺點</b>:1) 入參直接顯示在uri中，不太安全
     *                    2）參數個數如果過多,方法體結構會顯得很臃腫(當前這個方法有4個入參,其實就已經有點臃腫了)
     *                    3){@link RequestParam}能支持的校驗相對來說還是比較簡單</li>
     * </ul>
     */
    @RequestMapping(value = "/test2_requestparam")
    public String test2(@RequestParam String name,
                                @RequestParam(name = "newAge") Integer age,
                                @RequestParam(name = "birth", required = false) @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") Date birth,
                                @RequestParam(defaultValue = "true") Boolean enable,
                                HttpServletRequest request) {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        return requestMetaInfo + " ---> SUCCESS! name = " + name + ", age = " + age + ", birth = " + birth + ", enable = " + enable;
    }

}

package com.su.demo.controller.param_type;

import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.web.bind.annotation.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.util.Date;

@RestController
@RequestMapping(value = "/param_type/query")
public class TestQueryController {

    /**
     * <ul>
     *     <li><b>入參類別</b>：Query參數
     *     <li><b>定義方式</b>: 把入參封裝到一個實體中(入參個數多于5個時一般用這種方式)
     *     <li><b>調用方式</b>: 入參拼接在接口的uri后面,如 /test_get/requestparam_1?name=wangwu&age=18</li>
     *     <li><b>兼容的請求方式</b>：GET POST PUT DELETE</li>
     *     <li><b>適用場景</b>：從技術上來說這種傳參方式,同時適用于GET POST PUT DELETE等多種請求方式,但是一般我個從偏向于在入參個數大于5個的<b>GET</b>請求方式中使用</li>
     *     <li><b>優(yōu)點</b>:因為參數都封裝在實體bean當中了,所以對參數的個數就沒有什么的限制了,接口定義的時候方便多了
     *     <li><b>缺點</b>:對于這種入參的[定義方式]來說,它是沒有什么缺點的.硬要說缺點的話,其實是針對Query這種傳參方式來說的,即當參數個數一多的時候,參數都放在請求uri中容易造成uri的長度過過長
     *     (雖然http協(xié)議中未明確對url進行長度限制，但在真正實現中，url的長度還是受到限制的，一是服務器端的限制，二就是游覽器端的限制)</li>
     * </ul>
     */
    @RequestMapping(value = "/test3_entity")
    public String test3(UserDTO userDTO, HttpServletRequest request) {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        return requestMetaInfo + " ---> SUCCESS! userDTO = " + userDTO;
    }

}

package com.su.demo.bean.dto;

import lombok.Data;
import org.springframework.format.annotation.DateTimeFormat;
import java.util.Date;

@Data
public class UserDTO {
    /**
     * 主鍵ID
     */
    private Long id;

    /**
     * 用戶姓名
     */
    private String name;

    /**
     * 用戶狀態(tài) true：啟用；false：禁用
     */
    private Boolean enable;

    /**
     * 用戶生日
     */
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date birth;
}

package com.su.demo.controller.param_type;

import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.web.bind.annotation.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.util.Date;

@RestController
@RequestMapping(value = "/param_type/query")
public class TestQueryController {

    /**
     * <ul>
     *     <li><b>入參類別</b>：Query參數
     *     <li><b>定義方式</b>: 在方式形參的位置,用原生的{@link HttpServletRequest}接收
     *     <li><b>調用方式</b>: 入參拼接在接口的uri后面,如 /test_get/requestparam_1?name=wangwu&age=18</li>
     *     <li><b>兼容的請求方式</b>：GET POST PUT DELETE</li>
     *     <li><b>適用場景</b>：從技術上來說,這種傳參方式同時適用于GET POST PUT DELETE等請求方式,但是正常情況下比較少用這種方式來獲取參數了</li>
     *     <li><b>優(yōu)點</b>:{@link HttpServletRequest}是整個請求，可以獲取到所有的數據.且HttpServletRequest、HttpServletResponse都是內置對象，可以使用</li>
     *     <li><b>缺點</b>:代碼中再去從request中拿到參數,比較麻煩</li>
     * </ul>
     * <p> 注意,這種方式其實也可以獲取body請求體里面的數據,參考https://blog.csdn.net/qq_24850045/article/details/121927722
     */
    @RequestMapping(value = "/test4_request")
    public String test4(HttpServletRequest request) throws IOException {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        String name = request.getParameter("name");
        Integer age = Integer.parseInt(request.getParameter("age")); // 需要進行類型轉換

        return requestMetaInfo + " ---> SUCCESS! name = " + name + ", age = "  + age;
    }

}

package com.su.demo.controller.param_type;

import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.web.bind.annotation.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.util.Date;

@RestController
@RequestMapping(value = "/param_type/query")
public class TestQueryController {

    /**
     * <ul>
     *     <li><b>入參類別</b>：Query參數
     *     <li><b>定義方式</b>: 在方式形參的位置,結合{@link RequestParam}用Map接收
     *     <li><b>調用方式</b>: 入參拼接在接口的uri后面,如 /test_get/requestparam_1?name=wangwu&age=18</li>
     *     <li><b>兼容的請求方式</b>：GET POST PUT DELETE</li>
     *     <li><b>適用場景</b>：適用于參數個數較多，但是自己又想偷懶不想專門定義一個實體來接收入參的場景。一般不推薦使用這種方式。</li>
     *     <li><b>優(yōu)點</b>:簡單方便</li>
     *     <li><b>缺點</b>:需要在代碼中通過指定特定的key的方式去獲取入參，比較麻煩；而且這種接收入參的方式，沒有辦法結合{@link org.springframework.validation.annotation.Validated}來做入參校驗</li>
     * </ul>
     */
    @RequestMapping(value = "/test5_map")
    public String test5(@RequestParam Map<String, String> paramMap, HttpServletRequest request) throws IOException {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        String name = paramMap.get("name");
        // 判斷：如果paramMap.get("age")為null，則age賦默認值0；否則進行入參類型的轉換
        Integer age = null == paramMap.get("age") ? 0: Integer.parseInt(paramMap.get("age"));

        return requestMetaInfo + " ---> SUCCESS! name = " + name + ", age = "  + age;
    }

}

package com.su.demo.controller.param_type;

import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.http.HttpServletRequest;

@RestController
@RequestMapping(value = "/param_type/path_variable")
public class TestPathVarController {


    /**
     * <ul>
     *     <li><b>入參類別</b>：PathVariable路徑參數方式
     *     <li><b>定義方式</b>: 用占位符的方式把入參封裝到請求路徑中,然后再通過@PathVariable注解可以將URL中的占位符參數綁定到控制器（controller）處理方法的形參中. </li>
     *     <li><b>調用方式</b>: REST風格路徑參數,入參拼接在接口的URI里面,如/test_pathvar/test1/zhangsan/1 </li>
     *     <li><b>兼容的請求方式</b>：GET POST PUT DELETE</li>
     *     <li><b>適用場景</b>：從技術上來說,這種傳參方式同時適用于GET POST PUT DELETE等多種請求方式.
     *         但是一般入參個數小于5個,且你開發(fā)的是REST風格的接口,那可以考慮用這種方式
     *         </li>
     * </ul>
     * <p>REST(英文：Representational State Transfer，簡稱REST，意思：表述性狀態(tài)轉換，描述了一個架構樣式的網絡系統(tǒng)，比如web應用)，是一種軟件架構風格不是標準哦！
     * 只是提供了一組設計原則和約束條件。它主要用于客戶端和服務器交互類的軟件?；谶@個風格設計的軟件可以更簡潔，更有層次，更易于實現緩存等機制。
     * REST 指的是一組架構（約束條件）和原則。滿足這些（約束條件）和（原則）的應用程序或設計就是 Restful。</p>
     */
    @RequestMapping(value = "/test1/{name}/{age}")
    public String test1(@PathVariable("name") String name, @PathVariable("age") Integer myage, HttpServletRequest request) {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));
        return requestMetaInfo + " ---> SUCCESS! name = " + name + ", myage = "  + myage;
    }
}

package com.su.demo.controller.param_type;

import cn.hutool.core.io.IoUtil;
import com.alibaba.fastjson.JSON;
import com.su.demo.bean.dto.UserDTO;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.ServletInputStream;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;

@RestController
@RequestMapping(value = "/param_type/body_json")
public class TestBodyController {


    /**
     * <ul>
     *     <li><b>入參類別</b>：body參數方式
     *     <li><b>定義方式</b>: 在方式形參的位置,用原生的{@link HttpServletRequest}接收
     *     <li><b>調用方式</b>: 參數放在請求體 body 當中
     *     <li><b>兼容的請求方式</b>：GET POST PUT DELETE</li>
     *     <li><b>適用場景</b>：從技術上來說,這種傳參方式同時適用于GET POST PUT DELETE等請求方式,但是正常情況下比較少用這種方式來獲取body參數了</li>
     *     <li><b>優(yōu)點</b>:{@link HttpServletRequest}是整個請求，可以獲取到所有的數據.且HttpServletRequest、HttpServletResponse都是內置對象，可以使用</li>
     *     <li><b>缺點</b>:代碼中再去從request中拿到參數,老麻煩,可以看下面的代碼</li>
     * </ul>
     * <p> 注意,這種方式其實也可以獲取body請求體里面的數據,參考https://blog.csdn.net/qq_24850045/article/details/121927722
     */
    @RequestMapping(value = "/test1_request")
    public String test1(HttpServletRequest request) throws IOException {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        ServletInputStream inputStream = request.getInputStream();
        // 用hutool工具包的read方式,將inputStream讀取成string
        String body = IoUtil.read(inputStream, "UTF-8");
        System.out.println("body = " + body);
        // 用fastjson將json字符串轉換成bean
        UserDTO userDTO = JSON.parseObject(body, UserDTO.class);

        return requestMetaInfo + " ---> SUCCESS! userDTO = " + userDTO;
    }
}

package com.su.demo.bean.dto;

import lombok.Data;
import org.springframework.format.annotation.DateTimeFormat;

import java.util.Date;

@Data
public class UserDTO {
    /**
     * 主鍵ID
     */
    private Long id;

    /**
     * 用戶姓名
     */
    private String name;

    /**
     * 用戶狀態(tài) true：啟用；false：禁用
     */
    private Boolean enable;

    /**
     * 用戶生日
     */
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private Date birth;
}

package com.su.demo.controller.param_type;

import cn.hutool.core.io.IoUtil;
import com.alibaba.fastjson.JSON;
import com.su.demo.bean.dto.UserDTO;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.ServletInputStream;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;

@RestController
@RequestMapping(value = "/param_type/body_json")
public class TestBodyController {

   /**
     * <ul>
     *     <li><b>入參類別</b>：body參數方式
     *     <li><b>定義方式</b>: 在方式形參的位置,用{@link RequestBody}接收
     *     <li><b>調用方式</b>: 參數放在請求體 body 當中
     *     <li><b>兼容的請求方式</b>：GET POST PUT DELETE</li>
     *     <li><b>適用場景</b>：從技術上來說,這種傳參方式同時適用于GET POST PUT DELETE等請求方式,但是正常情況下一般用在POST或PUT請求中</li>
     *     <li><b>優(yōu)點</b>:1)方法形參的定義非常簡潔;
     *                  2)調用的時候參數放在body中,參數體可以很大,不像Query入參方式在當參數過多的時候容易觸發(fā)服務器端"Request header is too large"的報錯
     *         </li>
     *     <li><b>缺點</b>:用String類型來接收參數,接收之后再轉換成bean實體,還是稍微顯得有點麻煩</li>
     * </ul>
     */
    @RequestMapping(value = "/test2_requestbody_string")
    public String test2(@RequestBody String body, HttpServletRequest request) {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        System.out.println("body = " + body);
        // 用fastjson將json字符串轉換成bean
        UserDTO userDTO = JSON.parseObject(body, UserDTO.class);

        return requestMetaInfo + " ---> SUCCESS! userDTO = " + userDTO;
    }

}

package com.su.demo.controller.param_type;

import cn.hutool.core.io.IoUtil;
import com.alibaba.fastjson.JSON;
import com.su.demo.bean.dto.UserDTO;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.ServletInputStream;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;

@RestController
@RequestMapping(value = "/param_type/body_json")
public class TestBodyController {

    /**
     * <ul>
     *     <li><b>入參類別</b>：body參數方式
     *     <li><b>定義方式</b>: 在方式形參的位置,用{@link RequestBody}接收,
     *         而且是直接用一個實例類來接收了(spring自動調用相應的{@link org.springframework.http.converter.HttpMessageConverter}去做轉換)
     *         </li>
     *     <li><b>調用方式</b>: 參數放在請求體 body 當中
     *     <li><b>兼容的請求方式</b>：GET POST PUT DELETE</li>
     *     <li><b>適用場景</b>：從技術上來說,這種傳參方式同時適用于GET POST PUT DELETE等請求方式,但是正常情況下一般用在POST或PUT請求中</li>
     *     <li><b>優(yōu)點</b>:1)方法形參的定義非常簡潔;
     *                  2)調用的時候參數放在body中,參數體可以很大,不像Query入參方式在當參數過多的時候容易觸發(fā)服務器端"Request header is too large"的報錯
     *         </li>
     *     <li><b>缺點</b>:好像沒啥缺點</li>
     * </ul>
     */
    @RequestMapping(value = "/test3_requestbody_entity")
    public String test3(@RequestBody UserDTO userDTO, HttpServletRequest request) {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        return requestMetaInfo + " ---> SUCCESS! userDTO = " + userDTO;
    }

}

package com.su.demo.controller.param_type;

import cn.hutool.core.io.IoUtil;
import com.alibaba.fastjson.JSON;
import com.su.demo.bean.dto.UserDTO;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.ServletInputStream;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;

@RestController
@RequestMapping(value = "/param_type/body_json")
public class TestBodyController {

   /**
     * <ul>
     *     <li><b>入參類別</b>：body參數方式
     *     <li><b>定義方式</b>: 在方式形參的位置,用{@link RequestBody}接收,
     *         而且是直接用一個Map對象實例類來接收了(spring自動調用相應的{@link org.springframework.http.converter.HttpMessageConverter}去做轉換)
     *         </li>
     *     <li><b>調用方式</b>: 參數放在請求體 body 當中
     *     <li><b>兼容的請求方式</b>：GET POST PUT DELETE</li>
     *     <li><b>適用場景</b>：從技術上來說,這種傳參方式同時適用于GET POST PUT DELETE等請求方式,一般使用在偷懶不想專門定義一個實體來接收入參的場景。一不太推薦使用這種方式/li>
     *     <li><b>優(yōu)點</b>:1)方法形參的定義非常簡潔;
     *                  2)調用的時候參數放在body中,參數體可以很大,不像Query入參方式在當參數過多的時候容易觸發(fā)服務器端"Request header is too large"的報錯
     *         </li>
     *     <li><b>缺點</b>:好像沒啥缺點</li>
     * </ul>
     */
    @RequestMapping(value = "/test4_requestbody_map")
    public String test4(@RequestBody Map<String, String> paramMap, HttpServletRequest request) {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        String name = paramMap.get("name");
        // 判斷：如果paramMap.get("age")為null，則age賦默認值0；否則進行入參類型的轉換
        Integer age = null == paramMap.get("age") ? 0: Integer.parseInt(paramMap.get("age"));

        return requestMetaInfo + " ---> SUCCESS! name = " + name + ", age = " + age;
    }

}

package com.su.demo.controller.param_type;

import cn.hutool.core.io.IoUtil;
import com.su.demo.bean.dto.TeacherDTO;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.ServletInputStream;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.net.URLDecoder;
import java.util.Map;

@RestController
@RequestMapping(value = "/param_type/body_form_urlencoded")
public class TestFormUrlEncodeController {

    /**
     * <p>注意，如果使用GET請求方式，則后端獲取不到入參?。。?lt;/p>
     * <ul>
     *     <li><b>入參類別</b>：表單參數方式，Content-Type=application/x-www-form-urlencoded
     *     <li><b>定義方式</b>: 在方法形參的位置,把每個參數都平鋪開來</li>
     *     <li><b>調用方式</b>: 入參放在表單中，且Content-Type=application/x-www-form-urlencoded</li>
     *     <li><b>兼容的請求方式</b>：POST PUT DELETE</li>
     *     <li><b>適用場景</b>：雖然這種傳參方式,適用于POST PUT DELETE等請求方式,但是一般偏向于應用在 用<b>POST</b>或b>PUT</b>方式去發(fā)送的表單數據，且參數個數少，且表單字段都是普通類型(即表單字段不是File文件)，</li>
     *     <li><b>優(yōu)點</b>:方便簡單</li>
     *     <li><b>缺點</b>:1)參數個數如果過多,方法體結構會顯得很臃腫</li>
     * </ul>
     */
    @RequestMapping(value = "/test1_requestparam")
    public String test1(String name, @RequestParam(name = "age", required = false) Integer age, Boolean enable, HttpServletRequest request) {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        return requestMetaInfo + " ---> SUCCESS! name = " + name + ", age = " + age + ", enable = " + enable;
    }
}

package com.su.demo.controller.param_type;

import cn.hutool.core.io.IoUtil;
import com.su.demo.bean.dto.TeacherDTO;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.ServletInputStream;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.net.URLDecoder;
import java.util.Map;

@RestController
@RequestMapping(value = "/param_type/body_form_urlencoded")
public class TestFormUrlEncodeController {

    /**
     * <p>注意，如果使用GET請求方式，則后端獲取不到入參?。。≈恢С諴OST PUT DELETE</p>
     * <p>且形參定義那里，一定不能使用{@link RequestParam}修飾</p>
     * <ul>
     *     <li><b>入參類別</b>：表單參數方式，Content-Type=application/x-www-form-urlencoded
     *     <li><b>定義方式</b>: 把入參封裝到一個實體中(入參個數多于5個時一般用這種方式)</li>
     *     <li><b>調用方式</b>: 入參放在表單中，且Content-Type=application/x-www-form-urlencoded</li>
     *     <li><b>兼容的請求方式</b>：POST PUT DELETE</li>
     *     <li><b>適用場景</b>：雖然這種傳參方式,適用于POST PUT DELETE等請求方式,但是一般偏向于應用在 用<b>POST</b>或<b>PUT</b>方式去發(fā)送的表單數據，且表單字段都是普通類型(即表單字段不是File文件)，</li>
     *     <li><b>優(yōu)點</b>:方便簡單，不管表單字段個個數多或少，一般如果表單字段類型沒有File文件類型的，都可以使用這種方式</li>
     *     <li><b>缺點</b>:缺點的話就是針對Content-Type=application/x-www-form-urlencoded這種入參方式來說了：不能上傳文件</li>
     * </ul>
     */
    @RequestMapping(value = "/test2_entity")
    public String test2(TeacherDTO teacherDTO, HttpServletRequest request) {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        return requestMetaInfo + " ---> SUCCESS! teacherDTO = " + teacherDTO;
    }

}

package com.su.demo.controller.param_type;

import cn.hutool.core.io.IoUtil;
import com.su.demo.bean.dto.TeacherDTO;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.ServletInputStream;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.net.URLDecoder;
import java.util.Map;

@RestController
@RequestMapping(value = "/param_type/body_form_urlencoded")
public class TestFormUrlEncodeController {

    /**
     * <p>注意，只支持GET請求方式，如果使用POST、PUT、DELETE請求方式，則后端獲取不到入參?。?！</p>
     * <ul>
     *     <li><b>入參類別</b>：表單參數方式，Content-Type=application/x-www-form-urlencoded
     *     <li><b>定義方式</b>: 在方法形參的位置，用{@link HttpServletRequest}來接收入參</li>
     *     <li><b>調用方式</b>: 入參放在表單中，且Content-Type=application/x-www-form-urlencoded</li>
     *     <li><b>兼容的請求方式</b>：GET</li>
     *     <li><b>適用場景</b>：由于當請求的Content-Type=application/x-www-form-urlencoded時，只支持GET請求方式，
     *     并且即使是GET請求方式能獲取到入參了，之后的校驗和處理也很麻煩，所以一般不用這種方式來接收Content-Type=application/x-www-form-urlencoded的請求</li>
     *     <li><b>優(yōu)點</b>:方便簡單，且這接收入參的方式，直接調用方用GET的請求方式傳參</li>
     *     <li><b>缺點</b>:1）需要自己在代碼中顯式的從request的inputStream流【獲取+轉換+解碼】數據，很麻煩
     *                    2）如果請求方式是POST PUT DELETE等，同時Content-Type=application/x-www-form-urlencoded，則無法將入參傳到后面代碼中！
     *      </li>
     * </ul>
     */
    @RequestMapping(value = "/test3_request")
    public String test3(HttpServletRequest request) throws IOException {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        ServletInputStream inputStream = request.getInputStream();
        String inputStr = IoUtil.read(inputStream, "UTF-8");
        String decodeRes = URLDecoder.decode(inputStr, "UTF-8");

        return requestMetaInfo + " ---> SUCCESS! " + inputStr + ", decodeResult = " + decodeRes;
    }

}

package com.su.demo.controller.param_type;

import cn.hutool.core.io.IoUtil;
import com.su.demo.bean.dto.TeacherDTO;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.ServletInputStream;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.net.URLDecoder;
import java.util.Map;

@RestController
@RequestMapping(value = "/param_type/body_form_urlencoded")
public class TestFormUrlEncodeController {

    /**
     * <p>這是一種錯誤的定義方式，這種方式，無論是否在map前面添加{@link RequestParam}還是{@link RequestBody}, 代碼都獲取不到 Content-Type=application/x-www-form-urlencoded類型請求的入參！?。?lt;/p>
     * <ul>
     *     <li><b>入參類別</b>：表單參數方式，Content-Type=application/x-www-form-urlencoded
     *     <li><b>定義方式</b>: 在方法形參的位置，用Map來接收入參</li>
     *     <li><b>調用方式</b>: 入參放在表單中，且Content-Type=application/x-www-form-urlencoded</li>
     * </ul>
     */
    @RequestMapping(value = "/test4_map")
    public String test4(Map<String, String> paramMap, HttpServletRequest request) {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));

        String name = paramMap.get("name");
        // 判斷：如果paramMap.get("age")為null，則age賦默認值0；否則進行入參類型的轉換
        Integer age = null == paramMap.get("age") ? 0: Integer.parseInt(paramMap.get("age"));

        return requestMetaInfo + " ---> SUCCESS! name = " + name + ", age = " + age;
    }

}

package com.su.demo.controller.param_type;

import cn.hutool.core.io.IoUtil;
import com.su.demo.bean.dto.TeacherDTO;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.ServletInputStream;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
import java.net.URLDecoder;
import java.util.Map;

@RestController
@RequestMapping(value = "/param_type/body_form_urlencoded")
public class TestFormUrlEncodeController {

    /**
     * <p>
     *     雖然在方法定義這里，形參中添加了MultipartFile，但是如果調用接口的時候入參類型是Content-Type=application/x-www-form-urlencoded，
     *     那由于Content-Type=application/x-www-form-urlencoded入參類型限制了入參就無法將【文件】傳過來，所以該方法的MultipartFile對象始終為空！
     * </p>
     * <ul>
     *     <li><b>入參類別</b>：表單參數方式，Content-Type=application/x-www-form-urlencoded
     *     <li><b>定義方式</b>: 在方法形參的位置,把每個參數都平鋪開來</li>
     *     <li><b>調用方式</b>: 入參放在表單中，且Content-Type=application/x-www-form-urlencoded</li>
     * </ul>
     */
    @RequestMapping(value = "/test5_requestparam_file")
    public String test5(String name, Integer age, Boolean enable, MultipartFile myfile, HttpServletRequest request) throws IOException {
        // 從request中獲取一些接口請求時的元數據信息，包括請求方式，Content-type等
        String requestMetaInfo = String.format("method: [%s], uri: [%s], Content-Type: [%s] ", request.getMethod(), request.getRequestURI(),  request.getHeader("Content-Type"));
        String fileName = null;
        if (null != myfile) {
            fileName = myfile.getOriginalFilename();
        }

        return requestMetaInfo + " ---> SUCCESS! name = " + name + ", age = " + age + ", enable = " + enable + ", fileName = " + fileName;
    }

}