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

SpringMVC2

news 2025/7/15 15:04:15

一、接口声明的稳定性

- 接口声明不能轻易变：接口是前后端、服务间通信的约定。要是接口的 URL、请求方法、参数、返回值变了，调用方（比如前端、其他服务）就得跟着改，容易出问题。所以设计接口要谨慎，别老变动。

二、SpringMVC 接口示例

- 请求 URL： http://127.0.0.1:8080/request/6&sa=lyb_n_homepage

- 127.0.0.1 是本地地址， 8080 是 Tomcat 端口， /request/6 是 URL 路径， sa=lyb_n_homepage 是查询参数（ sa 是参数名， lyb_n_homepage 是参数值）。

- Controller 代码：
@RequestMapping("/rs")
public String rc(@RequestParam("sa") String resource) {
return "接收到参数 resource: " + resource;
}

- @RequestMapping("/rs") ：把 /rs 路径映射到这个方法，支持 GET、POST 等请求。

- @RequestParam("sa") ：把请求中名为 sa 的参数绑定到 resource 变量。

- 必传 vs 非必传：默认 required = true （必传），如果改成 @RequestParam(value = "sa", required = false) ，就是非必传，没传 sa 参数也不会报错。

- 返回值：方法返回字符串，会直接返回给客户端（比如浏览器显示“接收到参数 resource: lyb_n_homepage”）。

三、JSON 与 Java 对象转换库

- Jackson：SpringBoot 默认的 JSON 处理库，能把 Java 对象转成 JSON，也能把 JSON 转成 Java 对象。

- Fastjson/Fastjson2：阿里巴巴出的库，性能好，API 简单，很多企业在用。

- Gson：Google 出的库，功能全，也很好用。

四、网络编程与 SpringMVC 注解

网络编程三步骤

1. 客户端和服务端建立连接：比如浏览器和 Tomcat 服务器通过 TCP 三次握手建立连接。

2. 客户端发请求：浏览器发 HTTP 请求（包含 URL、请求方法、头信息、参数等）。

3. 服务端收请求并响应：Tomcat 收请求，SpringMVC 处理，再返回响应（比如 HTML 页面、JSON 数据）。

@RequestMapping 注解

- 作用：既可以标记类，也可以标记方法，用来映射 URL 路径。

- 标记类：类上的 @RequestMapping 是父路径，方法上的是子路径，组合起来就是完整的 URL。

- 标记方法：直接映射方法到 URL。

- 支持的请求方法：默认支持 GET、POST 等，也可以用 method 属性指定（比如 method = RequestMethod.GET 只支持 GET）。

- 路径不能重复：如果有两个相同的 URL 映射，启动时会报 Ambiguous mapping 错误（比如两个方法都映射到 /hello ）。

请求方法不支持的错误

- 错误信息：

- 日志： Resolved [org.springframework.web.HttpRequestMethodNotSupportedException: Request method 'POST' not supported]

- 页面： Whitelabel Error Page ，状态码 405（Method Not Allowed）。

- 原因：比如接口只支持 GET，你用 POST 请求，就会报这错。

@RequestMapping 的属性

- value 属性：指定 URL 路径，是默认属性。如果注解里只有 value ，可以省略 value = ，比如 @RequestMapping("/hello") 。

- method 属性：指定支持的请求方法，比如 RequestMethod.GET 、 RequestMethod.POST 。

- 示例：

- @RequestMapping(value = "/v1", method = RequestMethod.GET) ：只支持 GET 请求，路径是 /v1 。

- @RequestMapping(value = "/v2", method = {RequestMethod.GET, RequestMethod.POST}) ：同时支持 GET 和 POST 请求。

五、参数绑定问题

- 类型转换错误：比如方法参数是 int age ，但请求没传 age ，或者传了非数字，会报 NumberFormatException 或 MethodArgumentTypeMismatchException 。

- 解决：把参数类型改成包装类（比如 Integer age ），这样没传参数时 age 是 null ，不会报错。

- 参数顺序无关，名称要一致：方法参数名要和请求参数名一致，顺序没关系。比如方法 public String test(String name, String password) ，请求参数 name=zhangsan&password=123 能正确绑定，改成 password=123&name=zhangsan 也能绑定。