登录
首页 >  文章 >  java教程

Struts2与AJAX集成：JSON错误解决方法

时间：2025-09-05 08:39:43 244浏览 收藏

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《Struts 2与AJAX集成：JSON解析错误解决方法》，聊聊，希望可以帮助到正在努力赚钱的你。

Struts 2与AJAX集成：解决JSON响应解析错误的最佳实践

本教程旨在解决Struts 2与AJAX集成时，JSON响应导致前端解析错误的问题。核心在于理解Struts 2 JSON插件的工作机制，即通过序列化Action的公共属性来生成JSON数据，而非手动写入响应流。文章将详细阐述正确的Action类设计、Struts配置及AJAX调用方式，确保JSON数据能够被前端正确解析。

理解Struts 2 JSON插件的工作原理

在Struts 2框架中，当我们需要向前端返回JSON格式的数据时，通常会利用其强大的JSON插件。该插件通过配置，能够自动将Action类中的公共属性（带有公共getter方法）序列化为JSON字符串并发送给客户端。然而，许多开发者在初次尝试时，可能会遇到AJAX请求成功但响应被error回调函数捕获，并报告“parse error”的问题。这通常是由于对JSON插件的工作机制理解不足导致的。

原始代码中，Action类PropertyTesting.java试图通过ServletActionContext.getResponse().getWriter().write(obj.toJSONString());手动将JSON字符串写入响应流，同时struts.xml中又配置了。这种做法产生了冲突：

  1. 手动写入： getWriter().write()会立即将JSON字符串发送到客户端。
  2. JSON插件序列化： 当Action执行完毕并返回SUCCESS后，Struts 2的JSON插件会再次尝试序列化PropertyTesting这个Action实例的属性，并将其作为响应发送。

由于响应流可能已经被手动写入并关闭，或者JSON插件尝试序列化一个没有暴露JSON数据的Action实例，这会导致客户端接收到的响应要么是空字符串，要么是格式不正确的JSON，从而引发AJAX的“parse error”。

正确的Action类设计与数据暴露

为了让Struts 2 JSON插件正确地工作，我们应该遵循其设计原则：将需要序列化为JSON的数据作为Action类的公共属性暴露出来，并通过公共的getter方法提供访问。JSON插件会自动检测这些属性并将其转换为JSON。

以下是修正后的PropertyTesting.java代码示例：

import java.util.HashMap;
import java.util.Map;
import com.opensymphony.xwork2.ActionSupport;

public class PropertyTesting extends ActionSupport 
{
    // 定义一个Map类型的属性，用于存放需要序列化的JSON数据
    // 注意：这个属性必须有公共的getter方法
    private Map<String, String> jsonData; // 属性名可以自定义，但getter方法名需要对应

    // 公共的getter方法，JSON插件会通过它获取数据并序列化
    public Map<String, String> getJsonData() { // getter方法名应为 get + 属性名（首字母大写）
       return jsonData;
    }

    public String execute() 
    {
        // 在execute方法中初始化并填充数据到jsonData属性
        jsonData = new HashMap<>();
        jsonData.put("Name", "PersonName");
        jsonData.put("ID", "PersonID");

        // 返回SUCCESS，让Struts 2 JSON插件接管响应处理
        return SUCCESS;
    }
}

关键点说明：

  1. 移除手动写入： execute()方法中不再需要ServletActionContext.getResponse().getWriter().write()。
  2. 定义属性： 创建一个私有属性（例如jsonData），类型可以是Map、List、自定义Java Bean等，只要能被JSON库序列化即可。
  3. 提供Getter： 为该属性提供一个公共的getter方法（例如getJsonData()）。Struts 2 JSON插件会查找这些getter方法来获取要序列化的数据。
  4. 填充数据： 在execute()方法中，将需要返回的数据填充到这个属性中。
  5. 返回SUCCESS： 确保execute()方法返回SUCCESS，以便Struts 2能够根据struts.xml的配置调用JSON结果类型处理器。

Struts.xml 配置

struts.xml的配置在原问题中已经基本正确，它指定了使用json-default包和type="json"的结果类型。这正是启用JSON插件的关键。

<struts>
   <constant name="struts.devMode" value="true"/>
   <package name="WebTesting" extends="json-default">
        <action name="PropertyTesting" class="org.testing.PropertyTesting" >
            <result type="json"></result>
            <!-- 
                 可选配置：如果想自定义JSON根对象的名称，可以使用param name="root"
                 例如：<result type="json"><param name="root">jsonData</param></result>
                 这里jsonData是Action类中getter方法的名称（getJsonData()对应的属性名）。
                 如果省略，插件会尝试序列化整个Action对象，或者根据默认规则选择。
                 在本例中，getJsonData()是唯一的getter，所以默认会序列化它。
            -->
        </action>
   </package>
</struts>

配置要点：

  • extends="json-default"： 确保你的包继承了json-default包，这样才能使用type="json"结果类型。
  • ： 这行配置告诉Struts 2，当Action返回SUCCESS时，使用JSON插件来处理响应。

JSP页面与AJAX调用

JSP页面中的AJAX调用方式在原问题中也是正确的，它指定了dataType:"json"，这会告诉jQuery期望接收JSON格式的响应，并尝试自动解析。

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
    <%@ taglib uri="/struts-tags" prefix="s"%>

<html>
<head>
<meta charset="UTF-8">
<title>Property Testing</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
<script type="text/javascript">
function invokeAjax()
{
    $.ajax(
    {
        type:"POST",
        url:"PropertyTesting",
        dataType:"json", // 明确告诉jQuery期望JSON响应
        success: function(responseText)
        {
            // 当Struts 2正确返回JSON时，responseText将是一个JavaScript对象
            console.log("成功响应:", responseText);  
            console.log("姓名:", responseText.Name); // 访问JSON对象的属性
            console.log("ID:", responseText.ID);
        },
        error: function(jqXHR, textStatus, errorThrown)
        {
            // 错误处理函数，用于调试
            console.log("AJAX请求失败!");
            console.log("状态码:", jqXHR.status);
            console.log("错误状态:", textStatus);
            console.log("错误信息:", errorThrown);
            console.log("响应文本:", jqXHR.responseText); // 查看原始响应文本有助于调试
        }
    });
}

</script>
</head>
<body>
    <button type="button" onclick="invokeAjax()" >Submit</button>
</body>
</html>

AJAX调用要点：

  • dataType:"json"： 这是至关重要的，它指示jQuery自动解析收到的响应为JSON对象。
  • success回调： 当响应被成功解析为JSON后，responseText参数将直接是一个JavaScript对象，你可以像访问普通对象一样访问其属性（例如responseText.Name）。
  • error回调： 在调试阶段，error回调函数非常有用。通过打印jqXHR.responseText，你可以看到服务器返回的原始文本，这有助于判断是服务器端返回了非JSON内容，还是JSON格式有误。

总结与注意事项

通过以上修正，Struts 2与AJAX集成时返回JSON的流程将变得清晰和可靠：

  1. 利用Struts 2 JSON插件： 避免在Action中手动写入响应流。
  2. 暴露Action属性： 将需要返回的数据封装在Action的私有属性中，并提供公共的getter方法。
  3. 正确配置struts.xml： 确保包继承json-default，并且Action结果类型为json。
  4. AJAX指定dataType:"json"： 让前端库自动处理JSON解析。

这种方法不仅符合Struts 2的设计哲学，也使得代码更加简洁、易于维护。记住，Struts 2 Action并非单例，因此在Action中创建和填充属性是安全且推荐的做法。

终于介绍完啦！小伙伴们，这篇关于《Struts2与AJAX集成：JSON错误解决方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！

相关阅读
更多>
最新阅读
更多>
课程推荐
更多>