Spring MVC的常用注解(接收请求数据篇)

目录

@RequestMapping

例子:

@RequestMapping 支持什么类型的请求

        使 @RequestMapping 只支持特定的类型

@RestController

通过 HTTP 请求传递参数给后端

1.传递单个参数

        注意使⽤基本类型来接收参数的情况

2.传递多个参数

3.传递对象

4.@RequestParam 后端参数重命名(修改映射关系)

5.传递数组

6.传递集合

7.传递JSON数据 @RequestBody

8.获取URL中参数 @PathVariable

9.上传⽂件 @RequestPart

10.获取Cookie/Session @CookieValue @SessionAttribute HttpSession

11.获取Header @RequestHeader


@RequestMapping

       在 Spring MVC 中使⽤ @RequestMapping 来实现 URL 路由映射,也就是浏览器连接程序的作⽤ ,后面客户端访问服务器时 URL 中就要包含 @RequestMapping 中的参数

        路由映射:当⽤户访问⼀个 URL 时, 将⽤户的请求对应到程序中某个类的某个⽅法的过程就叫路由映射.

例子:

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

        如上的代码,对于类 UserController,@RequestMapping 注解中的参数为 /UserController ,对于方法 sayHi(),@RequestMapping 注解中的参数为 /sayHi ,这就说明,客户端发送的 HTTP 请求要是想访问到 sayHi()这个方法,URL 中的路径就应该有 /UserController/sayHi,假如在本机上访问 URL 就应该为 127.0.0.1:8080/UserController/sayHi

        我们可以看到如下的效果

Spring MVC的常用注解(接收请求数据篇)_第1张图片

@RequestMapping 支持什么类型的请求

        我们知道 HTTP 请求分为 Get,Post 等类型,那 @RequestMapping 注解支持什么类型的 HTTP 请求呢?

        @RequestMapping 支持所有类型的请求,无论 HTTP 请求是 Get 还是 Post 都能够正确的响应

        使 @RequestMapping 只支持特定的类型

        可能我们在开发时有特殊的要求,需要只支持特定类型的 HTTP 请求

@RequestMapping(value = "/sayHi/post",method = RequestMethod.POST)
    public String sayHiPost(){
        return "hello,Spring,post";
    }

        当我们如上所示在 @RequestMapping 注解中设置 method 属性以后就可以使 sayHiPost 方法只处理 Post 类型的请求

        


@RestController

        同样也用下面这个代码作为例子

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

        当我们把类前面的 @RestController 这个注解删掉,会发送什么样的效果呢?

Spring MVC的常用注解(接收请求数据篇)_第2张图片

        当我们把 @RestController 注解删掉以后再次通过之前的 URL 访问就发现报了404(找不到系统资源)错误

        因为在一个 Spring MVC 项目中会有很多的类,Spring 如何知道要根据 URL 到哪些类中去寻找对应的方法呢,就是通过 @RestController 注解,只有类加上了 @RestController 注解,Spring 才会去进行访问,查找类中方法的 @RequestMapping 注解是否符合要求 ,才能找到对应的资源

        上面我们把 UserController 类的 @RestController 注解删掉,Spring 在遍历的时候就不会去访问 UserController 类,也就找不到 sayHi()方法,所以浏览器就显示了 404(找不到系统资源)错误


通过 HTTP 请求传递参数给后端

        传递不同的参数会需要用到不同的注解

1.传递单个参数

        接收单个参数,在 Spring MVC 中直接⽤⽅法中的参数就可以,⽐如以下代码:

@RequestMapping("/getName")
    public String getName(String name){
        return "name:"+name;
    }

        我们通过浏览器发送一个携带参数的 HTTP 请求查看获取参数的效果

Spring MVC的常用注解(接收请求数据篇)_第3张图片

        如上图,我们在 HTTP 请求的 Query String 中携带了 KEY为 name 的键值对,Spring 会自动获取 HTTP 请求中的键值对,将键值对的 KEY 值和方法中的形参名进行对比,要是相同就将 KEY 对应的 VALUE 赋值给形参

        注意使⽤基本类型来接收参数的情况

@RequestMapping("/getAge")
    public String getAge(int age){
        return "age:"+age;
    }

        如上的代码,我们接收 age 用的是 int 类型,假设我们发送的 HTTP 请求没有给 age 传参就会出现下面的情况

        Spring MVC的常用注解(接收请求数据篇)_第4张图片

        同时,在服务器日志中会有以下的报错信息

        意思就是,int 类型的变量不能被置为 null ,因为要是 HTTP 请求访问对应的方法时,没有给方法传参,Spring 就会自动将方法需要的参数设置为 null ,而基本类型是无法设置为 null 的,所以要是在服务器中用基本类型来接收参数的话,HTTP 请求就必须要传参

        当然这是很麻烦的,所以我们通常不用基本类型来接收 HTTP 请求携带的参数,而是用对应的包装类,比如 int 的包装类 Integer

2.传递多个参数

和接收单个参数⼀样,直接使⽤⽅法的参数接收即可.使⽤多个形参.

@RequestMapping("/getNameAge")
    public String getNameAge(String name,Integer age){
        return "name:"+name+" age:"+age;
    }

        Spring 会自动获取 HTTP 请求中 Query String(GET) 或 body (POST)中传递的参数,将参数的 KEY 值与方法的 形参名进行匹配,匹配成功以后就将 Value 赋值给对应的形参

3.传递对象

        如果参数⽐较多时,⽅法声明就需要有很多形参.并且后续每次新增⼀个参数,也需要修改⽅法声明.我们不妨把这些参数封装为⼀个对象,后面如果传递的参数需要改变的话,直接修改对象就可以了,不用修改方法

        定义一个 Person 对象来接收参数

public class Person {
    private int id;
    private String username;
    private String password;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    @Override
    public String toString() {
        return "Person{" +
                "id=" + id +
                ", username='" + username + '\'' +
                ", password='" + password + '\'' +
                '}';
    }
}

        

 @RequestMapping("/getPerson")
    public String getPerson(Person person){
        return "person:"+person.toString();
    }

        如上代码,当 HTTP 请求访问 getPerson 方法时,Spring 就会去获取 HTTP 请求中的键值对,将键值对的 Key 值与 Person 对象的属性值进行匹配,匹配成功后便将 Value 赋值给对应的属性,初始化对象

 得到如下的效果:

4.@RequestParam 后端参数重命名(修改映射关系)

        在某些情况下,前端传递的 Key 值与后端的参数名可能不一致,这样就会导致传参失败,比如前端传递了一个 Key 值为 name 的属性,而后端却用 username 这个形参来接收,那肯定就会导致接收失败

        所以,如果我们想要使用 username 这个形参来接收 Key 值为 name 对应的 Value ,我们就要通过 @RequestParam 注解修改前后端参数之间的映射关系

@RequestMapping("/getUsername")
    public String getUsername(@RequestParam("name") String username){
        return "username:"+username;
    }

得到的结果如下

Spring MVC的常用注解(接收请求数据篇)_第5张图片

        但这也会导致一些问题出现,当我们不给 getUsername()方法传递参数时,会出现下面的情况

Spring MVC的常用注解(接收请求数据篇)_第6张图片

        此时我们的 HTTP 请求没有携带参数给 getUsername()方法,所以导致出现了 400(客户端错误),这是因为 @RequestParam 注解有个 required 属性默认为 true ,这就导致使用 @RequestParam 注解修改映射关系以后,方法中的形参就变为了一个必传参数,要是没传就会报错

        解决方法:将 required 属性改为 false 

 @RequestMapping("/getUsername")
    public String getUsername(@RequestParam(value = "name" ,required = false) String username){
        return "username:"+username;
    }

5.传递数组

        HTTP 请求中的参数名和后端方法中数组类型的形参名相同,且参数有多个,Sping 就会自动把所有的 Value 值传递给后端方法的数组中

@RequestMapping("/getArrayName")
    public String getArrayName(String[] arrayName){
        return arrayName.toString();
    }

        得到的结果如下:

Spring MVC的常用注解(接收请求数据篇)_第7张图片

6.传递集合

        传递集合与传递数组类似,都是 HTTP 请求中的一个参数对应多个值

        但 Spring 默认 HTTP 请求中一个参数对应多个值这种情况要将值传递给数组,如果我们要传递给列表的话,就需要使用 @RequestParam 注解绑定参数关系

@RequestMapping("/getListName")
    public String getListName(@RequestParam List listName){
        return "listName:"+listName;
    }

        得到的结果如下

Spring MVC的常用注解(接收请求数据篇)_第8张图片

7.传递JSON数据 @RequestBody

        企业中传递数据最普遍的便是通过 JSON 格式来传递数据,JSON就是⼀种数据格式,有⾃⼰的格式和语法,使⽤⽂本表⽰⼀个对象或数组的信息,因此 JSON本质是字符串.主要负责在不同的语⾔中数据传递和交换.关于 JSON 推荐看应用层自定义协议(组织数据的格式)

        Spring MVC框架也集成了JSON的转换⼯具,我们可以直接使⽤,来完成JSON字符串和Java对象的互转

        接收 JSON 格式的数据,我们需要用到 @RequestBody 这个注解,这个注解翻译过来是请求正文,所以我们传递的数据必须是在正文(body)中,当然传递 JSON 格式的数据通常也是放到 HTTP 请求的 body 中传输的

@RequestMapping("/getJson")
    public String getJson(@RequestBody Person person){
        return person.toString();
    }

        得到的结果如下:

Spring MVC的常用注解(接收请求数据篇)_第9张图片

        在 json 格式的数据转换成 java 对象的过程中,Spring 会去获取到 HTTP 请求中的 json 字符串,并获取到 Person 对象中的属性,将 json 字符串中的 Key 值与 Person 对象中的属性名进行对比,要是相同就将 Key 对应的 Value 通过 Person 类中的 set 方法进行赋值

8.获取URL中参数 @PathVariable

        该注解翻译过来是路径变量,主要作⽤在请求URL路径上的数据绑定,可以获取到 URL 指定位置上的数据

@RequestMapping("/getUrlPath/{id}/{name}")
    public String getUrlPath(@PathVariable Integer id,@PathVariable String name){
        return "id:"+id+" name:"+name;
    }

 得到的结果如下:

Spring MVC的常用注解(接收请求数据篇)_第10张图片

9.上传⽂件 @RequestPart

代码实现

@RequestMapping("/getFile")
    public String getFile(@RequestPart MultipartFile file) throws IOException {
        //获取文件名称
        String fileName=file.getOriginalFilename();
        //文件上传到指定路径
        file.transferTo(new File("D:/图片/"+fileName));
        return "文件的名称为"+fileName;
    }

        通过 postman 构造 HTTP 请求发送文件,效果如下

Spring MVC的常用注解(接收请求数据篇)_第11张图片

10.获取Cookie/Session @CookieValue @SessionAttribute HttpSession

.获取 Cookie 代码:

@RequestMapping("/getCookie")
    public String getCookie(@CookieValue(required = false) String name){
        return "cookie:"+name;
    }

获取 Session 代码1:

@RequestMapping("/getSession1")
    public String getSession1(@SessionAttribute(required = false) String name){
        return "name:"+name;
    }

获取 Session 代码2:

通过Spring MVC内置对象 HttpSession 来获取 

 @RequestMapping("/getSession2")
    public String getSession2(HttpSession session){
        // Session 的相关数据保存到 session 对象中了
        String name=(String) session.getAttribute("name");
        return "name:"+name;
    }

使用内置对象 HttpSession 相当于HttpSession session = request.getSession();

getSession()方法的默认参数是 true ,所以要是没有找到 Session 会创建一个 Session

11.获取Header @RequestHeader

获取 Header 代码:

@RequestMapping("/getHeader")
    public String getHeader(@RequestHeader("User-Agent") String userAgent){
        return "User-Agent"+userAgent;
    }

结果如下:

        在 HTTP 请求的 Header 中 User-Agent 属性对应用户的配置信息和浏览器版本,如上图,成功展示

你可能感兴趣的:(spring,spring,mvc,java)