REST API 插件 - 使用正文而不是查询字符串作为参数

Question

我以此为参考在 Struts2 上创建仅 REST 配置：

https://cwiki.apache.org/confluence/display/WW/REST+Plugin

我有一个模型，带有几个测试字段的收据：标题、正文。

目前要创建收据，我以这种方式发送请求：

POST /receipt/?body=new_body&title=new_title

它会为我创建一个包含传入的新正文和标题的收据。

这不起作用：

POST /receipt/
{
  "body": "new_body",
  "title": "new title"
}

这里有一些代码：

struts.xml:

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN"
    "http://struts.apache.org/dtds/struts-2.3.dtd">
<struts>

    <bean type="org.apache.struts2.rest.handler.ContentTypeHandler" name="jackson" class="org.apache.struts2.rest.handler.JacksonLibHandler"/>
    <constant name="struts.rest.handlerOverride.json" value="jackson"/>

    <constant name="struts.enable.DynamicMethodInvocation" value="false"/>
    <constant name="struts.devMode" value="true"/>
    <constant name="struts.rest.content.restrictToGET" value="false"/>
    <constant name="struts.rest.defaultExtension" value="json"/>
    <constant name="struts.rest.handlerOverride.EXTENSION" value="json"/>
    <constant name="struts.i18n.encoding" value="UTF-8"/>

    <constant name="struts.action.extension" value="xhtml,,xml,json,action"/>
    <constant name="struts.mapper.class" value="org.apache.struts2.dispatcher.mapper.PrefixBasedActionMapper" />
    <constant name="struts.mapper.prefixMapping" value="/receipt:rest,:struts"/>

    <constant name="struts.convention.action.suffix" value="Controller"/>
    <constant name="struts.convention.action.mapAllMatches" value="true"/>
    <constant name="struts.convention.default.parent.package" value="receipto"/>
    <constant name="struts.convention.package.locators" value="controllers,actions"/>
</struts>

ReceiptController.java:

public class ReceiptController implements ModelDriven<Object> {

    private ReceiptManager receiptManager = new ReceiptManager();
    private String id;
    private Receipt model = new Receipt();
    private Collection list;

    public Object getModel()
    {
        return (list==null ? model : list);
    }

    public HttpHeaders create()
    {
        receiptManager.save(model);
        return new DefaultHttpHeaders("create");
    }


    public HttpHeaders show()
    {
        model = receiptManager.find(id);
        return new DefaultHttpHeaders("show");
    }

    public HttpHeaders update()
    {
        receiptManager.save(model);
        return new DefaultHttpHeaders("update");
    }

    public HttpHeaders destroy()
    {
        model = receiptManager.destroy(id);
        return new DefaultHttpHeaders("destroy");
    }

    public HttpHeaders index()
    {
        list = receiptManager.list();
        return new DefaultHttpHeaders("index").disableCaching();
    }

    public String getId()
    {
        return id;
    }

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

它应该像我想要的那样工作，还是插件就是这样工作的？

Answer 1

我猜邮递员在请求正文中发送 JSON 并设置内容类型application/json。如果将json 拦截器添加到堆栈中，Struts 可以解析请求。

<interceptor-stack name="myStack">
    <interceptor-ref name="json"/>
    <interceptor-ref name="myInterceptor"/>
    <interceptor-ref name="defaultStack"/>
</interceptor-stack>

JSON Plugin中"json"拦截器的描述：

如果使用了拦截器，action会从请求中的JSON内容中填充，这些是拦截器的规则：

• “内容类型”必须是“应用程序/json”
• JSON 内容必须格式正确，语法见json.org。
• 对于必须填充的字段，操作必须具有公共“setter”方法。
• 支持的填充类型包括：基元 (int,long...String)、日期、列表、地图、基元数组、其他类（稍后会详细介绍）和其他类的数组。
• JSON 中要填充到列表或映射中的任何对象都将是 Map 类型（从属性映射到值），任何整数都将是 Long 类型，任何十进制数都将是类型Double 和任何 List 类型的数组。

资源：

• Kickstart FAQ
• Getting Started
• FAQs
• Other Resources