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

Track Prefer Header in Http

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: Protocol
    • Labels:
      None
    • Environment:

      [Proposed]

    • Proposal:
      Hide

      Rename "return-content" to "return=representation" and "return-no-content" to "return=minimal" in both Prefer and Preference-Applied headers. Use OData-31 to track use of the "respond-async" preference.

      Existing implementations are free to continue to use "return-content" and "return-no-content' as synonyms, but this does not need to be spelled out in the OASIS specification.

      Note that Preference-Applied has been resurrected, and is defined to be the same preference tokens as defined for the Prefer (but without parameters).

      Accepted: https://www.oasis-open.org/apps/org/workgroup/odata/download.php/47355/latest/odata_meeting-14_on-20121101-minutes.html

      Show
      Rename "return-content" to "return=representation" and "return-no-content" to "return=minimal" in both Prefer and Preference-Applied headers. Use OData-31 to track use of the "respond-async" preference. Existing implementations are free to continue to use "return-content" and "return-no-content' as synonyms, but this does not need to be spelled out in the OASIS specification. Note that Preference-Applied has been resurrected, and is defined to be the same preference tokens as defined for the Prefer (but without parameters). Accepted: https://www.oasis-open.org/apps/org/workgroup/odata/download.php/47355/latest/odata_meeting-14_on-20121101-minutes.html
    • Resolution:
      Hide

      https://www.oasis-open.org/apps/org/workgroup/odata/download.php/48216/odata-core-v1.0-wd01-part1-protocol-2013-2-11-MP.docx

      Accepted: https://www.oasis-open.org/committees/download.php/48549/odata-meeting-29_on-20130314-minutes.html#odata-110

      Show
      https://www.oasis-open.org/apps/org/workgroup/odata/download.php/48216/odata-core-v1.0-wd01-part1-protocol-2013-2-11-MP.docx Accepted: https://www.oasis-open.org/committees/download.php/48549/odata-meeting-29_on-20130314-minutes.html#odata-110

      Description

      OData uses the Prefer and PreferenceApplied headers defined in http://tools.ietf.org/html/draft-snell-http-prefer-01. Since introducing the Prefer header to OData, the values for "return-content" and "return-no-content" have changed (draft 12 uses "return-minimal" and "return-representation") and the PreferenceApplied header has been removed.

      The Prefer header is still in draft and may change, revert back to previous values, or expire.

      We should track such changes to Prefer, either by updating the OData specification, or by keeping the OData specification current and, if/when Prefer is final, defining the final values as synonyms.

        Attachments

          Activity

            People

            • Assignee:
              mikep Michael Pizzo
              Reporter:
              mikep Michael Pizzo
            • Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: