Spring MVC 可以有 HTTP PUT 方法的请求参数吗？还是必须使用 post？我应该使用哪个来实现 RESTful？

Question

我有一个控制器操作，我认为应该是 HTTP PUT，但是当我尝试在控制器操作中使用 @RequestParam 时，Spring 会抱怨。 HTTP PUT 方法是否不允许请求参数，这就是 Spring 拒绝它的原因吗？

@RequestMapping(value = "/{helpDocumentId}/vote", method = RequestMethod.PUT)
public void voteHelpfulness(@PathVariable long helpDocumentId, @RequestParam boolean isHelpful) {
    helpManager.voteOnHelpDocument(helpDocumentId, isHelpful);
}

执行时，它会抛出此错误：

org.springframework.web.bind.MissingServletRequestParameterException: Required boolean parameter 'isHelpful' is not present

当然，存在 isHelpful 参数。我可以使上面的代码完美地适用于 HTTP POST，所以我知道这不是问题。

     $.ajax({
            url: "/help/" + helpDocumentId + "/vote.json",
            type: "PUT",
            data: {
                isHelpful: isHelpful
            },
            success: function(response) {
                // ....
            }
     });

PUT 是正确的 http 方法吗？此操作会修改 helpDocument，但不会创建帮助文档。

Answer 1

自Spring 3.1以来，HttpPutFormContentFilter 可以用来处理application/x-www-form-urlencoded 数据：

在 HTTP PUT 请求期间通过 ServletRequest.getParameter*() 系列方法提供表单编码数据的过滤器。

Servlet 规范要求表单数据可用于 HTTP POST，但不可用于 HTTP PUT 请求。此过滤器拦截内容类型为 'application/x-www-form-urlencoded' 的 HTTP PUT 请求，从请求正文中读取表单编码内容，并包装 ServletRequest 以制作表单数据可用作请求参数，就像 HTTP POST 请求一样。

对于其他传入数据（例如 JSON），您需要 @RequestBody，如 JQuery、Spring MVC @RequestBody 和 JSON - 使其协同工作，以免遇到415 不支持的媒体类型。

Answer 2

Spring 控制器支持 GET/HEAD/POST/PUT/DELETE/OPTIONS/TRACE，但由于您的浏览器可能无法发送这些请求方法，因此它对您不起作用。

解决方法是使用Spring提供的“org.springframework.web.filter.HiddenHttpMethodFilter”。它要求您为请求方法传递一个隐藏参数。该过滤器支持的默认参数是“_method”。

检查过滤器的 javadoc 以获取更多信息。

Answer 3

正如上面所建议的，这似乎是 spring/servlet API 中的一个错误。实际上，PUT 请求应该在请求正文（或有效负载） 上工作，而不是在请求参数上工作。从这个意义上说，servlet API 和 Servlet API 是一个很好的选择。 spring的处理是正确的。

话虽如此，更好、更简单的解决方法是不从 javascript/jQuery 调用中传递任何数据元素，并将参数作为 url 本身的一部分传递。也就是说，按照 GET 调用的方式在 url 字段中设置参数。

$.ajax({
            url: "/help/" + helpDocumentId + "/vote.json" + "?param1=param2Val&..",
            type: "PUT",
            data: "",
            success: function(response) {
                // ....
            }
     });

现在，这适用于简单参数，我猜，不适用于复杂的 JSON 类型。希望这有帮助。

Answer 4

我按照评论中的建议将 @RequestParam 更改为 @RequestBody 并且它成功了（我的参数是一个字符串）。

我同意这是 Spring 中的一个错误，因为在我的生产环境中失败的完全相同的代码（使用 @RequestParam 时）在 localhost 中运行良好。