java API接口啥是REST

发布时间：2026-10-02 12:37:04 来源：亿速云阅读：98 作者：小樊栏目：编程语言

在 Java 里常说的 REST API（RESTful API），意思是用 HTTP 协议、按照 REST 风格设计的接口。

一、什么是 REST？

REST = Representational State Transfer（表现层状态转移）

它是一种接口设计风格/规范，不是协议，也不是框架。

核心思想：

用 URL 表示资源，用 HTTP 方法表示操作

二、REST 接口长什么样？

1️⃣ 资源用 URL 表示

/users          // 用户集合
/users/1        // id=1 的用户
/orders/100     // 订单

2️⃣ 用 HTTP 方法表示“做什么”

HTTP 方法	含义	例子
GET	查询	GET /users
POST	新增	POST /users
PUT	修改（整体）	PUT /users/1
DELETE	删除	DELETE /users/1

三、一个简单对比（非 REST vs REST）

❌ 不 REST 的写法

GET /getUser?id=1
POST /deleteUser

✅ REST 写法

GET /users/1
DELETE /users/1

四、Java 里 REST API 常见样子（Spring Boot）

@RestController
@RequestMapping("/users")
public class UserController {

    @GetMapping("/{id}")
    public User getUser(@PathVariable Long id) {
        return userService.getById(id);
    }

    @PostMapping
    public User createUser(@RequestBody User user) {
        return userService.save(user);
    }
}

访问：

GET http://localhost:8080/users/1
POST http://localhost:8080/users

五、REST 的特点（重点）

✅ 无状态（每次请求都带完整信息）
✅ 统一接口（URL + HTTP 方法）
✅ 可缓存（GET 可缓存）
✅ 前后端分离友好

六、一句话总结

REST API 就是用 HTTP 地址表示“资源”，用 GET/POST/PUT/DELETE 表示“操作”的接口风格。

如果你愿意，我也可以帮你：

用 Spring Boot 写完整 REST 示例
区分 REST / RPC / GraphQL
讲面试常问的 REST 问题

向AI问一下细节