当前位置：首页 > news >正文

Java高级 | 【实验二】控制器类+相关注解知识

news 2025/6/6 16:56:17

隶属文章： Java高级 | （二十二）Java常用类库-CSDN博客

系列文章： Java高级 | 【实验一】Spring Boot安装及测试最新-CSDN博客

一、MVC模式

MVC(Model View Controller)，是软件开发的一种思想，他把软件系统分为以下三部分：

Model(模型)：用来处理程序中数据逻辑的部分

View(视图)：在应用程序中，专门和浏览器进行交互，展示数据的资源

Contreller(控制器)：负责协调视图和模型之间的交互，主要功能是处理视图发来的请求。即，根据请求决定使用用哪一个模型来处理，以及处理完后需要跳回到哪一个视图，也就是用来连接视图和模型的。

MVC 它是一种思想，而SpringMVC 它是将这种思想进行了实现。SpringBoot 只是实现 SpringMVC 的一种方式。

二、SpringBoot基础之控制层Controller详解

1.Controller层主要工作

从HTTP请求中获取信息，提取参数，并将其分发给不同的处理服务（service层），并向前端返回service层处理后的数据（JSON数据或者ModelAndView对象）。

2.Controller层重要注解

Controller层主要包含了以下6个注解。

@Controller
@RequestMapping
@ResponseBody
@RestController
@GetMapping
@PostMapping

1、@Controller

@controller注解用于标识一个Java 类是一个控制器。

2、@RequestMapping

@RequestMapping注解告知Spring的控制器类或者函数映射到哪个URL，通常@RequestMapping参数有：

（1）注解在方法上

@RestController

public class UserController {

// 映射到方法上

// localhost:8080/user/login

@RequestMapping("/user/login")

public String login() {

return "user login";

}

// localhost:8080/user/register

@RequestMapping("/user/register")

public String register() {

return "user register";

}

（2）注解在类和方法上

@Controller
//@RestController
@ResponseBody
@RequestMapping("/user")
public class UserController {
    @RequestMapping("/login")
    public String login() {
        return "user login";
    }
@RequestMapping("/register")

public String register() {
return "user register";
}
}

（3）用 @RequestMapping 处理 HTTP 的各种方法

@RequestMapping中使用method 属性来声明HTTP请求所使用的方法类型。

@RestController
@RequestMapping("/home")
public class IndexController {
    @RequestMapping(method = RequestMethod.GET)
    public String get() {
        return "Hello from get";
    }
    @RequestMapping(method = RequestMethod.DELETE)
    public String delete() {
        return "Hello from delete";
    }
    @RequestMapping(method = RequestMethod.POST)
    public String post() {
        return "Hello from post";
    }
    @RequestMapping(method = RequestMethod.PUT)
    public String put() {
        return "Hello from put";
    }
    @RequestMapping(method = RequestMethod.PATCH)
    public String patch() {
        return "Hello from patch";
    }
}

（4）@RequestMapping 来处理多个 URI

@RestController

@RequestMapping("/home")

public class MultipleMapping {

@RequestMapping(value = {

"",

"/page",

"page*",

"view/*,**/msg"

})

String indexMultipleMapping() {

return "Hello from index multiple mapping.";

}

（5）带有 @RequestParam 的 @RequestMapping

@RequestParam 注解配合 @RequestMapping 一起使用，可以将请求的参数同处理方法的参数绑定在一起。

@RestController
@RequestMapping("/home/getvalue")
public class ParamRequestMapping {
    @RequestMapping(value = "/id")//http://localhost:8080/home/getvalue/id?id=1234
        // 实现请求参数 id 与处理方法参数 personId 的绑定。
    String getIdByValue(@RequestParam("id") String personId) {
        System.out.println("ID is " + personId);
        return "Get ID from query string of URL with value element"+personId;
    }
    @RequestMapping(value = "/personId")//http://localhost:8080/home/getvalue/personId?personId=7894
    String getId(@RequestParam String personId) {
        System.out.println("ID is " + personId);
        return "Get ID from query string of URL without value element";
    }
    @RequestMapping(value = "/name")//http://localhost:8080/home/getvalue/name?person=tom
    String getName(@RequestParam(value = "person", required = true) String personName) {
        return "Required element of request param"+personName;
    }
    /*
    下面方法可以处理下列URL
    /home/name?person=xyz
    /home/name
     */
    @RequestMapping(value = "/getname")//http://localhost:8080/home/getvalue/getname?person=tom
    String getNameOfrequiredIsFalse(@RequestParam(value = "person", required = true) String personName) {
        return "Required element of request param"+personName;
    }
    /*
    下面方法是当用户没有传入person参数时，系统默认person=Tom
    /home/name?person=xyz
    /home/name
     */
    @RequestMapping(value = "/getnametwo")
    String getNameByDefaultValue(@RequestParam(value = "person", defaultValue = "John") String personName) {
        return "Required element of request param"+personName;
    }
}

（5）使用 @RequestMapping 的header属性来处理消息头

post() 方法能同时接受 text/plain 还有 text/html 的请求

@RestController

@RequestMapping("/home")

public class ControllHeader {

@RequestMapping(value = "/head", headers = {

"content-type=text/plain",

"content-type=text/html"

})

public String post() {

return "Mapping applied along with headers";

}

（6）使用 @RequestMapping 的params属性来处理请求参数

@RestController

@RequestMapping("/switch")

public class ControllSwitch {

@RequestMapping(value = "/fetch", params = {

"personId=10"

})

String getParams(@RequestParam("personId") String id) {

return "Fetched parameter using params attribute = " + id;

}

@RequestMapping(value = "/fetch", params = {

"personId=20"

})

String getParamsDifferent(@RequestParam("personId") String id) {

return "Fetched parameter using params attribute = " + id;

}

getParams() 和 getParamsDifferent() 两个方法都能处理相同的一个 URL (/home/fetch) ，但是会根据 params 元素的配置不同而决定具体来执行哪一个方法。

（7）使用 @RequestMapping 处理动态 URI

@RestController

@RequestMapping("/dynamic")

public class ControllerDynamicUriValue {

//http://localhost:8080/dynamic/fetch/10

@RequestMapping(value = "/fetch/{id}", method = RequestMethod.GET)

String getDynamicUriValue(@PathVariable String id) {

System.out.println("ID is " + id);

return "Dynamic URI parameter fetched";

}

//http://localhost:8080/dynamic/fetch/tye/tom

@RequestMapping(value = "/fetch/{id:[a-z]+}/{name}", method = RequestMethod.GET)

String getDynamicUriValueRegex(@PathVariable("name") String name) {

System.out.println("Name is " + name);

return "Dynamic URI parameter fetched using regex";

}

3、@ResponseBody

@ResponseBody 注解表示方法的返回值应该直接写入 HTTP 响应体中，而不是被解析为视图。正常情况下，Controller类中函数返回是一个模板对象（页面），但是有时候我们希望返回值数值型（字符串或者Json格式数据），这时就需要添加@ResponseBody注解。@ResponseBody注解可以添加到类或者函数上。

@ResponseBody返回的是数据

4、@RestController

@RestController是一个组合注解，它结合了 @Controller 和 @ResponseBody 注解的功能（就相当于把两个注解组合在一起）。在使用 @RestController 注解标记的类中，每个方法的返回值都会以 JSON 或 XML 的形式直接写入 HTTP 响应体中，相当于在每个方法上都添加了 @ResponseBody 注解。