Uploaded image for project: 'OASIS Open Data Protocol (OData) TC'
  1. OASIS Open Data Protocol (OData) TC
  2. ODATA-1321

Prefer:respond-async on individual requests within a batch request

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: V4.01_CS01
    • Fix Version/s: V4.01_CS02
    • Component/s: JSON Format, Protocol
    • Labels:
      None
    • Environment:

      Applied

    • Proposal:
      Hide

      In Protocol: preference respond-async, remove references to use for single requests within a batch; clarify that use on a batch applies to the entire batch:
      "The respond-async preference MAY be used for batch requests, in which case it applies to the batch request as a whole and not to individual requests within the batch."

      In description of multipart batch, prohibit use of respond-async for individual requests within a batch

      In JSON Format, allow use of respond-async for individual requests as long as they are not within an atomicity group. If a request depends on a request that is executed asynchronously, then it SHOULD fail with 424 failed dependency.

      Show
      In Protocol: preference respond-async, remove references to use for single requests within a batch; clarify that use on a batch applies to the entire batch: "The respond-async preference MAY be used for batch requests, in which case it applies to the batch request as a whole and not to individual requests within the batch." In description of multipart batch, prohibit use of respond-async for individual requests within a batch In JSON Format, allow use of respond-async for individual requests as long as they are not within an atomicity group. If a request depends on a request that is executed asynchronously, then it SHOULD fail with 424 failed dependency.
    • Resolution:
      Show
      https://www.oasis-open.org/committees/download.php/65911/odata-v4.01-wd07-part1-protocol-2019-09-18.docx https://www.oasis-open.org/committees/download.php/65912/odata-json-format-v4.01-wd07-2019-09-18.docx  

      Description

      Part 1: Protocol states in 8.2.8.8 Preference respond-async that

      The respond-async preference MAY be used for batch requests, but the service MUST ignore the respond-async preference for individual requests within a batch request.

      However, JSON Format states in 19.6 Asynchronous Batch Requests that

      In addition to the above interaction pattern individual requests within a batch MAY be executed asynchronously if they specify the respond-async preference and if the service responds with a JSON batch response.

      Apparently the restriction in Part 1: Protocol only applies to multi-part batch requests or responses.

        Attachments

          Activity

            People

            • Assignee:
              handl Ralf Handl
              Reporter:
              handl Ralf Handl
            • Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: