如何使用java框架构建RESTful API？

java 框架（如 spring boot 和 jax-rs）可用于构建 restful api。使用 spring boot，在类上添加 @restcontroller 注解以创建 rest 控制器，并使用 @requestmapping 映射 http 请求处理方法。使用 jax-rs，使用 @path 注解映射资源路径，并使用 @get、@post 等注解定义 http 动作处理方法。为了演示，本文提供了一个使用 java 框架构建用户 api 的分步实战案例，包括创建模型、服务和 rest 控制器或资源类。

如何使用 Java 框架构建 RESTful API

构建 RESTful API 是现代 Web 应用程序开发中至关重要的方面。Java 提供了强大的框架，例如 Spring Boot 和 JAX-RS，可以简化这一过程。本文将指导你使用这些框架构建一个 RESTful API，并提供一个实用的实战案例。

使用 Spring Boot 创建 REST Controller

立即学习“Java免费学习笔记（深入）”；

Spring Boot 是一个流行的微服务框架，它提供了内置的控制器支持RESTful API。要创建一个 REST 控制器，需要在类上添加 @RestController 注解：

@RestController
public class UserController {
    // ...
}

然后，可以使用 @RequestMapping 来映射 HTTP 请求处理方法，如下所示：

@RequestMapping("/users")
public List<User> getUsers() {
    // ...
}

使用 JAX-RS 创建 JAX-RS 资源

JAX-RS 是 Java EE 中一个用于构建 RESTful API 的标准。与 Spring Boot 类似，可以使用 @Path 注解来映射资源路径：

@Path("/users")
public class UserResource {
    // ...
}

然后，使用 @GET, @POST, @PUT 和 @DELETE 等注解来定义 HTTP 动作处理方法：

@GET
public List<User> getUsers() {
    // ...
}

实战案例：构建一个用户 API

为了演示如何使用这些框架，让我们构建一个基本的 RESTful API，它提供对用户资源的 CRUD（创建、读取、更新、删除）操作。

步骤 1：创建项目

在命令行中使用 Spring Boot CLI 或 Maven 创建一个新的 Java 项目：

DreamStudio

SD兄弟产品！AI 图像生成器

下载

mvn spring-boot:generate -DgroupId=com.example -DartifactId=user-api

步骤 2：配置 Spring Boot 或 JAX-RS

在项目 pom.xml 中，添加 Spring Boot 或 JAX-RS 依赖项：

Spring Boot:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

JAX-RS:

<dependency>
    <groupId>javax.ws.rs</groupId>
    <artifactId>jaxrs-api</artifactId>
</dependency>
<dependency>
    <groupId>org.glassfish.jersey.containers</groupId>
    <artifactId>jersey-container-servlet</artifactId>
</dependency>

步骤 3：创建模型

创建一个 User 模型类来表示用户实体：

public class User {
    private Long id;
    private String name;
    // ...
}

步骤 4：创建服务

创建一个服务类来处理业务逻辑：

public interface UserService {
    List<User> getUsers();
    User getUserById(Long id);
    User createUser(User user);
    User updateUser(Long id, User user);
    void deleteUserById(Long id);
}

步骤 5：实现 REST API

使用 Spring Boot 或 JAX-RS 创建 REST 控制器或资源类来实现 RESTful API 端点：

Spring Boot:

@RestController
@RequestMapping("/users")
public class UserController {
    private final UserService userService;

    @Autowired
    public UserController(UserService userService) {
        this.userService = userService;
    }

    @GetMapping
    public List<User> getUsers() {
        return userService.getUsers();
    }
    // ...
}

JAX-RS:

@Path("/users")
public class UserResource {
    private UserService userService;

    @GET
    public List<User> getUsers() {
        return userService.getUsers();
    }
    // ...
}