rest - REST 帖子格式

Question

当您使用 REST 通过 POST 创建新条目时，我看到一些 API（例如Google）指定您将 XML 作为请求的一部分发送，而另一些 API 则指定您发送键/值对。REST POST-s 是否有标准或最佳实践？

Answer 1

任何可行的表示格式都可以，但规定您应该非常努力地使用标准格式，例如存在的 Atom。

更新这是来自 Roy Fielding（HTTP 标准的合著者，以及在他的博士论文中阐述 REST 的人）的相关引用。如何设计 Web 服务中使用的表示非常重要：

REST API 应该花费几乎所有的描述性工作来定义用于表示资源的媒体类型 [...]

请务必阅读后续问答。

Answer 2

这取决于 REST 服务实现者。

如果 REST 服务是对现有 html HTML 表单的改编，则发布键值对通常更容易开始。

从 JavaScript 发布信息时，使用 JSON 通常更容易。

经常使用 XML 是因为它易于人类理解，并且每种语言/平台都有大量工具可以处理它。

Answer 3

我建议使用最简单的，因为这就是 REST 的全部意义所在。下面的代码片段是我发帖的方式。我知道您不是专门寻找代码，但下面的 API (httpClient) 效果很好。然后，您可以使用我们编码人员一直使用的工具对其进行解码（request.getParameter()）。我相信这就是 REST 与 SOAP 的不同之处。不要让它变得困难！使用 HTTP！

    public void testHttpClient() {
    PostMethod pMethod = null;
    pMethod = new PostMethod("...url...");
    NameValuePair[] data = {new NameValuePair("activeFlag", "yes"), new NameValuePair("custCode", "B010"), new NameValuePair("comments", "mark is cool")};
    pMethod.setRequestBody(data);
    this.makeCall(pMethod);
}
private String makeCall(HttpMethod method) {
    String response = null;
    HttpClient client = new HttpClient();
    client.getParams().setAuthenticationPreemptive(true);
    client.getState().setCredentials(AuthScope.ANY, new UsernamePasswordCredentials(this.logon, this.pass));
    method.getParams().setParameter(HttpMethodParams.RETRY_HANDLER, new DefaultHttpMethodRetryHandler(3, false));
    method.getParams().setIntParameter(HttpMethodParams.SO_TIMEOUT, 5000);
    try {
        int statusCode = client.executeMethod(method);
        if (statusCode != HttpStatus.SC_OK) {
            System.err.println("Method failed: " + method.getStatusLine());
        }
        String aLine = null;
        StringBuffer sb = new StringBuffer();
        BufferedReader in = new BufferedReader(new InputStreamReader(method.getResponseBodyAsStream()));
        while ((aLine = in.readLine()) != null) {
            sb.append(aLine.trim());
            System.out.println(aLine);
        }
        in.close();
        response = sb.toString();
    } catch (HttpException e) {
        System.err.println("Fatal protocol violation: " + e.getMessage());
        e.printStackTrace();
    } catch (IOException e) {
        System.err.println("Fatal transport error: " + e.getMessage());
        e.printStackTrace();
    } finally {
        method.releaseConnection();
    }
    return response;
}

Answer 4

SOAP是 WebServices 的标准（我认为您对 WebServices 和 REST 有点困惑）。

但这真的取决于实施者。