Spring MVC 接口数据

访问路径设置

@RequestMapping("springmvc/hello") 就是用来向handlerMapping中注册的方法注解!

秘书中设置路径和方法的对应关系，即@RequestMapping("/springmvc/hello")，设置的是对外的访问地址，

路径设置

精准路径匹配：

精准设置访问地址 /user/login，@RequestMapping 不要求必须以 / 开头（系统会默认在开头加上 / ）

模糊路径匹配：

路径设置为 /product/*

/* 为单层任意字符串 /product/a /product/aaa 可以访问此handler

/product/a/a 不可以

路径设置为 /product/**

/** 为任意层任意字符串

/product/a /product/aaa 可以访问此handler

/product/a/a 也可以访问

单层匹配和多层匹配：/*：只能匹配URL地址中的一层，如果想准确匹配两层，那么就写“/*/*”以此类推。/**：可以匹配URL地址中的多层。
其中所谓的一层或多层是指一个URL地址字符串被“/”划分出来的各个层次
这个知识点虽然对于@RequestMapping注解来说实用性不大，但是将来配置拦截器的时候也遵循这个规则。

类上和方法上的区别

类上提取公共部分，类上的不是必须有注解的，方法上是必须有注解的

//1.标记到handler方法
@RequestMapping("/user")
@RequestMapping("/user/login")
@RequestMapping("/user/register")
@RequestMapping("/user/logout")//2.优化标记类+handler方法
//类上
@RequestMapping("/user")
//handler方法上
@RequestMapping
@RequestMapping("/login")
@RequestMapping("/register")
@RequestMapping("/logout")

附带请求方式设定

method属性设置请求方式

@Controller
public class UserController {/*** 精准设置访问地址 /user/login* method = RequestMethod.POST 可以指定单个或者多个请求方式!* 注意:违背请求方式会出现405异常!*/@RequestMapping(value = {"/user/login"} , method = RequestMethod.POST)@ResponseBodypublic String login(){System.out.println("UserController.login");return "login success!!";}/*** 精准设置访问地址 /user/register*/@RequestMapping(value = {"/user/register"},method = {RequestMethod.POST,RequestMethod.GET})@ResponseBodypublic String register(){System.out.println("UserController.register");return "register success!!";}}

注解设置请求方式

- `@GetMapping`
- `@PostMapping`
- `@PutMapping`
- `@DeleteMapping`
- `@PatchMapping`

@RequestMapping(value = "/springmvc/hello", method = RequestMethod.GET)// 等于@GetMapping("/springmvc/hello")

但是

@GetMapping("/springmvc/hello") 只能添加在方法上

接收参数

Param格式参数：key=value&key=value

json格式参数：{key:value, key:value}

param参数接收

1/直接接收

@Controller
public class HelloController {@GetMapping("/springmvc/hello")// @ResponseBody 只直接返回字符串给前端，不要找视图解析器@ResponseBody// http://localhost:8080/springmvc/hello?age=2&name=liu// todo 即使不传，也不会报错，所以在接口内最好进行参数校验public String hello(int age, String name){System.out.println("HelloController.hello");return "hello springmvc!!";}
}

2/@RequestParam注解

可以设置是否必传，也可以设置默认值

value=“指定请求参数名”，默认与形参一致

@GetMapping(value="/data")
@ResponseBody
// http://localhost:8080/data?stuAge=2&name=liu
public Object paramForm(@RequestParam("name") String name, @RequestParam(value = "stuAge",required = false,defaultValue = "18") int age){System.out.println("name = " + name + ", age = " + age);return name+age;
}

一key多value

多选框，提交的数据的时候一个key对应多个值，我们可以使用集合进行接收！

@GetMapping("/param/mul")// @ResponseBody 只直接返回字符串给前端，不要找视图解析器@ResponseBody// http://localhost:8080/param/mul?hbs=吃&hbs=喝public String hello(@RequestParam List<String> hbs){System.out.println("HelloController.hello");return "hello springmvc!!";}

必须加@RequestParam，如果不加 @RequestParam ，会将 hbs 后的数据当作一个字符串直接赋值给 List<String> hbs

3/用实体接收

前端请求： http://localhost:8080/springmvc/hello?age=2&name=liu

可以不传，可以多传

定义一个用于接收参数的实体类：

public class User {private String name;private int age = 18;// getter 和 setter 略
}

@Controller
@RequestMapping("param")
public class ParamController {@RequestMapping(value = "/user", method = RequestMethod.POST)@ResponseBodypublic String addUser(User user) {// 在这里可以使用 user 对象的属性来接收请求参数System.out.println("user = " + user);return "success";}
}

路径参数接收

http://localhost:8080/springmvc/hello/23456

// 设置动态路经@GetMapping("/login/{account}/{password}")// @ResponseBody 只直接返回字符串给前端，不要找视图解析器@ResponseBody// @PathVariable String account 注解表示接收动态路经参数account位置的值// String account 表示接收param中key=account时对应的value值public String login(@PathVariable String account, @PathVariable String password){System.out.println("HelloController.hello");return "hello springmvc!!";}

路径参数与形参不一样时，也可以 @PathVariable("account") 注解指定

// 设置动态路经@GetMapping("/login/{account}/{password}")// @ResponseBody 只直接返回字符串给前端，不要找视图解析器@ResponseBody// @PathVariable String account 注解表示接收动态路经参数account位置的值// String account 表示接收param中key=account时对应的value值public String login(@PathVariable("account") String id, @PathVariable String password){System.out.println("HelloController.hello");return "hello springmvc!!";}

json参数接收

前端发送 JSON 数据的示例：

{"name": "张三","age": 18,"gender": "男"
}

定义一个用于接收 JSON 数据的 Java 类:

public class Person {private String name;private int age;private String gender;// getter 和 setter 略
}

controller：使用 @RequestBody 注解(即接收请求体)来接收 JSON 数据，并将其转换为 Java 对象

如果不加 @RequestBody ，那它接收的是param数据

@PostMapping("/person")
@ResponseBody
public String addPerson(@RequestBody Person person) {// 在这里可以使用 person 对象来操作 JSON 数据中包含的属性return "success";
}

利用postman验证之后发现报错：

原因：无法处理json

解决：1/导入json处理的依赖；2/handlerAdapter配置json转化器

pom.xml 加入jackson依赖：

<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.15.0</version>
</dependency>

@EnableWebMvc handlerAdapter配置json转化器

//json数据处理,必须使用此注解,因为他会加入json处理器

接收cookie数据

使用 @CookieValue 注释将 HTTP Cookie 的值绑定到控制器中的方法参数

JSESSIONID=415A4AC178C59DACE0B2C9CA727CDD84

@GetMapping("/demo")
public void handle(@CookieValue("JSESSIONID") String cookie) { //...
}

存cookie：

@GetMapping("save")public String save(HttpServletResponse response){Cookie cookie = new Cookie("JSESSIONID", "415A4AC178C59DACE0B2C9CA727CDD84");response.addCookie(cookie);return "ok";}

接收请求头数据

@RequestHeader 批注将请求标头绑定到控制器中的方法参数

Host                    localhost:8080
Accept                  text/html,application/xhtml+xml,application/xml;q=0.9
Accept-Language         fr,en-gb;q=0.7,en;q=0.3
Accept-Encoding         gzip,deflate
Accept-Charset          ISO-8859-1,utf-8;q=0.7,*;q=0.7
Keep-Alive              300

@GetMapping("/demo")
public void handle(@RequestHeader("Accept-Encoding") String encoding, @RequestHeader("Keep-Alive") long keepAlive) { //...
}

原生API对象操作？？？？

Controller method argument 控制器方法参数	Description
`jakarta.servlet.ServletRequest`, `jakarta.servlet.ServletResponse`	请求/响应对象
`jakarta.servlet.http.HttpSession`	强制存在会话。因此，这样的参数永远不会为 `null` 。
`java.io.InputStream`, `java.io.Reader`	用于访问由 Servlet API 公开的原始请求正文。
`java.io.OutputStream`, `java.io.Writer`	用于访问由 Servlet API 公开的原始响应正文。
`@PathVariable`	接收路径参数注解
`@RequestParam`	用于访问 Servlet 请求参数，包括多部分文件。参数值将转换为声明的方法参数类型。
`@RequestHeader`	用于访问请求标头。标头值将转换为声明的方法参数类型。
`@CookieValue`	用于访问Cookie。Cookie 值将转换为声明的方法参数类型。
`@RequestBody`	用于访问 HTTP 请求正文。正文内容通过使用 `HttpMessageConverter` 实现转换为声明的方法参数类型。
`java.util.Map`, `org.springframework.ui.Model`, `org.springframework.ui.ModelMap`	共享域对象，并在视图呈现过程中向模板公开。
`Errors`, `BindingResult`	验证和数据绑定中的错误信息获取对象！

/*** 如果想要获取请求或者响应对象,或者会话等,可以直接在形参列表传入,并且不分先后顺序!* 注意: 接收原生对象,并不影响参数接收!*/
@GetMapping("api")
@ResponseBody
public String api(HttpSession session , HttpServletRequest request,HttpServletResponse response){String method = request.getMethod();System.out.println("method = " + method);return "api";
}