java API接口是什么

在 Java 里，**“API 接口”**通常有两层含义，很多人容易混在一起，我分开说明一下：

一、Java 中的“接口（Interface）”—— 编程层面的 API

这是 Java 语言本身的语法概念。

1. 什么是 Java 接口（Interface）

接口是一种规范 / 契约，定义“能做什么”，但不关心“怎么做”。

public interface UserService {
    User getUserById(Long id);
    void saveUser(User user);
}

特点：

• 只包含方法声明（Java 8 以后可以有 default / static 方法）
• 类通过 implements 实现接口
• 实现类必须提供具体逻辑

2. 为什么叫“API 接口”

• API = Application Programming Interface（应用程序编程接口）
• Java 标准库本身就是一堆“接口 + 实现”
  • 例如：List（接口） → ArrayList（实现）
  • JDBC（接口） → MySQL 驱动（实现）

✅ 所以：Java 接口本身就是一种 API

二、Web API 接口（后端接口）—— 系统之间的 API

在开发中常说的“Java API 接口”，往往指 HTTP 接口。

1. 什么是 Web API 接口

前端 / 其他系统通过 HTTP 请求 调用 Java 后端提供的功能。

示例（Spring Boot）：

@RestController
@RequestMapping("/api/user")
public class UserController {

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

调用方式：

GET http://localhost:8080/api/user/1

返回：

{
  "id": 1,
  "name": "张三"
}

2. 常见 Java Web API 技术

• Spring MVC / Spring Boot
• RESTful API
• JSON 作为数据格式
• 常用注解：
  • @RestController
  • @GetMapping
  • @PostMapping

三、两者关系总结

四、一句话总结

Java API 接口 = Java 定义的“调用规范”
可以是代码层面的接口，也可以是 HTTP 提供的服务接口。

如果你是想了解 Spring Boot 怎么写 API 接口，我可以给你一个完整示例。