springboot怎么编写接口
时间: 2025-06-27 17:01:22 浏览: 6
Spring Boot 编写接口的过程非常简单直观,它借助了 Spring MVC 的强大功能来快速构建 RESTful 风格的服务。下面是一个基本的步骤指南:
### 步骤一:创建控制器
通过 `@RestController` 注解将一个类标记为控制器,并指定请求映射路径。
```java
@RestController // 告诉Spring这是一个REST风格的Controller
@RequestMapping("/api") // 指定基础路径
public class MyController {
@GetMapping("/hello") // 映射GET请求到/hello路径
public String sayHello() {
return "你好,欢迎来到我的API!";
}
}
```
在这个例子中:
- `/api/hello` 将会返回字符串 “你好,欢迎来到我的API!”
### 步骤二:处理入参与出参
#### 入参处理
可以利用注解如 `@RequestParam`, `@PathVariable`, 和 `@RequestBody` 来获取URL参数、路径变量以及HTTP Body数据等。
示例如下:
```java
@GetMapping("/users/{id}") // URL形如 /api/users/12345
public User getUserById(@PathVariable("id") Long id) {
// 根据ID查询用户并返回...
}
@PostMapping("/login")
public ResponseEntity<String> login(@RequestBody LoginRequest request){
if(authService.authenticate(request.getUsername(),request.getPassword())){
return new ResponseEntity<>("登录成功", HttpStatus.OK);
}else{
return new ResponseEntity<>("用户名或密码错误",HttpStatus.UNAUTHORIZED);
}
}
```
这里展示了如何接收路径变量及JSON格式Body内容作为输入。
#### 出参处理
一般推荐直接返回实体对象而非手动封装Json串,Spring会自动完成序列化操作。比如上述代码段中的User对象会被转换成相应的JSON响应给客户端。
此外还可以配合分页、校验等功能丰富我们的接口设计。
---
以上就是基于Spring Boot框架编写Web API接口的基础介绍了!
阅读全文
相关推荐


















