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

Status response message as carrier for annotations as alternative to 204 No Content

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Closed
    • Priority: Major
    • Resolution: Won't Fix
    • Affects Version/s: V4.0_COS
    • Fix Version/s: V4.01_WD01
    • Component/s: Protocol
    • Labels:
      None
    • Environment:

      [Proposed]

    • Proposal:
      Hide

      Define a "status" response as a carrier for explanations that can be used with status 200 OK in all situtations that currently require 204 No Content.

      Options:
      1. Define a minimal structure similar to the error response to contain a machine-readable code and a human-readable message
      2. Define just a new context URL (e.g. #odata.status or #Edm.Status) without required structure

      Show
      Define a "status" response as a carrier for explanations that can be used with status 200 OK in all situtations that currently require 204 No Content. Options: 1. Define a minimal structure similar to the error response to contain a machine-readable code and a human-readable message 2. Define just a new context URL (e.g. #odata.status or #Edm.Status) without required structure

      Description

      There are some situations where OData 4.0 requires a response with 204 No Content:
      1. GET a raw primitive value using the /$value path suffix and the value is null
      2. GET a nullable property or navigation property and the value is null
      3. DELETE a nullable property or relationship to set it to null
      4. GET a function result that is primitive or structured and is null
      5. POST an action call and the primitive or structured result is null, or the action has no result

      This does not allow to add explanatory annotations to the logically empty result.

        Attachments

          Activity

            People

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

              Dates

              • Created:
                Updated:
                Resolved: