Hi devs,

We need to decide if we want to keep the current:
ResourceName, DocumentName, SpaceName, WikiName, AttachmentName

or instead use a variation.

There are 2 things to decide:
- The prefix for the base object (Resource, Item, Model, etc)
- The suffix (Name, Path, Reference, etc)

Proposal
=======

I'd like to propose ModelReference for the base object and then  
DocumentReference, SpaceReference, WikiReference, AttachmentReference.
Note: This is different from Identity which is unique (a UUID).  
References do not point to unique objects.

Reference makes sense to me since it means what it means... :)
For example the API: Document getDocument(DocumentReference) is pretty  
clear IMO.

Path is too physical to me. In JCR it's called getPath() but it  
returns a string with a path, for ex "/wiki/space1/space2/document".  
This is not our case. IMO our Reference would transform into a path  
when serialized only.

Name isn't too bad, it would be my second choice. But it doesn't show  
the fact that it's a ... reference... ;)

WDYT?

Thanks
-Vincent


_______________________________________________
devs mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs

Reply via email to