- 正确答案：RESTful 是一种基于 REST（Representational State Transfer，表述性状态转移）架构风格设计和实现 Web 服务的约定与实践。它不是协议或标准，而是一组约束原则，用于指导如何以统一、可扩展、无状态的方式构建 HTTP 接口。一个 RESTful API 的核心特征包括：使用标准 HTTP 方法（GET/POST/PUT/PATCH/DELETE）表达资源操作；通过 URI 唯一标识资源（如 /api/users/123）；资源表现形式（Representation）可选 JSON/XML；通信无状态（每个请求携带全部必要信息）；支持 HATEOAS（超媒体作为应用状态引擎）为进阶特性。 - 解答思路：理解 RESTful 需从“REST 架构风格的 6 大约束”出发，逐层展开：① 客户端-服务器分离（关注点分离）；② 无状态（服务端不保存会话状态，提升可伸缩性）；③ 可缓存（响应需明确声明是否可缓存及有效期，利用 HTTP Cache-Control、ETag 等机制）；④ 统一接口（含四子约束：资源识别、资源表述、自描述消息、HATEOAS）；⑤ 分层系统（允许中间代理、网关、负载均衡器介入，客户端无需感知后端拓扑）；⑥ 按需代码（Code-on-Demand，极少使用，如返回 JS 片段动态扩展客户端能力）。RESTful API 即是严格遵循这些约束（尤其前五条）的 HTTP 接口设计方式。 - 深度知识讲解： 1. 资源（Resource）是 REST 的核心抽象：一切皆资源，如用户、订单、图片等，用 URI 命名（/users、/users/123），URI 应是名词而非动词（避免 /getUserById），复数形式更通用（/products 而非 /product）。 2. HTTP 方法语义化（不是 CRUD 映射，而是 HTTP 动词本意）： - GET：安全（safe）、幂等（idempotent），用于获取资源表示，不得修改服务端状态； - POST：非幂等，用于创建子资源（如 POST /users 创建新用户）或触发非幂等动作（如提交表单）； - PUT：幂等，用于**全量替换**指定资源（如 PUT /users/123 替换整个用户对象），若资源不存在则创建； - PATCH：非幂等（但常设计为幂等），用于**局部更新**（如 PATCH /users/123，body 含 { "email": "new@x.com" }）； - DELETE：幂等，删除资源。关键区别：PUT 要求客户端发送完整资源表示，PATCH 发送变更描述（如 JSON Patch RFC 6902 或 Merge Patch RFC 7386）。 3. 状态码语义精准化：不仅是 200/404/500，需细粒度表达： - 200 OK：成功获取或 PUT/PATCH 成功（含响应体）； - 201 Created：POST 创建成功，响应头含 Location: /users/123； - 204 No Content：DELETE 或 PUT 成功但无响应体； - 202 Accepted：请求已接受但未处理完成（异步场景）； - 400 Bad Request：客户端数据格式错误（如 JSON 解析失败、字段缺失）； - 401 Unauthorized：认证失败（缺 Token 或过期）； - 403 Forbidden：认证成功但权限不足； - 404 Not Found：资源不存在（注意：不是“找不到 API 路由”，而是资源逻辑不存在）； - 405 Method Not Allowed：该 URI 不支持此 HTTP 方法； - 409 Conflict：因资源状态冲突无法执行（如乐观锁版本号不匹配）； - 422 Unprocessable Entity：语义错误（如邮箱格式非法），常用于 POST/PUT/PATCH 校验失败； - 429 Too Many Requests：限流触发。 4. 内容协商（Content Negotiation）：通过 Accept 请求头（如 Accept: application/json）和 Content-Type 响应头实现多格式支持；服务端可依据 Accept 头选择返回 JSON/XML/HTML，体现“表述性”本质。 5. HATEOAS 深度解析：REST 最后一环，要求响应中嵌入相关资源链接，使客户端无需硬编码 URI。例如 GET /users/123 返回： { "id": 123, "name": "Alice", "_links": { "self": { "href": "/users/123" }, "orders": { "href": "/users/123/orders" }, "update": { "href": "/users/123", "method": "PATCH" } } } 这使 API 具备“发现性”，客户端通过链接导航，解耦 URI 结构变更风险。Spring HATEOAS、HAL Browser 是典型实现。 6. 无状态的底层实现原理：服务端不存储 session（如 HttpSession），认证信息通过 Token（JWT）或 OAuth2 Bearer Token 在每次请求 Authorization 头中传递；用户上下文由客户端在每次请求中完整提供（如 User-ID + Token + 必要参数），服务端通过 Token 解析获得用户身份与权限，再查 DB 获取业务数据。这使服务可水平扩展，任意实例均可处理任一请求。 7. 缓存机制依赖 HTTP 原生头：服务端通过 Cache-Control（public/private/max-age/s-maxage）、Expires、ETag（实体标签）、Last-Modified 控制缓存行为；客户端或 CDN 根据这些头决定是否复用缓存。例如 GET /products 返回 ETag: "abc123"，下次请求带 If-None-Match: "abc123"，服务端比对后可直接返回 304 Not Modified，节省带宽。 - 伪代码示例（简化版 Spring Boot REST Controller）： @RestController @RequestMapping("/api/users") public class UserController { // GET /api/users → 查询用户列表（支持分页、过滤） @GetMapping public ResponseEntity> listUsers( @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "10") int size, @RequestParam(required = false) String name) { List users = userService.findByNameContaining(name, page, size); return ResponseEntity.ok(users); // 200 OK } // POST /api/users → 创建用户 @PostMapping public ResponseEntity createUser(@Valid @RequestBody User user) { User saved = userService.save(user); // 201 Created + Location header URI location = ServletUriComponentsBuilder .fromCurrentRequest() .path("/{id}") .buildAndExpand(saved.getId()) .toUri(); return ResponseEntity.created(location).body(saved); } // GET /api/users/{id} → 获取单个用户（含 HATEOAS 链接） @GetMapping("/{id}") public ResponseEntity> getUser(@PathVariable Long id) { User user = userService.findById(id); EntityModel model = EntityModel.of(user, linkTo(methodOn(UserController.class).getUser(id)).withSelfRel(), linkTo(methodOn(UserController.class).listUsers(0,10,null)).withRel("users"), linkTo(methodOn(OrderController.class).listUserOrders(id)).withRel("orders") ); return ResponseEntity.ok(model); // 自动序列化为 HAL+JSON } // PUT /api/users/{id} → 全量替换 @PutMapping("/{id}") public ResponseEntity replaceUser(@PathVariable Long id, @Valid @RequestBody User newUser) { User updated = userService.replace(id, newUser); return ResponseEntity.ok(updated); } // PATCH /api/users/{id} → 局部更新（使用 Map 或 JsonNode 接收补丁） @PatchMapping("/{id}") public ResponseEntity updateUserPartial(@PathVariable Long id, @RequestBody Map patch) { User updated = userService.patch(id, patch); return ResponseEntity.ok(updated); } // DELETE /api/users/{id} @DeleteMapping("/{id}") public ResponseEntity deleteUser(@PathVariable Long id) { userService.delete(id); return ResponseEntity.noContent().build(); // 204 No Content } }

北京开源小厂面经

全站热榜

创作者周榜