Java之Spring MVC篇三

响应

返回静态页面

@RestController 和 @Controller的区别和联系

返回数据@ResponseBody

响应

返回静态页面

首先在resourses/static路径下创建一个html文件：

<!DOCTYPE html>
<html lang="en">
<head>
 <meta charset="UTF-8">
 <title>Index⻚⾯</title>
</head>
<body>
 Hello,Spring MVC,我是Index⻚⾯.
</body>
</html>

处理并返回index.html的代码

@RestController
public class ResponseController {
    @RequestMapping("/index")
    public String index(){
        return "/index.html";
    }
}

响应结果：

结果却发现, ⻚⾯未正确返回, http响应把 "/index.html" 当做了http响应正⽂的数据
那Spring MVC如何才能识别出来 index.html 是⼀个静态⻚⾯, 并进⾏返回呢?
我们需要把 @RestController 改为 @Controller。

修改后的代码：

@Controller
public class ResponseController {
    @RequestMapping("/index")
    public String index(){
        return "/index.html";
    }
}

响应结果：

@RestController 和 @Controller的区别和联系

@RestController=@ResponseBody+@Controller

联系

1.组合关系：@RestController 可以被视为 @Controller 和 @ResponseBody 的组合注解。这意味着，当你在类上使用 @RestController 注解时，它实际上同时应用了 @Controller 和 @ResponseBody 的效果。
2.用途相似：两者都用于处理 HTTP 请求，但它们处理请求后返回的内容类型不同。

区别

1.返回内容类型：
@Controller：用于处理 HTTP 请求，并将处理结果返回给客户端。控制器类中的方法通常通过 @RequestMapping 或其衍生注解来映射特定的 URL 请求路径和 HTTP 方法。返回的结果可以是一个视图名称，框架会根据视图解析器将其解析为具体的视图页面（如 HTML 页面）。
@RestController：专门用于构建 RESTful API。与 @Controller 不同的是，@RestController 注解的类中的每个方法都默认返回 JSON、XML 或其他数据类型，而不是视图。在 Spring MVC 中，使用 @RestController 相当于在每个方法上都添加了 @ResponseBody 注解，用于直接返回数据对象或集合，而不是视图。
2.应用场景：
@Controller：通常用于传统的 Web 应用开发，负责处理 HTTP 请求，并返回视图页面。它适用于需要渲染视图页面的场景，如动态网站开发。
@RestController：则专门用于构建 RESTful API，处理 HTTP 请求，并直接返回数据对象或集合，而不是视图。它适用于构建微服务、移动应用后端服务等需要直接提供数据接口的场景。
默认行为：
使用 @Controller 注解的类，其方法默认返回的是视图名称，需要配合视图解析器来渲染视图。
使用 @RestController 注解的类，其方法默认返回的是 JSON、XML 等数据格式，Spring MVC 会自动将数据对象序列化为相应的格式，并设置正确的 HTTP 响应头。

返回数据@ResponseBody

    @ResponseBody
    @RequestMapping("/indexData")
    public String indexData(){
        return "返回数据";
    }

关于@ResponseBody

@ResponseBody 既是类注解, ⼜是⽅法注解
如果作⽤在类上, 表⽰该类的所有⽅法, 返回的都是数据, 如果作⽤在⽅法上, 表⽰该⽅法返回的是数据.

因此，如果一个类的方法里面，既有返回数据的，又有返回页面（视图）的，就给添加@Controller注解，在返回数据的方法上添加@ResponseBody注解即可。

@Controller
public class ResponseController {
    @RequestMapping("/index")
    public String index(){
        return "/index.html";
    }

    @ResponseBody
    @RequestMapping("/indexData")
    public String indexData(){
        return "返回数据";
    }
}

如果没有给返回数据的方法添加@ResponseBody注解，会报错且状态码为404

@Controller
public class ResponseController {
    @RequestMapping("/index")
    public String index(){
        return "/index.html";
    }

    @ResponseBody
    @RequestMapping("/indexData")
    public String indexData(){
        return "返回数据";
    }
}

返回HTML代码片段

    @ResponseBody
    @RequestMapping("/indexData2")
    public String indexData2(){
        return "<h1>我是中国人</h1>";
    }

响应：

通过fiddler抓包：

响应中的 Content-Type 常⻅取值有以下⼏种:
• text/html : body 数据格式是 HTML
• text/css : body 数据格式是 CSS
• application/javascript : body 数据格式是 JavaScript
• application/json : body 数据格式是 JSON
如果请求的是js⽂件, Spring MVC会⾃动设置Content-Type为 application/javascript
如果请求的是css⽂件, Spring MVC会⾃动设置Content-Type为 text/css

返回JSON

    @ResponseBody
    @RequestMapping("/getMap")
    public HashMap<String,String> getMap(){
        HashMap<String,String> map = new HashMap<>();
        map.put("k1","v1");
        map.put("k2","v2");
        map.put("k3","v3");
        map.put("k4","v4");
        return map;
    }

通过fiddler抓包：

设置状态码

Spring MVC会根据我们⽅法的返回结果⾃动设置响应状态码, 程序员也可以⼿动指定状态码
通过Spring MVC的内置对象HttpServletResponse 提供的⽅法来进⾏设置：

    @ResponseBody
    @RequestMapping("/setStatus")
    public String setStatus(HttpServletResponse response){
        response.setStatus(418);
        return "设置状态码";
    }

响应：

通过fiddler抓包：

设置Header

Http响应报头也会向客⼾端传递⼀些附加信息, ⽐如服务程序的名称,请求的资源已移动到新地址等, 如:Content-Type, Local等.
这些信息通过 @RequestMapping 注解的属性来实现.

下面我们看看@RequestMapping的源码：

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
@Reflective(ControllerMappingReflectiveProcessor.class)
public @interface RequestMapping {

	String name() default "";

	@AliasFor("path")
	String[] value() default {};

	@AliasFor("value")
	String[] path() default {};

	RequestMethod[] method() default {};

	String[] params() default {};

	String[] consumes() default {};

	String[] produces() default {};

}

说明：

1. value: 指定映射的URL
2. method: 指定请求的method类型, 如GET, POST等
3. consumes: 指定处理请求(request)的提交内容类型(Content-Type)，例如application/json,
text/html;
4. produces: 指定返回的内容类型，仅当request请求头中的(Accept)类型中包含该指定类型才返回
5. Params: 指定request中必须包含某些参数值时，才让该⽅法处理
6. headers: 指定request中必须包含某些指定的header值，才能让该⽅法处理请求

设置Content-Type

没设置Content-Type之前

    @ResponseBody
    @RequestMapping("/setContentType")
    public String setContentType(){
        return "{\"OK\":1}";
    }

通过fiddler抓包：

设置Content-Type之后

    @ResponseBody
    @RequestMapping(value = "/setContentType1", produces = "application/json")
    public String setContentType1(){
        return "{\"OK\":1}";
    }

通过fiddler抓包：