@RequestMapping属性详解

1.name

此处name属性，相当于方法的注释，使方法更易理解

@RequestMapping(value = “login”,name = “用户登录”)
@ResponseBody
public String login() {
return “success”;
}

2.value

指定请求的实际地址，指定的地址可以是URI 模板模式（Template Pattern）；

@Controller
@RequestMapping(“user”) //此处如果不省略，则为@RequestMapping(value=“user”)
public class UserController {
@RequestMapping(“login”)
@ResponseBody
public String login() {
return “success”;
}
}

由于value属性是@RequestMapping注释的默认属性，因此如果只有唯一的属性，则可以省略该属性名，如果有超过一个属性，则必须写上value属性名称。即如下两个标注含义一样:
@RequestMapping(value=“login”)
@RequestMapping(“login”)

value属性支持通配符匹配：

@RequestMapping(value=“login/*”)；

即：http://localhost:8080/login/1或者http://localhost:8080/login/hahaha都能够正常访问该接口
此处通过URL：http://localhost:8080/user/login进行访问，将由login()方法进行处理

3. path

与value同义，path(value)（path 和 value 互相引用，参见RequestMapping接口源码）

path属性，和1中的value属性使用一致，两者都是用来作为映射使用的。

@RequestMapping(value=“login”)、@RequestMapping(path=“login”)，这两种情况都能对login()方法进行访问

path属性支持通配符匹配：

@RequestMapping(path=“login/*”)；

即：http://localhost:8080/login/1或者http://localhost:8080/login/abc都能够正常访问

4. method

指定请求类型， 如GET、POST、PUT、DELETE等；

@RequestMapping(value = “login”,method = RequestMethod.GET)
@ResponseBody
public String login() {
return “success”;
}

以上方法表示，该方法只支持GET请求。
此处也可以为:
@RequestMapping(value = “login”,method = {RequestMethod.GET,RequestMethod.POST})
说明该方法可以同时支持GET和POST请求。
如果没有method属性，则说明该方法支持全部的HTTP请求。

5. params

该属性指定，请求中必须包含params属性规定的参数时，才能执行该请求。

@RequestMapping(value = “login”,params = “flag”)
@ResponseBody
public String login() {
return “success”;
}

以上方法，说明请求中必须包含flag参数才能执行该请求，flag参数值不做要求

http://localhost:8080/login?flag=xxx // 正常访问

http://localhost:8080/login // 无法访问

@RequestMapping(value = “login”,params = “flag=true”)
@ResponseBody
public String login() {
return “success”;
}

以上方法，说明请求中必须包含flag参数，而且参数值必须为true才能执行该请求

http://localhost:8080/login?flag=true // 正常访问

http://localhost:8080/login?flag=false // 无法访问

http://localhost:8080/login // 无法访问

6. headers

1. 用于HTTP协义交互的信息被称为HTTP报文，客户端发送的HTTP报文被称为请求报文，服务器发回给客户端的HTTP报文称为响应报文，报文由报文头部和报文体组成。
2. 请求头部（Request Headers）：请求头包含许多有关客户端环境和请求正文的信息，例如浏览器支持的语言、请求的服务器地址、客户端的操作系统等。
3. 响应头部（Rsponse Headers）：响应头也包含许多有用的信息，包括服务器类型、日期、响应内容的类型及编码，响应内容的长度等等。

该属性指定，请求中必须包含某些指定的header值，才能够让该方法处理请求。
如Chrome浏览器：
可以通过点击F12（进入开发者模式）---->Network---->Name中点击网页---->右侧查看Headers即可。

7. produces

设置Response的Content-Type

spring MVC中如何设置应答体的content type呢?

    @RequestMapping(value = "/json")
    @ResponseBody  
    public String upload(HttpServletRequest request, HttpServletResponse response,String contentType2)  
            throws IOException {  
        Demo1 demo1 = new Demo1()
        String json = JsonUtils.objectToJson(Demo1);//一个json工具类，转换为json
        return json;  
    }    

这样做，虽然在客户端确实相应的的事json，但是response的Content-type确实text/html。会有些问题发生，若是json中包含有中文，会乱码。

解决办法：

    @RequestMapping(value="/pic/upload",produces=MediaType.TEXT_PLAIN_VALUE+";charset=utf-8")

Producible Media Types的解释:
你可以通过一个简化类型的列表来缩小主映射体，只有当Accept请求头与其中一个值匹配时，请求才会匹配。此外，使用生成条件确保所使用的实际内容类型

详情请查阅官方APIhttp://docs.spring.io/spring/docs/current/javadoc-api/org/springframework/http/MediaType.html

项目中：

@RequestMapping(value = "/getListYS", produces = {"application/json;charset=UTF-8;","application/json;"})

1. @RequestMapping 是一个用于映射请求到特定处理器方法的注解。
2. value = "/getListYS" 表示当HTTP请求的URL路径匹配/getListYS时，这个方法将被调用。
3. produces = {"application/json;charset=UTF-8;","application/json;"} 指定了这个方法响应的媒体类型（MIME类型）。这表示该方法将返回JSON格式的数据，并明确指定字符集为UTF-8。虽然第二个值"application/json;"有些冗余（因为它没有指定字符集），但它通常是为了确保与其他接受application/json但忽略字符集的客户端兼容。

============

原文链接：https://blog.csdn.net/m0_63102527/article/details/121062845
https://blog.csdn.net/Lovincc/article/details/73554693