[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=59781#comment-59781 ] 

Gilbert Pilz commented on CAMP-192:
-----------------------------------

Uploaded an outline of a proposal here: https://www.oasis-open.org/apps/org/workgroup/camp/download.php/55830/camp-192-refactor-01.docx

This proposal would:

1.) Define a new resource type called "collection".

2.) Replace existing collection-typ resources (e.g. "assemblies", "plans") with instances of this new type.

3.) Refactor all contained collections (e.g. "assembly.components") with a reference to a collection of that type (e.g. "assembly.components_uri").

There are some unresolved issues with regards to parameter definitions (for collections that acts as factories) and collections in which the links are annotated with additional information.

> 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)