一、接口声明的稳定性
- 接口声明不能轻易变：接口是前后端、服务间通信的约定。要是接口的 URL、请求方法、参数、返回值变了，调用方（比如前端、其他服务）就得跟着改，容易出问题。所以设计接口要谨慎，别老变动。
二、SpringMVC 接口示例
-
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 注解
网络编程三步骤
-
客户端和服务端建立连接：比如浏览器和 Tomcat 服务器通过 TCP 三次握手建立连接。
-
客户端发请求：浏览器发 HTTP 请求（包含 URL、请求方法、头信息、参数等）。
-
服务端收请求并响应：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 也能绑定。
六、总结
本节从接口设计、SpringMVC 注解、JSON 转换到网络编程基础、参数绑定，把 Web 开发的核心知识点串了起来。理解这些内容，能帮你搞定接口开发、前后端联调、错误排查等问题，在实际项目中少踩坑。