strutsjson怎么用

Struts2中使用Struts2-JSON插件的完整指南

Struts2作为经典的Java Web框架，通过整合Struts2-JSON插件可以轻松实现AJAX异步数据交互，本文将详细介绍Struts2-JSON插件的配置、使用方法及最佳实践,帮助开发者快速这一技术。

环境准备与依赖配置

在使用Struts2-JSON插件前，需要确保项目中包含必要的依赖，在Maven项目的pom.xml中添加以下依赖：

<dependency>
    <groupId>org.apache.struts</groupId>
    <artifactId>struts2-json-plugin</artifactId>
    <version>2.5.33</version>
</dependency>

同时确保项目中已包含Struts2核心依赖：

<dependency>
    <groupId>org.apache.struts</groupId>
    <artifactId>struts2-core</artifactId>
    <version>2.5.33</version>
</dependency>

Struts2配置文件设置

在struts.xml配置文件中，需要启用JSON结果类型并配置相关拦截器,以下是基本配置示例：

<package name="default" extends="json-default">
    <action name="userAction" class="com.example.UserAction">
        <result type="json">
            <!-- 配置JSON序列化选项 -->
            <param name="excludeProperties">password</param>
            <param name="noCache">true</param>
            <param name="enableGZIP">true</param>
        </result>
    </action>
</package>

关键配置说明：

extends="json-default"：继承JSON支持的基础包
result type="json"：指定结果类型为JSON
excludeProperties：排除不需要序列化的属性（如敏感信息）
noCache：禁用浏览器缓存
enableGZIP：启用GZIP压缩提高传输效率

Action类实现

Action类需要遵循以下规范：

实现ModelDriven接口（可选）或直接定义属性
提供getter/setter方法
可以包含业务逻辑方法

示例代码：

package com.example;
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ModelDriven;
public class UserAction extends ActionSupport implements ModelDriven<User> {
    private User user = new User();
    private List<String> hobbies;
    @Override
    public User getModel() {
        return user;
    }
    public String execute() {
        // 业务逻辑处理
        user.setName("张三");
        user.setAge(25);
        hobbies = Arrays.asList("阅读", "编程", "旅行");
        return SUCCESS;
    }
    // getter方法
    public List<String> getHobbies() {
        return hobbies;
    }
}

前端JavaScript调用

在JSP页面中可以使用jQuery发起AJAX请求：

<%@ taglib prefix="s" uri="/struts-tags" %>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>
$(document).ready(function(){
    $.ajax({
        url: "userAction",
        type: "POST",
        dataType: "json",
        success: function(data){
            console.log("用户名: " + data.name);
            console.log("年龄: " + data.age);
            console.log("爱好: " + data.hobbies.join(", "));
        },
        error: function(xhr, status, error){
            console.error("请求失败: " + error);
        }
    });
});
</script>

高级配置选项

自定义JSON序列化

可以通过实现JSONWriter接口自定义序列化行为：

public class CustomJSONWriter implements JSONWriter {
    @Override
    public String write(Object object) {
        // 自定义序列化逻辑
        return customJSONString;
    }
}

在struts.xml中配置：

<constant name="struts.json.writer" value="com.example.CustomJSONWriter"/>

处理日期格式

在Action类中添加注解：

@JSON(format = "yyyy-MM-dd")
private Date birthDate;

处理循环引用

使用@JSON注解避免循环引用：

public class User {
    private String name;
    @JSON(serialize = false)
    private List<Order> orders;
}

常见问题与解决方案

中文乱码问题：
- 确保web.xml中配置了字符编码过滤器
- 在struts.xml中添加：<constant name="struts.i18n.encoding" value="UTF-8"/>
日期格式问题：
- 使用@JSON(format="...")注解自定义格式
- 或在struts.xml中配置：<param name="datePattern">yyyy-MM-dd</param>
集合处理问题：
- 确保集合属性有getter方法
- 可以使用@JSON(name="customName")自定义JSON中键名