[OASIS Issue Tracker] (CAMP-192) resource model is inconsistent in how it expresses containment of other resources

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

    [ https://issues.oasis-open.org/browse/CAMP-192?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=59949#comment-59949 ] 

Tom Rutt commented on CAMP-192:
-------------------------------

Given this new concept of usage of collection resources for conveying multiple links from one resource to another, I suggest we rename the pointer attributes to collectins in each resource referencing collections.

in most of the cases in the Api the pattern for the attribute name which points at a collection is

<resourceName>s_uri : URI

There are two exceptions which are inconsistent
In components resource
 
related_components URI
 
should be for consistency
 
related_components_uri URI
 
and

In resource type_definition
 

attribute_definitions": URI
 
should be changed for consistency fo

attribute_definitions-uri": URI



Upon further reflection, I propose we rename all these URI pointer attributes to collection resource from the patern:
 
<resourceName>s_uri : URI
 
To the pattern:
<resourceName>_collection : URI



> resource model is inconsistent in how it expresses containment of other resources
> ---------------------------------------------------------------------------------
>
>                 Key: CAMP-192
>                 URL: https://issues.oasis-open.org/browse/CAMP-192
>             Project: OASIS Cloud Application Management for Platforms (CAMP) TC
>          Issue Type: Bug
>          Components: Spec
>    Affects Versions: 1.2
>            Reporter: Gilbert Pilz
>            Assignee: Gilbert Pilz
>            Priority: Minor
>             Fix For: 1.2
>
>
> The 'assembly' resource contains an array of Links (named "components[]") that reference the 'component' resources that make up that assembly. The 'component' resource as an attribute (named "operations_uri") that references an 'operations' resource that contains an array of Links (named "operation_links[]") that reference the 'operation' resources for that component. These two methods of indicating containment ("this assembly contains these components", "this component contains these operations") are inconsistent. 
> This inconsistency makes it harder to right clients for the API.
> This is only one example of such an inconsistency. There may be others that should be processed in the context of this issue.



--
This message was sent by Atlassian JIRA
(v6.2.2#6258)