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

Clarify that the standard resources $id, $entity, $batch etc. win over content-id referencing

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Closed
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: V4.0_CSD03
    • Fix Version/s: V4.0_CS02
    • Component/s: Protocol
    • Labels:
      None
    • Environment:

      [Applied]

      Description

      Content-id referencing uses the magic character $ followed by a token to refer back to a request that specifies that token in its content-id header.

      Using one of the standard resource names without a $ prefix as a content-id could lead to confusion as URLs relative to the batch request URL are also relative to the service root and the relative URL for the standard resources thus starts with a $:

      --batch_36522ad7-fc75-4b56-8c71-56071383e77b
      Content-Type: application/http
      Content-Transfer-Encoding:binary
      Content-ID: batch

      POST Customers HTTP/1.1

      <new customer body>

      --batch_36522ad7-fc75-4b56-8c71-56071383e77b
      Content-Type: application/http
      Content-Transfer-Encoding:binary
      Content-ID: nested-batch

      POST $batch HTTP/1.1
      Content-Type: multipart/mixed;boundary=nested_batch_77162fcd-b8da-41ac-a9f8-9357efbbd
      Content-Length: ###

      --nested_batch_77162fcd-b8da-41ac-a9f8-9357efbbd

      <content of nested batch

      -nested_batch_77162fcd-b8da-41ac-a9f8-9357efbbd-

      -batch_36522ad7-fc75-4b56-8c71-56071383e77b-

      In this (admittedly weird) example the second POST request URL would not be interpreted as a content-id reference but literally as a request to $batch.

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated:
                Resolved: