⭕@RequestMapping

@RequestMapping("/user")
@RestController
public class UserController {@RequestMapping("/hello")public String say(){return "hello, Spring MVC";}
}

• @RequestMapping 是 GET 还是 POST 请求？

@RequestMapping("/user")
@RestController
public class UserController {@RequestMapping("/hello")public String say(String name){return "hello, "+name;}
}

public class User {private String name;private String password;public String getName() {return name;}public void setName(String name) {this.name = name;}public String getPassword() {return password;}public void setPassword(String password) {this.password = password;}@Overridepublic String toString() {return "Student{" +"name='" + name + '\'' +", password='" + password + '\'' +'}';}
}

就可以将形参换为自定义对象了：

@RequestMapping("/user")
@RestController
public class UserController {@RequestMapping("/login")public String login(User user){return user.toString();}
}

路径中的参数要与对应类的成员变量名保持一致：

3、参数重命名

在一些应用场景中，我们并不希望直接使用前端传来的参数名进行接收，就可以用 @RequestParam(" ") 注解来进行参数的重命名：

@RequestMapping("/user")
@RestController
public class UserController {@RequestMapping("/time")public String getTime(@RequestParam("time") String createtime){return "createtime: "+createtime;}
}

正常传参：

同样的，这时传递错误的参数名也会报 400 ：

说明使⽤ @RequestParam 进⾏参数重命名时，请求参数只能和 @RequestParam 声明的名称⼀致，才能进⾏参数绑定和赋值

不同的是，此时不传参也会报 400 ：

因为这时当形参前加上 @RequestParam() 注解时，该参数会默认变成必传参数，如果不传就会发生错误。

而有的时候业务上该参数可能是一个非必传参数，我们就可以通过设置 @RequestParam 中的required 来进行调整。

• required默认为 true，表示为必传参数。当把required设置为 false 时，就是非必传参数了：

@RequestMapping("/user")
@RestController
public class UserController {@RequestMapping("/time")public String getTime(@RequestParam(value="time",required=false) String createtime){return "createtime: "+createtime;}
}

不传参：

传错参：

这样设置后，即使不传参也不会报 400了。

4、传递数组与集合

@RequestMapping("/user")
@RestController
public class UserController {@RequestMapping("/array")public String getArray(String[] array){return Arrays.toString(array);}
}

方式二

类似的，Spring MVC 可以⾃动绑定集合参数的赋值，不过需要通过使⽤ @RequestParam 绑定参数关系：

@RequestMapping("/user")
@RestController
public class UserController {@RequestMapping("/list")public String getList(@RequestParam List<String> list){return "size:"+list.size()+" list:"+list;}
}

这样就能像获取数组一样将多个参数名一致的请求自动自动封装成集合类了：

默认情况下，请求中参数名相同的多个值，是封装到数组。如果要封装到集合，要使⽤

@RequestParam 绑定参数关系

5、获取路径参数

所谓路径参数就是指不以键值对的形式直接出现在url中的参数，举个栗子：

上面这个url中的 “1” 就是一个路径参数。让我们先来试试直接接收会发生什么：

@RequestMapping("/user")
@RestController
public class UserController {@RequestMapping("/text/{id}")public String getId(Integer id){return "id:"+id;}
}

注意：路径参数的url我们需要用 { } 来包裹起来

我们发现后端并不能够拿到路径参数。我们需要使用 @PathVariable 注解与请求URL路径上的数据绑定：

@RequestMapping("/user")
@RestController
public class UserController {@RequestMapping("/text/{id}")public String getId(@PathVariable Integer id){return "id:"+id;}
}

这样就能成功获取路径参数了：

• 获取多个路径参数：

@RequestMapping("/user")
@RestController
public class UserController {@RequestMapping("/text/{id}/{name}")public String getId(@PathVariable Integer id,@PathVariable String name){return "id:"+id+" name:"+name;}  
}

注意：如果后端要获取多个路径参数时，每个参数都会变成必传参数，因为后端无法判别是哪个路径参数没有传递，就会发生错误

6、传递JSON数据

RequestBody: 请求正⽂，意思是这个注解作⽤在请求正⽂的数据绑定，请求参数必须在写在请求正⽂中

我们先试试不加 @RequestBody 注解直接接收 JSON 对象会发生什么：

我们会发现后端并不能成功成功读取 JSON 对象。再用Fiddler抓包看看：

我们可以看到，JSON 对象的确成功传过去了。但后端却把  JSON 字符串当成了一个不可拆分的整体，所以这样拿不到传递的参数。

让我们再加上 @RequestBody 注解试试看：

@RequestMapping("/user")
@RestController
public class UserController {@RequestMapping("/login")public String login(@RequestBody User user){return user.toString();}
}

由此我们可以得出，当后端需要接收 JSON 对象时，需要在形参前加上 @RequestBody 注解，才能正确接收。

7、上传文件

主要通过 @RequestPart("file") 注解来实现：

@RequestMapping("/user")
@RestController
public class UserController {@RequestMapping("/file")public String getFile(@RequestPart("file")MultipartFile file) throws IOException {//获取文件名称String fileName=file.getOriginalFilename();//将文件上传至指定路径下file.transferTo(new File("D:/picture/"+fileName));return "文件名称:"+fileName;}
}

可以看到后端成功获取了文件的名称。在去指定路径下看看文件是否上传成功：

注意：如果文件过大就会导致上传失败了