Subject: NEW PREFERENCE - transient

From: Ning Dong <[email-masked]>
Date: Thu, 10 Sep 2015 21:49:06 +0000

Hi,
	Could you please review the request of adding a new prefer name in the prefer header registry?

	The "transient" preference is used in a POST or PUT request to create a new resource. It hints the server that this resource is short lived or doesn't need to be stored permanently.
	This is useful when the resource is a query definition resource, such as:
	POST /employees/searches HTTP/1.1
	Host: example.org
	Content-Type: application/json
	Prefer: transient
	
	{
		"q": "name eq foo",
		"fields": ["name","age","startdate"],
		"orderBy": ["name","age:desc"]
	}

	This above resource defines a query (equivalent to select name, age, startdate from employees where employees.name='foo' order by name, age desc).
	When the client sends Prefer: transient header, it means that this query definition resource is an ad hoc query and most likely won't be reused again.
	So the server doesn't need to persist the resource. Instead, server should execute the query and return the query result.

 o  Preference: transient

  o  Value: no value.

  o  Optional Parameters: n/a

  o  Description: It is used to indicate that a resource is a short lived resource and doesn't need to be persisted.

  o  Reference: Oracle will add a new sub type (type=query-def) in application/vnd.oracle.resource+json media type. This new sub type uses transient prefer header.
     The application/vnd.oracle.resource+json media type is defined at:
     http://www.oracle.com/webfolder/technetwork/tutorials/appdevinfo/New%20REST%20Media%20Type.pdf

  o  Notes: It is related to another request to add "query-result" as a value in the existing "return" prefer header.

	Thanks and appreciate your review.

Ning