14 Sep
2012
14 Sep
'12
9:35 a.m.
On Fri, Sep 14, 2012 at 9:29 AM, Vincent Massol <vincent(a)massol.net> wrote:
Hi devs,
As you may have seen, I've been working on the new model in a branch.
We need to decide on the naming of the Entity classes (wiki, space, document, object,
object definition, etc).
We have several possibilities I know of for naming them:
1) Wiki, Space, Document, Object, ObjectDefinition
-1, Object is a pain to work with and Document has many possible
collisions too even if no java.lang in this case
2) WikiEntity, SpaceEntity, DocumentEntity,
ObjectDefinitionEntity
+1
3) Wiki, Space, Document, XObject, XObjectDefinition
(or simply ObjectDefinition)
-1, It's inconsistent
4) XWiki, XSpace, XDocument, XObject,
XObjectDefinition
-1, "XWiki" as class name to indicate one wiki is very confusing
5) Some other name for objects.
Some concerns:
* Using Object as in 1) is a bit of a pain since there's java.lang.Object which
forces to use the FQN name when coding in Java. Which is why I've put proposals 2) and
3)
* In proposal 3) there's a bit of an inconsistency with the X in XObject which is not
present in the other entity names, hence proposal 4 and 2)
* In proposal 1) there can be some other clashes. For example Document can clash with the
DOM Document object
My personal vote goes to 2), even though it makes the entity names a bit longer.
Cast your votes!
Thanks
-Vincent
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
--
Thomas Mortagne