如何用Java Servlet构建RESTful API

使用Java Servlet构建RESTful API涉及几个关键步骤。以下是一个基本的指南，帮助你开始：

1. 设置项目环境

首先，确保你有一个Java开发环境，并且已经安装了以下工具：

• JDK（Java Development Kit）
• IDE（如Eclipse, IntelliJ IDEA）
• Maven或Gradle（用于依赖管理和构建）

2. 创建Maven项目

如果你使用Maven，可以在pom.xml文件中添加以下依赖：

<dependencies>
    <!-- Servlet API -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
        <scope>provided</scope>
    </dependency>
    <!-- Jackson for JSON processing -->
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.13.0</version>
    </dependency>
</dependencies>

3. 创建Servlet类

创建一个继承自HttpServlet的类，并重写适当的方法（如doGet, doPost等）。

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import com.fasterxml.jackson.databind.ObjectMapper;

@WebServlet("/api/items")
public class ItemServlet extends HttpServlet {
    private ObjectMapper objectMapper = new ObjectMapper();

    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        // 处理GET请求
        resp.setContentType("application/json");
        resp.setCharacterEncoding("UTF-8");

        // 示例数据
        Item item = new Item("1", "Sample Item", 10.0);

        // 将对象转换为JSON并写入响应
        objectMapper.writeValue(resp.getWriter(), item);
    }

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        // 处理POST请求
        resp.setContentType("application/json");
        resp.setCharacterEncoding("UTF-8");

        // 读取请求体中的JSON数据
        Item item = objectMapper.readValue(req.getInputStream(), Item.class);

        // 处理数据（例如保存到数据库）

        // 返回响应
        objectMapper.writeValue(resp.getWriter(), item);
    }
}

4. 创建数据模型类

创建一个简单的Java类来表示你的数据模型。

public class Item {
    private String id;
    private String name;
    private double price;

    // 构造函数、getter和setter方法
    public Item() {}

    public Item(String id, String name, double price) {
        this.id = id;
        this.name = name;
        this.price = price;
    }

    // Getters and Setters
    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public double getPrice() {
        return price;
    }

    public void setPrice(double price) {
        this.price = price;
    }
}

5. 配置web.xml（可选）

如果你不使用注解，可以在web.xml文件中配置Servlet。

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
    <servlet>
        <servlet-name>ItemServlet</servlet-name>
        <servlet-class>com.example.ItemServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>ItemServlet</servlet-name>
        <url-pattern>/api/items</url-pattern>
    </servlet-mapping>
</web-app>

6. 部署和测试

将你的项目打包成WAR文件，并部署到Tomcat或其他Servlet容器中。然后，你可以使用浏览器或工具（如Postman）来测试你的API。

示例请求和响应

GET请求

GET /api/items HTTP/1.1
Host: localhost:8080

响应

{
    "id": "1",
    "name": "Sample Item",
    "price": 10.0
}

POST请求

POST /api/items HTTP/1.1
Host: localhost:8080
Content-Type: application/json

{
    "id": "2",
    "name": "Another Item",
    "price": 20.0
}

响应

{
    "id": "2",
    "name": "Another Item",
    "price": 20.0
}

通过以上步骤，你可以使用Java Servlet构建一个简单的RESTful API。根据需要，你可以扩展这个基础示例，添加更多的功能和复杂性。