Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Since GetObject only returns a handle to the JSON object, it is the responsibility of the calling process to serialize the resource and update the HTTP response (e.g., Body, Content-Type Header, Status Code, etc.). The reason developers might choose to work with the GetObject service instead of the GetDatabaseItem service (aside from the latter being deprecated) is because developers might require a little more control and ability to customize the resource object. For this reason, developers have access to several other useful services such as AddProperty, AddSubProperty, AddSubResource, AddLInkRelationship, AddEmbeddedResources, and AddFormAction.

Pros:

  • Better Custom control over the creation of the resource object.
  • Uses terminology 

Cons:

  • Deprecated (but there are no plans to remove it).
  • HATEOAS support is limited.
  • Cannot Ability to include the Key ID within the resource object.
  • Ability to identify a part of a Key ID as the resource ID.

Cons:

  • Caller must serialize the JSON object.
  • Caller responsible for setting HTTP response elements.