SpringBoot教程(五) | SpringBoot中Controller详解

SpringBoot教程(五) | SpringBoot中Controller详解

SpringBoot整合SpringMvc其实千面一直讲的都是。只需要我们在pom文件中引入 web的starter就可以了，然后我们就可以正常使用springMvc中的功能了。所以本篇文章可能更多的是回顾，回顾一下springMVC中的一些常用的功能。

按照正常的流程，我们应该先讲一讲怎么配置视图解析器，但是已经提到了，现在都是前后端分离的项目，后端无需配置页面跳转，只需要返回数据即可，所以这一部分也没必要再讲了。那咱么就介绍下Controller中的常用写法。

上一次我们介绍了 @RestController 注解，这个注解会把所有的返回结果以json（json其实不太准确，应该是可序列化对象，大部分是json形式）的形式进行返回。我们今天来举个例子。

5.1关于@RestController注解

Controller代码：

java复制代码@RestController
public class SecondController {

    @RequestMapping("/second")
    public User second(){
        User u = new User("张胜男", 30,"女");
        return u;
    }
}

这里返回了一个User类。 User类代码如下：

java复制代码package com.lsqingfeng.springboot.vo;

/**
 * @className: User
 * @description:
 * @author: sh.Liu
 * @date: 2022-01-12 11:25
 */
public class User {

    private String name;

    private Integer age;

    private String gender;

    public User(String name, Integer age, String gender) {
        this.name = name;
        this.age = age;
        this.gender = gender;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public String getGender() {
        return gender;
    }

    public void setGender(String gender) {
        this.gender = gender;
    }
}

访问：http://localhost:9090/second 得到结果：

看到了返回的就是json类型的数据。这就是 @RestController的作用。如果不用@RestController，我们在方法上加上@ResponseBody是同样的效果。 @RestController注解就是@Controller和@ResponseBody 的组合。

5.2 关于@RequestMapping注解

@RequestMapping注解主要用于标识该Controller的请求地址路径。比如上面路径中的@RequestMapping(“/second”) 就代表通过 /second可以访问到这个接口。这个注解既可以放在类上，也可以放到方法上，如果类上也有这个注解，那么类中所有的controller在访问的时候，都要带上类上的路径才可以访问到。比如：

java复制代码@RestController
@RequestMappin("/test")
public class SecondController {

    @RequestMapping("/second")
    public User second(){
        User u = new User("张胜男", 30,"女");
        return u;
    }
    
    @RequestMapping("/third")
    public User third(){
        User u = new User("张胜", 50, "男");
        return u;
    }
}

比如上面的Controller, 那么我们访问的路径就变成了

ip:port/test/second ip:port/test/third

并且这也是现在最常用的方式，相当于类上的注解里的url作为一个大的分类（一般代表一个模块），方法是模块中的各个功能。

同时还要注意，如果方法上面使用了@RequestMapping 注解来进行标记，那么其实并没有限定这个方法用Http的哪种请求方式来进行访问，所以我们可以用Get请求，也可以用post请求。当然除了这些还有一下不太常用的Delete,put,optio等请求方式。比如我们最上边那个例子：

Get请求访问：

Post请求访问：

Delete请求访问：

但是一般情况下，我们都会限定这个接口只能一某一种请求方式访问，如何限制呢？

方法一： 通过RequestMapping中的参数

java复制代码@RestController
public class SecondController {

    @RequestMapping(value = "/second", method = RequestMethod.GET)
    public User second(){
        User u = new User("张胜男", 30,"女");
        return u;
    }
}

这时候就只能用Get请求来访问了。

其他请求方式会报错.

方法二： 使用限定请求方式的注解：

如果限定Get请求方式， 用@GetMapping 代替 @RequestMapping\

如果限定Post请求方式， 用@PostMapping 代替 @RequestMapping

比如限定Post请求方式：

java复制代码@RestController
public class SecondController {

    @PostMapping("second")
    public User second(){
        User u = new User("张胜男", 30,"女");
        return u;
    }
}

我们可以看下 @PostMapping注解的实现方式，其实跟方式一是一样的。

5.3关于Controller中传参

Get请求传参：

Get请求的参数传递都是通过在url后面拼接来进行传参的， 比如我们传一个name 和age 。url的写法如下：

localhost:9090/third?name=zhangsan&age=20

在请求的路径?后面表示参数，多个参数之间用 & 进行连接。 那么在Controller中如何接收Get请求传递过来的参数呢。方式很多，我们就说两种最常用的

1. 直接在Controller方法的参数中，用相同的变量名称接收参数。以上面的请求为例

java复制代码@GetMapping("third")
public String third(String name, Integer age){
    System.out.println(name);
    System.out.println(age);
    return "success";
}

成功获取参数：

1. 如果参数太多，用上面的方式来写，会导致方法中的参数过多，看起来很乱。所以我们也可以使用一个javaBean来接收。前期就是javaBean中的属性名要和参数名相同，同时要有get和set方法。

java复制代码@GetMapping("getParam")
public User getParam(User user){
    System.out.println(user);
    // 将接收到的参数直接返回
    return user;
}

User类，再给一下：

java复制代码package com.lsqingfeng.springboot.vo;

/**
 * @className: User
 * @description:
 * @author: sh.Liu
 * @date: 2022-01-12 11:25
 */
public class User {

    private String name;

    private Integer age;

    private String gender;

    public User(String name, Integer age, String gender) {
        this.name = name;
        this.age = age;
        this.gender = gender;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public String getGender() {
        return gender;
    }

    public void setGender(String gender) {
        this.gender = gender;
    }

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + ''' +
                ", age=" + age +
                ", gender='" + gender + ''' +
                '}';
    }
}

访问： http://localhost:9090/getParam?name=zhangsan&age=20

gender没有传值，所以是null, 参数接收成功：

Post请求传参

Post请求传参的方式，常用的有两种，一中是通过form表单进行传参（就是html中的form），还有一种是通过json的形式传参。目前来说用json的比较多。

1. Form传参

使用form传参，我们的Controller再接收的时候和上面一样可以直接接收上代码。

java复制代码@PostMapping("postForm")
public User postForm(String name, Integer age){
    User u = new User(name, age, null);
    return u;
}

post请求需要通过postman来模拟了，注意form传参的位置，要在body的form-data里

如果参数过多，我们也是可以通过一个javaBean来进行接收的。

java复制代码@PostMapping("postForm2")
public User postForm2(User user){
    return user;
}

2. Json 传参

通过json传递的参数，content-type一般为： application/json

我们在接收参数的时候要通过一个新的注解 @RequestBody 来进行标识。

java复制代码// 注意，User中一定要有无参构造方法
@PostMapping("postJson")
public User postJson(@RequestBody User user){
    return user;
}

通过json方式请求，看是否成功获取。

3. 关于@RequestParam注解

还有一种方式，这种方式不是很常用，但有的时候，跟三方接口对接的时候，不排除他们使用这种方式。

就是针对content-type是： application/x-www-form-urlcoded （Http协议中，如果不指定Content-Type，则默认传递的参数就是application/x-www-form-urlencoded类型）这是我在网上的资料中找到的，也验证了，如下：

java复制代码@PostMapping("postWWWForm")
public User postWWWForm(@RequestParam String name, @RequestParam Integer  age){
    return new User(name, age, null);
}

后来我把@RequestParam 注解去掉了，发现居然也可以接收到参数。其实这个注解就是用来接收普通参数的一个注解。正常情况下应该是可以省略的。什么时候不能省略呢，就是有时候这个参数是必填项，就是必须要传，那么我们可以在这个注解中标识是否必传和默认值。

@RequestParam(value="id",required =false,defaultValue ="10086") Integer id,

默认是true.

好了关于SpringBoot中Controller的传参方式我们就介绍这么多。如有错误也欢迎大家交流指正**。**