jsp如何访问本地json数据

JSP轻松读取本地JSON数据：实用指南与代码示例

在Web开发中,JSP（JavaServer Pages）作为一种动态网页技术，经常需要与数据进行交互，JSON（JavaScript Object Notation）因其轻量级、易解析的特性，成为了前后端数据交换的常用格式，本文将详细介绍如何在JSP页面中访问和读取存储在本地服务器上的JSON数据文件。

准备工作：本地JSON文件

我们需要一个本地JSON数据文件,假设我们在JSP项目的Web内容（WebContent或webapp）目录下创建一个名为data的文件夹，并在其中放置一个users.json文件。

文件路径： WebContent/data/users.json

users.json 内容示例：

[
  {
    "id": 1,
    "name": "张三",
    "email": "zhangsan@example.com",
    "age": 28
  },
  {
    "id": 2,
    "name": "李四",
    "email": "lisi@example.com",
    "age": 32
  },
  {
    "id": 3,
    "name": "王五",
    "email": "wangwu@example.com",
    "age": 25
  }
]

JSP访问本地JSON数据的常用方法

在JSP中,我们通常使用Java代码（脚本片段、JSP动作标签或EL表达式结合JavaBean）来读取文件内容，以下是几种常用的方法：

使用Java脚本片段（Scriptlet） - 不推荐但基础

这是最直接的方式,但在JSP中过多使用Java脚本片段不符合MVC设计模式，不利于代码维护，对于理解基本原理有帮助。

示例代码：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="java.io.*, java.net.*" %>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">JSP读取本地JSON数据 - 方法一</title>
</head>
<body>
    <h2>用户列表 (来自JSON文件)</h2>
    <ul>
    <%
        String jsonFilePath = application.getRealPath("/data/users.json");
        StringBuilder jsonContent = new StringBuilder();
        try (BufferedReader reader = new BufferedReader(new FileReader(jsonFilePath))) {
            String line;
            while ((line = reader.readLine()) != null) {
                jsonContent.append(line);
            }
            // 这里jsonContent.toString() 就是JSON字符串
            // 实际项目中，通常会使用如Gson、Jackson等库将JSON字符串转换为Java对象列表
            // 然后遍历Java对象列表显示数据
            // 为简化示例，这里直接输出JSON字符串（实际开发中不建议直接在前端显示原始JSON）
            out.println("<li>原始JSON数据: " + jsonContent.toString() + "</li>");
            // 如果要模拟解析并显示（假设我们手动解析第一个用户）
            // 注意：这仅作演示，实际解析应使用专业库
            if (jsonContent.toString().startsWith("[")) {
                String firstUser = jsonContent.toString().substring(jsonContent.toString().indexOf("{"), jsonContent.toString().indexOf("}") + 1);
                out.println("<li>模拟解析第一个用户: " + firstUser + "</li>");
            }
        } catch (FileNotFoundException e) {
            e.printStackTrace();
            out.println("<li>错误: JSON文件未找到 - " + e.getMessage() + "</li>");
        } catch (IOException e) {
            e.printStackTrace();
            out.println("<li>错误: 读取JSON文件时发生IO异常 - " + e.getMessage() + "</li>");
        }
    %>
    </ul>
</body>
</html>

说明：

application.getRealPath("/data/users.json")：获取Web应用根目录下data/users.json文件的绝对路径。
使用BufferedReader逐行读取文件内容到StringBuilder中。
这种方法直接输出原始JSON,不利于前端直接使用，通常我们会将JSON字符串传递给前端JavaScript，或使用Java库将其转换为对象。

使用JavaBean + JSTL + EL表达式（推荐）

这是更符合MVC模式的做法,将数据处理逻辑与视图展示分离。

步骤：

创建JavaBean（POJO）：根据JSON对象的结构创建对应的Java类。

// User.java
package com.example.model;
public class User {
    private int id;
    private String name;
    private String email;
    private int age;
    // 无参构造器
    public User() {}
    // getter和setter方法
    public int getId() { return id; }
    public void setId(int id) { this.id = id; }
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }
    @Override
    public String toString() {
        return "User{" +
               "id=" + id +
               ", name='" + name + '\'' +
               ", email='" + email + '\'' +
               ", age=" + age +
               '}';
    }
}

创建工具类读取并解析JSON：这里我们使用流行的Gson库来解析JSON字符串为Java对象列表。

首先确保你的项目中包含了Gson库（通过Maven或Gradle添加依赖，或手动添加JAR包）。

创建一个JSON读取工具类。

// JsonReaderUtil.java
package com.example.util;

import com.example.model.User; import com.google.gson.Gson; import com.google.gson.reflect.TypeToken; import java.io.BufferedReader; import java.io.FileReader; import java.io.IOException; import java.lang.reflect.Type; import java.util.List;

public class JsonReaderUtil {

public static List<User> readUsersFromJson(String filePath) throws IOException {
    StringBuilder jsonContent = new StringBuilder();
    try (BufferedReader reader = new BufferedReader(new FileReader(filePath))) {
        String line;
        while ((line = reader.readLine()) != null) {
            jsonContent.append(line);
        }
    }
    Gson gson = new Gson();
    Type userListType = new TypeToken<List<User>>(){}.getType();
    return gson.fromJson(jsonContent.toString(), userListType);
}

在JSP中使用：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%-- 引入JSTL核心标签库 --%>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<%-- 假设我们的工具类和模型类在com.example包下 --%>
<jsp:useBean id="jsonReader" class="com.example.util.JsonReaderUtil" scope="page"/>
<jsp:useBean id="userList" class="java.util.ArrayList" scope="request"/>
<%
    String jsonFilePath = application.getRealPath("/data/users.json");
    try {
        List<User> users = JsonReaderUtil.readUsersFromJson(jsonFilePath);
        request.setAttribute("userList", users);
    } catch (IOException e) {
        e.printStackTrace();
        request.setAttribute("errorMessage", "读取或解析JSON文件失败: " + e.getMessage());
    }
%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">JSP读取本地JSON数据 - 方法二 (推荐)</title>
</head>
<body>
    <h2>用户列表 (来自JSON文件 - JavaBean + JSTL)</h2>
    <c:if test="${not empty errorMessage}">
        <p style="color: red;">${errorMessage}</p>
    </c:if>
    <c:if test="${not empty userList}">
        <ul>
            <c:forEach var="user" items="${userList}">
                <li>
                    ID: ${user.id} | 
                    姓名: ${user.name} | 
                    邮箱: ${user.email} | 
                    年龄: ${user.age}
                </li>
            </c:forEach>
        </ul>
    </c:if>
    <c:if test="${empty userList && empty errorMessage}">
        <p>没有找到用户数据。</p>
    </c:if>
</body>
</html>

说明：

<jsp:useBean>：用于在JSP中创建或使用已有的JavaBean实例。
<jsp:useBean id="userList" class="java.util.ArrayList" scope="request"/>：创建一个ArrayList对象，并存储在request范围内。
在脚本片段中,调用工具类方法读取JSON并解析为List<User>，然后通过request.setAttribute()将列表存入request作用域。
使用