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

ETag Header: Clarify meaning of "individual resource".

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: V4.01_WD01
    • Fix Version/s: V4.01_WD01
    • Component/s: Protocol
    • Labels:
      None
    • Environment:

      [Proposed]

    • Proposal:
      Hide

      Clarify that etags MAY be on collections. If present on the collection, the service MUST support if-match/if-not-match on get, if-match on post; client MUST specify if-match when posting to the collection (i.e., action) (and can use if-match=* to force operation).

      Show
      Clarify that etags MAY be on collections. If present on the collection, the service MUST support if-match/if-not-match on get, if-match on post; client MUST specify if-match when posting to the collection (i.e., action) (and can use if-match=* to force operation).

      Description

      Chapter 11.5.4.1 "Invoking an Action" reads:
      "...
      To request processing of the action only if the binding parameter value, an entity or collection of entities, is unmodified, the client includes the If-Match header with the latest known ETag value for the entity or collection of entities. The ETag value for a collection as a whole is transported in the ETag header of a collection response.
      ..."

      --> We support ETags for collections via the standart ETag Header.

      Looking at the chapter 8.3.1 "Header ETag" we never mentioned collections; we described the usage of ETags for metadata responses, service document reponses and for requests that returns an "individual resource".
      The formulation "individual resource" is fuzzy and needs to be clarified.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              martinzurmuehl Martin Zurmuehl
            • Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: