Java Servlet 读取 JSON 参数乱码

在使用 Java Servlet 开发 Web 应用程序时，我们经常需要处理传递过来的参数。当参数是 JSON 格式时，有时候会遇到乱码的问题。本文将介绍如何在 Java Servlet 中正确地读取 JSON 参数，并解决乱码问题。

什么是 Java Servlet

Java Servlet 是 Java EE（Enterprise Edition）中的一个规范，用于开发基于 Web 的应用程序。它允许我们处理 HTTP 请求和响应，并提供动态内容的生成。Servlet 可以接收请求的参数，并根据这些参数生成相应的响应。

读取 JSON 参数

以下是一个简单的 Servlet 类，用于读取 JSON 参数：

@WebServlet(name = "MyServlet", urlPatterns = {"/my-servlet"})
public class MyServlet extends HttpServlet {

    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 设置请求的字符编码为 UTF-8
        request.setCharacterEncoding("UTF-8");

        // 读取请求的 JSON 参数
        BufferedReader reader = request.getReader();
        StringBuilder jsonBuilder = new StringBuilder();
        String line;
        while ((line = reader.readLine()) != null) {
            jsonBuilder.append(line);
        }
        reader.close();

        // 解析 JSON 参数
        JSONObject json = new JSONObject(jsonBuilder.toString());
        String name = json.getString("name");
        int age = json.getInt("age");

        // 打印参数
        System.out.println("Name: " + name);
        System.out.println("Age: " + age);
    }
}

在上述代码中，doPost 方法用于处理 POST 请求。首先，我们通过 setCharacterEncoding 方法设置请求的字符编码为 UTF-8，这样可以避免乱码问题。

然后，我们使用 getReader 方法获取请求的 BufferedReader 对象，并逐行读取请求的数据。将读取到的数据追加到 jsonBuilder 中。

最后，我们使用 JSONObject 类解析 jsonBuilder 中的 JSON 数据，并获取对应的参数。

解决乱码问题

在有些情况下，即使我们设置了请求的字符编码为 UTF-8，读取到的 JSON 参数仍然是乱码。这是因为 request.getReader() 方法返回的 Reader 对象默认是按 ISO-8859-1 编码读取数据的。

为了解决乱码问题，我们可以使用 InputStream 对象替代 Reader 对象，并手动指定编码为 UTF-8。修改上述代码如下：

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    // 设置请求的字符编码为 UTF-8
    request.setCharacterEncoding("UTF-8");

    // 读取请求的 JSON 参数
    InputStream inputStream = request.getInputStream();
    BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream, "UTF-8"));
    StringBuilder jsonBuilder = new StringBuilder();
    String line;
    while ((line = reader.readLine()) != null) {
        jsonBuilder.append(line);
    }
    reader.close();

    // 解析 JSON 参数
    JSONObject json = new JSONObject(jsonBuilder.toString());
    String name = json.getString("name");
    int age = json.getInt("age");

    // 打印参数
    System.out.println("Name: " + name);
    System.out.println("Age: " + age);
}

通过使用 InputStream 对象和指定编码为 UTF-8，我们可以确保正确地读取到 JSON 参数，并解决乱码问题。

类图

下面是本文介绍的 Servlet 类的类图：

classDiagram
    class MyServlet {
        +doPost(HttpServletRequest, HttpServletResponse) : void
    }

状态图

下面是 Servlet 类的状态图，表示它的 doPost 方法的状态转换：

stateDiagram
    [*] --> Ready
    Ready --> ReadingData
    ReadingData --> ParsingData
    ParsingData --> PrintingParameters
    PrintingParameters --> [*]

以上是关于 Java Servlet 读取 JSON 参数乱码的科普文章。通过上述示例代码和解决乱码问题的方法，我们可以在 Servlet 中正确地读取 JSON 参数，并避免乱码问题的出现。希望本文对你有所帮助！