[oslc-core] what is the actual intent of resource definition table columns?

Steve K Speicher sspeiche at us.ibm.com
Tue Apr 17 15:32:52 EDT 2012


Thanks for the summary.  I only added a few "guidance" responses to 
capture what the intent is and agree that we should clarify these 
outlining the questions you have below.

> From: John Arwe/Poughkeepsie/IBM at IBMUS
> To: oslc-core at open-services.net, 
> Date: 04/13/2012 11:47 AM
> Subject: [oslc-core] what is the actual intent of resource definition 
table columns?
> Sent by: oslc-core-bounces at open-services.net
> 
> Three independent threads (including a discussion in Automation 
yesterday) 
> converged on the same Core section yesterday.  I feel a bit like Alice 
in 
> Wonderland on days like this, but once more into the looking glass... 
> 
> [1], under the "Defining OSLC Properties" heading, lays out the 
information 
> we see in resource definitions, including the subject columns.  It does 
not 
> explicitly define the semantics for all of them however, which has led 
> people to conflicting interpretations of the spec prose.  More 
importantly 
> from the perspective of some adopters, it does not lay out explicit 
testable
> compliance requirements on client and/or server implementations.  While 
I'm 
> providing specific examples below to show how this causes problems, I 
think 
> we need to keep to the subject question and NOT attempt to answer all 
> individual questions below now (perhaps we revisit those when/if text 
> addressing the asserted need is drafted, as evidence of sufficient 
coverage). 
> 
> Neither Steve Speicher nor I could find anything in Core providing a 
more 
> rigorous treatment after a good faith, but by no means exhaustive, 
search. 
> While not all the interpretations below are equally likely, it is 
"pretty 
> hard" to find anything those interpretations actually violate in Core 
specs,
> and some alternatives are opposing. 
> 
> Example 1: read/only. 
> 
> Interpretation 1a: This is "the client's view", i.e. the server MAY 
change 
> the value but clients MUST NOT. 

This is the intent.

...snip...

> Example 2: occurs one-or-many. 

...snip...

> Interpretation 2d: A server MAY accept/store a representation containing 

> zero of those triples, and MAY produce such a representation itself. 

This is the intent.  With the additional intent that a provider may apply 
additional constraints, we need to make sure to be clear when this is 
allowed and what is allowed. Provider could/may provide a resource shape 
to help explain this to clients.

> Example 3: representation = Either 
> 
> Interpretation 2a: A server MAY be capable of storing a representation 
> (POST-created, PUT, PATCH) containing the in-line resource as an object. 


This is the intent.  See above (2d response).

> 
> [1] http://open-services.net/bin/view/Main/OslcCoreSpecification?
> sortcol=table;up=#OSLC_Defined_Resources 


- Steve





More information about the Oslc-Core mailing list